Encerramento de subcontas não-BaaS

A conta-pai pode encerrar pela API uma subconta não-BaaS criada incorretamente ou que não será utilizada.

O encerramento é irreversível e está disponível somente quando a subconta atende aos critérios de elegibilidade deste guia.

Antes de começar

A conta-pai precisa atender a dois requisitos:

• ter a Whitelist de IPs habilitada, com o IP da aplicação autorizado;
• habilitar o gerenciamento de encerramento de subcontas pela interface do Asaas.

Requisições originadas de IPs não autorizados são recusadas.

1. Habilite o encerramento pela API

Na interface do Asaas:

1. acesse Integrações;
2. acesse Segurança;
3. localize 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.

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

2. Verifique se a subconta pode ser encerrada

Antes de realizar a requisição, confirme que a subconta:

• pertence à conta-pai que realizará o encerramento;
• não opera como BaaS;
• nunca realizou login;
• foi criada há menos de 48 horas;
• ainda não está encerrada.

%%{init: {"flowchart": {"nodeSpacing": 28,"rankSpacing": 32,"diagramPadding": 8,"padding": 10}}}%%
flowchart TD
    A["Configurar Whitelist de IPs"] --> B["Habilitar encerramento"]
    B --> C["Verificar critérios da subconta"]
    C --> D{"Atende todos<br/>os critérios?"}

    D --> DSim(("Sim"))
    D --> DNao(("Não"))

    DSim --> E["Encerrar a subconta"]
    E --> F["Confirmar HTTP 200"]

    classDef inicio fill:#DBEAFE,stroke:#2563EB,color:#1E3A8A,stroke-width:3px,font-size:17px
    classDef decisao fill:#FEF3C7,stroke:#D97706,color:#78350F,stroke-width:3px,font-size:17px
    classDef validacao fill:#E0F2FE,stroke:#0284C7,color:#0C4A6E,stroke-width:2px,font-size:17px
    classDef sucesso fill:#DCFCE7,stroke:#16A34A,color:#14532D,stroke-width:3px,font-size:17px

    classDef respostaSim fill:#22C55E,stroke:#15803D,color:#FFFFFF,stroke-width:3px,font-size:16px
    classDef respostaNao fill:#EF4444,stroke:#B91C1C,color:#FFFFFF,stroke-width:3px,font-size:16px

    class A inicio
    class B,C,E validacao
    class D decisao
    class F sucesso

    class DSim respostaSim
    class DNao respostaNao

    linkStyle default stroke:#94A3B8,stroke-width:2px
    linkStyle 3 stroke:#22C55E,stroke-width:4px
    linkStyle 4 stroke:#EF4444,stroke-width:4px

Se algum critério não for atendido, não será possível utilizar esse fluxo de encerramento.

3. Encerre a subconta

Autentique a requisição com a credencial da conta-pai e informe o id da subconta:

DELETE /v3/accounts/{id}

Confira a referência completa do endpoint Encerrar subconta não-BaaS.

Como validar o encerramento

Quando a operação for concluída com sucesso, a API retornará HTTP 200.

Se a requisição for recusada, verifique principalmente se:

• o IP de origem está cadastrado na Whitelist da conta-pai;
• o gerenciamento de encerramento está habilitado;
• o id pertence a uma subconta da conta-pai;
• a subconta é não-BaaS;
• a subconta nunca realizou login;
• a criação ocorreu há menos de 48 horas;
• a subconta ainda não foi encerrada.

Próximos passos

• Configure a Whitelist de IPs
• Crie uma nova subconta
• Entenda o fluxo de aprovação de subcontas