银行机构与账户

概述

Statement 银行路径下，银行机构在 DTMS 中表示为 Counterparty(classification=BANK)；银行账户通过 /bank-accounts 创建/更新，并回写 dtmsBankAccountId。账号可加密回填自 DTMS。

触发入口

动作	HTTP
创建银行机构	`POST /api/bank/institutions`
列出机构	`GET /api/bank/institutions`
创建账户（statement）	`POST /api/bank/accounts/statement`
更新账户	`PATCH /api/bank/accounts/:id/statement`
回填加密账号	`POST /api/bank/accounts/backfill-encrypted-numbers`
匹配账户	`POST /api/bank/accounts/match`（纯本地 hash，无 DTMS）

参与方

Client、api-gateway、StatementBankingUseCase
DtmsBankingService、DtmsAuthService、DtmsClient
Redis、DTMS、本地 DB

业务流程图

加载图表…

时序图：创建机构

加载图表…

时序图：创建 / 更新账户

加载图表…

时序图：Backfill

加载图表…

DTMS API 对照

步骤	Liquia	HTTP	Path	Bearer
建银行 CP	`createCounterparty`	POST	`/counterparties`	是
建账户	`createBankAccount`	POST	`/bank-accounts`	是
查账户	`getBankAccount`	GET	`/bank-accounts/{id}`	是
改账户	`updateBankAccount`	PATCH	`/bank-accounts/{id}`	是
搜账户	`searchBankAccounts`	POST	`/bank-accounts/search`	是（未挂接）

本地数据影响

Bank.dtmsCounterpartyId
BankAccount.dtmsBankAccountId + masked / hash / enc

异常与补偿

Bank 未链接 DTMS → 创建账户 400
skip + backfill → DTMS_SYNC_DISABLED
边界：Onboarding 经 banking microservice 建的账户不走本路径

源码索引

apps/api/src/integrations/dtms/dtms-banking.service.ts
apps/api/src/orchestration/banking/statement-banking.use-case.ts
apps/api/src/gateway/controllers/bank.controller.ts