Encerramento de subcontas não-BaaS

O Asaas permite que a conta-pai encerre suas subcontas não-BaaS diretamente pela API.

Esse recurso é útil para parceiros que precisam encerrar subcontas criadas incorretamente ou que não serão utilizadas.

Pré-requisitos

Antes de utilizar o endpoint de encerramento, dois pré-requisitos devem ser atendidos pela conta-pai:

  1. Whitelist de IPs configurada: a conta-pai deve ter pelo menos um endereço IP autorizado cadastrado em Integrações. Requisições realizadas a partir de IPs não autorizados serão recusadas.
  2. Gerenciamento de encerramento habilitado: o encerramento de subcontas pela API vem desabilitado por padrão e precisa ser ativado manualmente.

Habilitando o gerenciamento de encerramento

Por envolver uma operação irreversível, o recurso exige ativação explícita e confirmação com token de autenticação.

Para habilitar o gerenciamento de encerramento:

  1. Acesse o menu Integrações.
  2. Acesse a opção Segurança.
  3. Localize o painel Validação de encerramento de subcontas pela API.
  4. Clique em Habilitar encerramento.
  5. Confirme a ação com o token enviado ao dispositivo autorizado.
📘

Importante

O painel Validação de encerramento de subcontas pela API não é exibido para clientes que operam com o BaaS do Asaas. O encerramento de subcontas BaaS é realizado por um processo próprio.

Para desabilitar o recurso a qualquer momento, clique em Desabilitar encerramento no mesmo painel e confirme a ação com o token de autenticação.

Condições para encerrar uma subconta

Para que o encerramento seja aceito, a subconta deve atender a todos os critérios abaixo:

  • o id informado deve pertencer a uma subconta da conta-pai que realiza a requisição;
  • não operar como BaaS;
  • nunca ter realizado login;
  • ter sido criada há menos de 48 horas;
  • não estar encerrada.

Realizando o encerramento

Com o recurso habilitado, a conta-pai pode encerrar a subconta por meio do endpoint Encerrar subconta não-BaaS.

Atenção

O encerramento é irreversível. Após encerrar uma subconta, não será possível reativá-la.

Uma nova subconta poderá ser criada futuramente utilizando os mesmos dados ou informações similares.



Did this page help you?