Para criar cobranças com split de pagamento, o recurso precisa estar habilitado na sua conta Asaas. O split vem desabilitado por padrão em contas novas e em contas que nunca criaram split. Se a sua conta já utilizou split, nada muda.
Como habilitar o split de pagamento
- Acesse a conta principal (conta pai) pelo site do Asaas.
- No menu lateral, vá em Integrações > Segurança.
- No painel Habilitar Split de pagamento, clique em Habilitar Split.
- Confirme com o código enviado por SMS ou pelo Token App.
A habilitação feita pela conta principal vale para todas as subcontas vinculadas a ela.
Para confirmar a habilitação, a conta precisa ter uma ação crítica ativa (SMS ou Token App). Se ainda não tiver, a própria tela orienta como ativar.
Qual erro aparece quando o split não está habilitado?
Ao criar uma cobrança, um parcelamento ou uma assinatura com split sem a habilitação, a API retorna o erro invalid_action com uma destas mensagens:
- Na conta principal: "A criação de Split de pagamento está desabilitada. Para habilitar, acesse Integrações > Segurança, clique em "Habilitar Split" no painel "Habilitar Split de pagamento" e confirme com o código enviado por SMS ou pelo Token App."
- Na subconta: "A criação de Split de pagamento está desabilitada. Para habilitar, solicite à conta principal que acesse Integrações > Segurança e clique em "Habilitar Split" no painel "Habilitar Split de pagamento"."
Se você usa uma subconta, peça ao responsável pela conta principal para fazer a habilitação. Depois disso, envie a requisição novamente.
Para mais detalhes, consulte a documentação de Split de pagamento.