Skip to main content

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:

  1. Registering the issuer automatically triggers the account opening request.
  2. If it is refused, the liquidation_account.account_request_status_change webhook arrives with status: "rejected" and the reason in rejection_reason.
  3. Once the cause is resolved with the issuer, this endpoint sends a new request.
  4. The result arrives through the same webhook: approved if it goes through, rejected again 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_request
METHOD
PUT

Path Params​

FieldTypeDescriptionCharacters
ISSUER-KEYstringUnique 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​

FieldTypeDescription
request_account_keystringUnique key of the new opening request.
account_numberstringNumber reserved for the account.
account_digitstringAccount digit.
account_branchstringAccount branch.
issuer_keystringUnique key of the issuer.
tenant_keystringUnique 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 CodeError CodeDescription
400ACL000065The issuer has no refused settlement account opening request to retry: either there is already a request in progress, or none was refused.