Criação de subcontas

A criação de subcontas possibilita que você crie contas Asaas para seus parceiros/clientes vinculadas a uma conta raiz, de forma que eles possam utilizar todas as funcionalidades do Asaas através do nosso site, aplicativo ou através de uma plataforma integrada desenvolvida por você.

Como resposta da criação da subconta Asaas, você receberá a chave de API (apiKey) da subconta criada para prosseguir com a integração, e também o walletId caso deseje trabalhar com o Split de pagamentos ou com a Transferência entre contas Asaas.

Lembrando que, embora as subcontas geradas embaixo da sua conta raiz herdem definições de taxas e gerência da conta raiz, outras configurações devem ser realizadas individualmente em cada subconta criada, como webhooks, informações fiscais para emissão de notas, etc.

📘

A criação de subcontas incide de cobranças de taxas para cada conta criada, verifique em Configurações de Contas > Taxas, quais taxas se aplicam.

Criação da subconta

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",
}

🚧

Importante

Em Sandbox só é possível criar 20 subcontas por dia, caso a conta atinja o limite diário receberá uma notificação de erro.

Além disso, todas as comunicações de subcontas em Sandbox serão enviadas para o e-mail da conta raiz. O dono da subconta recebe notificações.

Ao criar uma subconta, quando ela não é Whitelabel, um e-mail de nova conta será enviado para o e-mail configurado.

Guardando a chave de API da subconta

As chamadas seguintes para envio de documentos deverão ser realizadas utilizando a chave de API da subconta criada. A chave será devolvida como resposta da requisição de criação da conta e deverá ser armazenada nesse momento, não podendo ser recuperada posteriormente.