Contexto


Neste artigo, explicamos como realizar o encerramento de uma conta por meio da nossa API. O encerramento é permitido somente para contas que estejam com saldo zerado, garantindo a segurança e a integridade do encerramento das operações vinculadas.


Pré-requisitos


Antes de realizar o encerramento de uma conta, certifique-se de que:

  • Está autenticado com um token válido da nossa API;
  • Possui client_id e client_secret ativos;
  • Salvou previamente o accountId da conta que será encerrada;
  • A conta está com saldo zerado;
  • As chaves Pix vinculadas à conta foram previamente excluídas (boa prática recomendada).


1. Encerrar Conta


▶️ Endpoint


DELETE {{url}}/v1/accounts/{{accountId}}


⚠️ Observações Importantes

  • O encerramento não será processado caso a conta possua saldo disponível.
  • Recomendamos, antes de solicitar o encerramento, excluir todas as chaves Pix ativas vinculadas à conta.
  • Esta ação é irreversível e a conta não poderá ser reativada após o encerramento.


2. Códigos de Erro


Código de Erro
HTTP Code
Descrição (PT-BR)
97
500
Saldo Contábil diferente de 0. Impossível desativar!


Suporte


Para dúvidas ou acompanhamento de chamados, acesse: Portal de Suporte