Guia de Subcontas

Confira o guia de subcontas para mais informações.

O objeto de retorno da API conterá a chave de API da subconta criada (apiKey) além do walletId para Split de Cobranças ou Transferências.

A chave de API (apiKey) será devolvida uma única vez, na resposta da chamada de criação da subconta Asaas, portanto, assegure-se de gravar a informação nesse momento. Caso não tenha realizado o armazenamento, entre em contato com nosso Suporte Técnico.

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

🚧
Informe sempre um CEP válido
O postalCode informado precisa ser válido, pois fazemos o cadastro da cidade através dele. Caso não seja localizado, será retornado um erro 400 avisando que a cidade precisa ser informada

❗️
Atenção
O envio da renda (PF) ou faturamento mensal (PJ) através do campo incomeValue nos endpoints de Atualização de Dados Comerciais (/v3/myAccount/commercialInfo) e Criação de Subcontas (/v3/accounts) é obrigatório.

❗️
Atenção - Manutenção Cadastral Anual Obrigatória
Lembre-se que, anualmente, os dados comerciais da subconta (como telefone, e-mail, endereço, renda/faturamento e atividade) precisarão ser confirmados ou atualizados. Este é um requisito regulatório. Veja detalhes completos na seção Confirmação Anual de Dados Comerciais para Subcontas em nosso Guia.