Criação de subcontas com o BaaS do Asaas

⚠️

Importante

O modelo BaaS do Asaas (Antigo "White Label"), para fornecimento de serviços bancários para terceiros (Banking As a Service) agora está sujeito à obrigatoriedade de exposição e identificação do Asaas como Instituição Prestadora, conforme sinalizado pela Resolução Conjunta nº 16/17. Além disso, as novas contas integram-se inicialmente ao período de avaliação regulatória para Serviços na API.

Com o BaaS do Asaas habilitado seu cliente não precisará ter acesso ao nosso sistema e não receberá nenhum tipo de comunicação por parte do Asaas, cabendo a você nesse caso disponibilizar os recursos desejados de nossa documentação API dentro do seu sistema integrado, garantindo, apenas, a conformidade com as regras de empresa Tomadora.

O processo para começar com criação de subcontas no modelo BaaS se resume nos seguintes passos:

• Solicitação ao seu gerente de contas para liberação desta funcionalidade
• Criação da subconta Asaas com Webhooks sendo configurados
• Envio da Documentação da subconta, pelo onboarding com envio de documentos via link
• Consultar situação cadastral da subconta

🚧

Atenção

O formato BaaS precisa estar previamente alinhado e implantado pelo seu gerente de contas. A criação de contas Asaas usando os métodos listados abaixo sem uma definição prévia do funcionamento no formato autorizado, resultará na criação de subcontas fora dessa estrutura.

Em Sandbox, para fazer o teste, basta verificar aqui nessa sessão como configurar na conta sandbox.

Criação da subconta com Webhooks sendo configurados

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

{
    "name": "Subconta criada via API",
    "email": "[email protected]",
    "cpfCnpj": "66625514000140",
    "birthDate": "1994-05-16",
    "companyType": "MEI",
    "phone": "11 32300606",
    "mobilePhone": "11 988451155",
    "address": "Av. Rolf Wiest",
    "addressNumber": "277",
    "complement": "Sala 502",
    "province": "Bom Retiro",
    "postalCode": "89223005",
    "webhooks": [
        {
            "name": "Webhook para cobranças",
            "url": "http://meusite.com/webhook/payments",
            "email": "[email protected]",
            "sendType": "SEQUENTIALLY",
            "interrupted": false,
            "enabled": true,
            "apiVersion": 3,
            "authToken": "5tLxsL6uoN",
            "events": ["PAYMENT_CREATED", "PAYMENT_UPDATED", "PAYMENT_CONFIRMED", "PAYMENT_RECEIVED"]
        }
    ]
}

É de suma importância que os Webhooks sejam configurados de início em subcontas BaaS para garantir que nenhum evento de criação ou atualização da conta sejam perdidos, evitando também a necessidade de requisições secundárias para configuração desses métodos.

Os detalhes sobre os eventos disponíveis para Webhooks pode ser conferido no guia de integrações de Webhook.

Período de avaliação regulatória - O que é?

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. Clique aqui e consulte o funcionamento completo.