Settlement Account Opening Retry
When the BaaS refuses the opening of an issuer's settlement account, the refused request cannot be reused: a new one has to be sent. This endpoint performs that resend.
The most common case is a Bacen Protege+ block: the holder registered the issuer's CNPJ in the service, which prevents accounts from being opened in its name. Once the issuer disables the protection, a new request goes through normally.
The expected flow is:
- Registering the issuer automatically triggers the account opening request.
- If it is refused, the
liquidation_account.account_request_status_changewebhook arrives withstatus: "rejected"and the reason inrejection_reason. - Once the cause is resolved with the issuer, this endpoint sends a new request.
- The result arrives through the same webhook:
approvedif it goes through,rejectedagain if the block is still in place.
Resolving the refusal at registration time avoids the problem showing up later, when creating or issuing the operation.
Settlement Account Opening Retry (PUT)
Request
ENDPOINT
/account_liquidation/issuer/ISSUER-KEY/retry_account_requestMETHOD
PUTPath Params
| Field | Type | Description | Characters |
|---|---|---|---|
ISSUER-KEY | string | Unique key of the issuer (UUID v4). | 36 |
The request body is empty.
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
| Field | Type | Description |
|---|---|---|
request_account_key | string | Unique key of the new opening request. |
account_number | string | Number reserved for the account. |
account_digit | string | Account digit. |
account_branch | string | Account branch. |
issuer_key | string | Unique key of the issuer. |
tenant_key | string | Unique key of the client. |
info
The account does not exist at this point: the response carries the data reserved for it. Follow the result through the webhook or through the settlement account query.
Errors
| HTTP Code | Error Code | Description |
|---|---|---|
| 400 | ACL000065 | The issuer has no refused settlement account opening request to retry: either there is already a request in progress, or none was refused. |