Criação de subcontas Whitelabel

⚠️

Importante

O modelo 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 White Label habilitado seu cliente não 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.

O processo para começar com criação de subcontas em white label 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

🚧

O formato White Label 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 White Label 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 Whitelabel 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.