Criar subconta

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) passará a ser obrigatório e você precisa atualizar sua integração para que as chamadas sejam enviadas com essa informação.

A partir do dia 30/05/24, chamadas para estes endpoints sem essa informação retornarão erro, indicando que o campo é obrigatório.