Retentativa de Abertura de Conta de Liquidação

Quando o BaaS recusa a abertura da conta de liquidação de um emissor, a solicitação recusada não pode ser reaproveitada: é preciso enviar uma nova. Este endpoint faz esse reenvio.

O caso mais comum é o bloqueio no Bacen Protege+: o titular cadastrou o CNPJ do emissor no serviço, o que impede a abertura de contas em seu nome. Depois que o emissor desativa a proteção, uma nova solicitação passa normalmente.

O fluxo esperado é:

1. O cadastro do emissor dispara automaticamente a solicitação de abertura da conta.
2. Se ela for recusada, chega o webhook liquidation_account.account_request_status_change com status: "rejected" e o motivo em rejection_reason.
3. Resolvido o motivo com o emissor, este endpoint envia uma solicitação nova.
4. O resultado chega pelo mesmo webhook: approved se passar, rejected de novo se o bloqueio continuar de pé.

Resolver a recusa no cadastro evita que o problema apareça depois, na criação ou na emissão da operação.

---

Retentativa de Abertura de Conta de Liquidação (PUT)

Request

ENDPOINT

/account_liquidation/issuer/ISSUER-KEY/retry_account_request

MÉTODO

PUT

Path Params

Campo	Tipo	Descrição	Caracteres
ISSUER-KEY	string	Chave única do emissor (UUID v4).	36

O corpo da requisição é vazio.

---

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

Campo	Tipo	Descrição
request_account_key	string	Chave única da nova solicitação de abertura.
account_number	string	Número reservado para a conta.
account_digit	string	Dígito da conta.
account_branch	string	Agência da conta.
issuer_key	string	Chave única do emissor.
tenant_key	string	Chave única do cliente.

informação

A conta ainda não existe nesse momento: o retorno traz os dados reservados para ela. Acompanhe o resultado pelo webhook ou pela consulta da conta de liquidação.

---

Erros

Código HTTP	Código do Erro	Descrição
400	ACL000065	O emissor não possui solicitação de abertura de conta recusada para retentar: ou ele já tem uma solicitação ativa, ou nunca teve uma recusada.