Subcontas
Subcontas permitem criar contas Asaas para parceiros, clientes ou estabelecimentos vinculados a uma conta-pai. Cada subconta pode ter sua própria operação financeira, clientes, cobranças, transferências, saldo e configurações.
Antes de iniciar a integração, escolha entre subconta não-BaaS e subconta BaaS. A criação utiliza a mesma API, mas a experiência do titular, o onboarding e as responsabilidades da conta-pai são diferentes.
Escolha o modelo de subconta
| Modelo | Quando utilizar | Acesso do titular | Onboarding e comunicação |
|---|---|---|---|
| Não-BaaS | Quando o titular utilizará os recursos diretamente no Asaas. | O titular acessa o site ou aplicativo do Asaas após definir sua senha. | O Asaas envia a comunicação de ativação e o titular conclui as etapas cadastrais pela interface. |
| BaaS | Quando os serviços financeiros serão disponibilizados dentro do seu próprio site ou aplicativo. | O cliente utiliza a experiência desenvolvida pela conta-pai e não precisa acessar o dashboard do Asaas. | A conta-pai conduz a jornada do cliente. O envio de documentos ocorre pelo fluxo de onboarding previsto para o BaaS. |
Antes de começarA criação de subcontas via API é permitida para contas-pai de pessoa jurídica (CNPJ).
Novos clientes que iniciam a criação de subcontas via API também ficam sujeitos ao período de avaliação regulatória para serviços na API.
Consulte a FAQ do Período de Avaliação para entender os limites e as condições desse período.
Subcontas não-BaaS
Utilize esse modelo quando o titular da subconta precisar acessar o Asaas diretamente.
Após a criação, o titular recebe a comunicação de ativação para definir a senha e continuar sua jornada no Asaas.
Siga estes conteúdos:
- Criação de subcontas — implemente a criação e armazene os identificadores retornados.
- Detalhamento do Fluxo de Aprovação de Subcontas — entenda como o titular conclui a ativação e o envio de documentos.
Subcontas BaaS
Utilize BaaS quando sua plataforma oferecer os serviços financeiros dentro da própria experiência, sem que o cliente precise gerenciar a conta pelo dashboard do Asaas.
O modelo BaaS deve ser previamente alinhado e habilitado para sua operação. Criar uma conta pela API sem essa configuração não a transforma automaticamente em uma subconta BaaS.
Se ainda estiver definindo o modelo, consulte BaaS (Banking As A Service) com o Asaas.
Para implementar:
- Criação de subcontas com o BaaS do Asaas — crie a subconta conforme a configuração BaaS da sua operação.
- Onboarding e envio de documentos via link — conduza o envio da documentação cadastral.
- Detalhamento do Fluxo de Aprovação de Subcontas — acompanhe as diferenças entre a aprovação BaaS e não-BaaS.
Gerencie subcontas existentes
Depois da criação e aprovação, utilize o conteúdo correspondente à operação que precisa realizar.
| Necessidade | Conteúdo |
|---|---|
| Confirmar ou atualizar periodicamente os dados cadastrais | Confirmação Anual de Dados Comerciais para Subcontas |
| Alterar o nome de uma subconta PJ | Alterar o nome de uma subconta PJ via API |
| Gerenciar chaves de API de subcontas BaaS | Gerenciamento das chaves de API de subcontas |
| Encerrar uma subconta não-BaaS elegível | Encerramento de subcontas não-BaaS |
Próximos passos
Updated 16 days ago