Introdução

Atualmente, o Asaas possui dois tipos de subcontas:

• Subcontas Padrão (não White Label)
• Subcontas White Label

Ambos os tipos de subconta são criados através do mesmo endpoint:

POST /api/v3/accounts
Confira a referência completa deste endpoint

Porém, o processo de ativação e envio de documentos difere entre elas. Este documento descreve o fluxo detalhado de aprovação de contas para ambos os formatos, incluindo o envio de documentos obrigatórios e o uso correto dos endpoints.

Período de Avaliação Regulatória

Todos os novos clientes que desejam criar subcontas via API estarão inicialmente sujeitos ao período de avaliação regulatória para serviços na API. Durante esse período obrigatório, as operações de subcontas e cobranças terão limites definidos. Clique aqui e consulte o funcionamento completo.

O Período de avaliação regulatória é um estágio obrigatório, ofertado pelo Asaas para que você tenha todo o suporte para utilizar nossa API seguindo todas as regras dispostas pelo Banco Central, pela Resolução Conjunta nº 16/17. Esse período se inicia a partir da primeira criação de subconta via API.

Limites durante o período:

• Máximo de 10 subcontas de diferentes titulares.
• Máximo de R$ 2.000,00 emitidos em cobranças por subconta.
• Vigência de 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.

Fluxo de Aprovação – Subconta Padrão

Resumo: Subcontas padrão (não White Label) possuem acesso à interface do Asaas. Após a criação da conta, o responsável recebe um e-mail para redefinição de senha e segue com o envio de documentos diretamente pela interface.

Fluxo:
Criação da Subconta
→ Endpoint: POST /accounts
→ A conta é criada e validada com a Receita Federal.

Recebimento de E-mail
→ O responsável pela conta recebe automaticamente um e-mail para redefinir a senha e acessar o painel do Asaas.

Redefinição de Senha
→ O responsável redefine a senha e realiza o login na interface Asaas.

Envio de Documentos
→ O envio dos documentos obrigatórios ocorre diretamente pela interface do Asaas.
→ Normalmente solicitados:

• Foto Selfie
• Foto do Documento de Identificação

Análise e Aprovação
→ O time de compliance do Asaas realiza a análise dos documentos enviados.
→ Conta aprovada.

Fluxo de Aprovação – Subconta White Label

Resumo: Subcontas White Label não possuem acesso à interface do Asaas. Todo o processo de envio de documentos é realizado via API ou através de um link externo (onboardingUrl), dependendo do tipo de documento.

Fluxo:
Criação da Subconta
→ Endpoint: POST /accounts
→ A conta é criada e inicia-se o processo de validação junto à Receita Federal.

Aguardar 15 segundos
→ Importante: aguarde no mínimo 15 segundos após a criação da conta antes de realizar verificações de documentos.
→ Motivo: garantir que a validação e a captação dos dados junto à Receita Federal tenham sido concluídas.
→ Caso essa espera não seja respeitada, o retorno poderá indicar incorretamente que documentos não obrigatórios sejam enviados.

Verificar Documentos Pendentes
→ Endpoint: GET /myAccount/documents
→ Verifica quais documentos precisam ser enviados.
Confira a referência completa deste endpoint

Analisar Resposta
→ Por padrão, para Pessoa Física e Pessoa Jurídica (exceto Associações):

• Foto Selfie
• Foto do Documento de Identificação

→ Para Associações:

• Além dos documentos acima, Ata de Eleição.

Verificar atributo onboardingUrl
→ Se presente no objeto do documento:
✅ Documento deve ser enviado através do link externo (onboardingUrl).
❌ Não será aceito o envio via API (POST).

→ Se não presente:
✅ Documento deve ser enviado via API:
→ Endpoint: POST /myAccount/documents/{id}
Confira a referência completa deste endpoint

Envio de Documentos

• Com onboardingUrl: link externo, transparente, sem marca Asaas.
• Sem onboardingUrl: envio via API.

Análise e Aprovação
→ O time de compliance do Asaas realiza a análise dos documentos enviados.
→ Conta aprovada.

🚧

Importante

O 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.

Nas subcontas White Label o onboardingUrl é um link sem nenhuma marcação do Asaas, garantindo a experiência white label.

❗️

ATENÇÃO:

Respeite o timeout mínimo de 15 segundos após a criação da conta antes de verificar documentos pendentes.

Este fluxo garante que o processo de ativação e envio de documentos seja realizado da forma correta e adequada ao tipo de subconta (Padrão ou White Label), evitando erros comuns e garantindo a conformidade regulatória.