跳到主要内容

清算账户开户重试

当 BaaS 拒绝某个发行人的清算账户开户申请时,被拒绝的申请无法复用:必须提交一笔新的申请。本端点用于完成该重新提交。

最常见的情形是 Bacen Protege+ 限制:持有人在该服务中登记了发行人的 CNPJ,从而禁止以其名义开立账户。发行人关闭该保护之后,新的申请即可正常通过。

预期流程如下:

  1. 登记发行人会自动触发清算账户的开户申请。
  2. 如果申请被拒绝,会收到 liquidation_account.account_request_status_change webhook,status: "rejected",原因在 rejection_reason 中。
  3. 与发行人解决原因之后,通过本端点提交一笔新的申请。
  4. 结果通过同一个 webhook 返回:通过则为 approved,若限制仍然存在则再次为 rejected。

在登记阶段就解决拒绝问题,可以避免该问题在之后创建或发行操作时才暴露出来。


清算账户开户重试(PUT)​

Request​

ENDPOINT
/account_liquidation/issuer/ISSUER-KEY/retry_account_request
方法
PUT

Path Params​

字段类型描述字符数
ISSUER-KEYstring发行人的唯一键值(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_keystring新开户申请的唯一键值。
account_numberstring为该账户预留的账号。
account_digitstring账号校验位。
account_branchstring账户所属分行。
issuer_keystring发行人的唯一键值。
tenant_keystring客户的唯一键值。
信息

此时账户尚不存在:响应中返回的是为其预留的数据。请通过 webhook 或清算账户查询跟踪结果。


Errors​

HTTP 状态码错误码描述
400ACL000065该发行人没有被拒绝的清算账户开户申请可供重试:要么已有一笔申请在处理中,要么从未有申请被拒绝。