清算账户开户重试
当 BaaS 拒绝某个发行人的清算账户开户申请时,被拒绝的申请无法复用:必须提交一笔新的申请。本端点用于完成该重新提交。
最常见的情形是 Bacen Protege+ 限制:持有人在该服务中登记了发行人的 CNPJ,从而禁止以其名义开立账户。发行人关闭该保护之后,新的申请即可正常通过。
预期流程如下:
- 登记发行人会自动触发清算账户的开户申请。
- 如果申请被拒绝,会收到
liquidation_account.account_request_status_changewebhook,status: "rejected",原因在rejection_reason中。 - 与发行人解决原因之后,通过本端点提交一笔新的申请。
- 结果通过同一个 webhook 返回:通过则为
approved,若限制仍然存在则再次为rejected。
在登记阶段就解决拒绝问题,可以避免该问题在之后创建或发行操作时才暴露出来。
清算账户开户重试(PUT)
Request
ENDPOINT
/account_liquidation/issuer/ISSUER-KEY/retry_account_request方法
PUTPath Params
| 字段 | 类型 | 描述 | 字符数 |
|---|---|---|---|
ISSUER-KEY | string | 发行人的唯一键值(UUID v4)。 | 36 |
请求体为空。
Response
STATUS
201{
"request_account_key": "1c0a2e54-77a8-4f0e-8d8e-6f2b9b3c1d22",
"account_number": "1234567",
"account_digit": "8",
"account_branch": "0001",
"issuer_key": "23d933e9-88ba-4291-a6a4-33f025ab361f",
"tenant_key": "5e3045af-8be8-4cbd-9aab-9e15c4e92154"
}
Response Body Params
| 字段 | 类型 | 描述 |
|---|---|---|
request_account_key | string | 新开户申请的唯一键值。 |
account_number | string | 为该账户预留的账号。 |
account_digit | string | 账号校验位。 |
account_branch | string | 账户所属分行。 |
issuer_key | string | 发行人的唯一键值。 |
tenant_key | string | 客户的唯一键值。 |
信息
此时账户尚不存在:响应中返回的是为其预留的数据。请通过 webhook 或清算账户查询跟踪结果。
Errors
| HTTP 状态码 | 错误码 | 描述 |
|---|---|---|
| 400 | ACL000065 | 该发行人没有被拒绝的清算账户开户申请可供重试:要么已有一笔申请在处理中,要么从未有申请被拒绝。 |