Detalhamento do Fluxo de Aprovação de Subcontas
O Asaas possui dois fluxos de aprovação de subcontas: não-BaaS e BaaS.
Ambos começam pela criação da subconta:
POST
/v3/accounts
Confira a referência completa deste endpoint
A diferença está na ativação da conta e no envio dos documentos.
| Modelo | Acesso ao Asaas | Envio de documentos |
|---|---|---|
| Não-BaaS | O titular acessa a interface do Asaas. | Realizado pelo titular na interface do Asaas. |
| BaaS | O cliente utiliza a experiência disponibilizada pela sua plataforma. | Realizado pelo onboardingUrl ou pela API, conforme o documento solicitado. |
Período de Avaliação Regulatória
Novas operações de criação de subcontas via API iniciam o período de avaliação regulatória a partir da primeira subconta criada em Produção.
Durante esse período:
- podem ser criadas até 10 subcontas;
- cada subconta pode emitir até R$ 2.000,00 em cobranças;
- o período pode durar até 60 dias corridos a partir da primeira subconta criada.
Importante
- Após atingir qualquer limite (quantidade, valor ou prazo), a criação de novas subcontas e emissão adicional de cobranças, assinaturas, links de pagamento, será automaticamente bloqueada até a finalização do processo de avaliação regulatória (checklists/documentação).
- No novo cenário regulatório, em cada ponto de contato com seu cliente final (telas próprias, comprovantes, onboarding, contratos), é obrigatório evidenciar a marca, os links e os textos de responsabilidade do Asaas. Consulte o Playbook de adequação do Asaas para detalhes, ele será criado e enviado exclusivamente pra você, pelo nosso time de atendimento.
Consulte a FAQ do Período de Avaliação para entender regras, bloqueios e homologação.
Aprovação de subcontas não-BaaS
Após a criação de uma subconta não-BaaS, o titular recebe um e-mail de ativação para definir sua senha e acessar o Asaas.
O envio dos documentos cadastrais ocorre diretamente pela interface do Asaas.
%%{init: {"flowchart": {"nodeSpacing": 28,"rankSpacing": 32,"diagramPadding": 8,"padding": 10}}}%%
flowchart TD
A["Criar a subconta"] --> B["Iniciar validação cadastral"]
B --> C["Enviar e-mail de ativação"]
C --> D["Definir senha e acessar o Asaas"]
D --> E["Enviar documentos"]
E --> F["Analisar documentação"]
F --> G["Conta aprovada"]
classDef inicio fill:#DBEAFE,stroke:#2563EB,color:#1E3A8A,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
class A inicio
class B,C,D,E,F validacao
class G sucesso
linkStyle default stroke:#94A3B8,stroke-width:2px
Normalmente, a análise cadastral inclui documento de identificação e selfie do titular ou responsável.
Para implementar a criação, consulte Criação de subcontas.
Aprovação de subcontas BaaS
No BaaS, sua aplicação conduz a jornada do cliente. O envio dos documentos ocorre pelo onboardingUrl ou pela API, conforme a solicitação retornada pelo Asaas.
Depois de criar a subconta, aguarde pelo menos 15 segundos antes de consultar os documentos pendentes:
GET
/v3/myAccount/documents
Confira a referência completa deste endpoint
A resposta define como cada documento deve ser enviado.
%%{init: {"flowchart": {"nodeSpacing": 28,"rankSpacing": 32,"diagramPadding": 8,"padding": 10}}}%%
flowchart TD
A["Criar a subconta"] --> B["Aguardar no mínimo<br/>15 segundos"]
B --> C["Consultar documentos<br/>pendentes"]
C --> D{"Possui onboardingUrl?"}
D --> DSim(("Sim"))
D --> DNao(("Não"))
DSim --> E["Direcionar o cliente<br/>ao onboardingUrl"]
DNao --> F["Enviar documento<br/>pela API"]
E --> G["Acompanhar a análise"]
F --> G
G --> H["Conta aprovada"]
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,F,G validacao
class D decisao
class H 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
Documento com onboardingUrl
onboardingUrlQuando onboardingUrl estiver presente, direcione o cliente para o link retornado.
O documento deve ser enviado pelo fluxo externo do Asaas.
Documento sem onboardingUrl
onboardingUrlQuando o documento não possuir onboardingUrl e permitir envio pela API, utilize o id retornado:
POST
/v3/myAccount/documents/{id}
Confira a referência completa deste endpoint
Para Pessoa Física e Pessoa Jurídica, normalmente são solicitados documentos de identificação e selfie. Associações podem exigir documentos adicionais, como a Ata de Eleição.
ImportanteO atributo onboardingUrl determina obrigatoriamente o método de envio do documento.
Nunca tente enviar via API um documento que possui onboardingUrl.
→ O envio será rejeitado.
ATENÇÃO:Respeite o timeout mínimo de 15 segundos após a criação da conta antes de verificar documentos pendentes.
Consulte Onboarding e envio de documentos via link para implementar o envio documental completo.
Acompanhe a aprovação por Webhooks
Para acompanhar automaticamente a análise cadastral, configure os Webhooks de situação da conta.
Use os eventos recebidos para atualizar o estado da subconta na sua aplicação. O evento ACCOUNT_STATUS_GENERAL_APPROVAL_APPROVED indica a aprovação geral da conta.
Quando precisar recuperar o estado atual de forma pontual, utilize:
GET
/v3/myAccount/status
Confira a referência completa deste endpoint
A conta está integralmente aprovada quando general retorna APPROVED.
Próximos passos
Updated 18 days ago