Split de Pagamento

O split de pagamento é uma funcionalidade que permite "dividir" valores recebidos através dos pagamentos entre uma ou várias carteiras (contas Asaas) automaticamente.

Por exemplo, consideremos o seguinte cenário hipotético: João faz uma venda de R$ 200 e Marcelo deve receber 20% do valor da venda no formato de comissão. Neste caso a cobrança deve ser criada na conta do João, pois é ele quem fez venda ou prestou o serviço, e através das configurações de split será indicado que Marcelo deve receber os 20% do valor da cobrança. Desta maneira, ao registrar o recebimento da cobrança, o Asaas fará o débito do valor da conta do João e creditará na conta do Marcelo automaticamente.

Ao configurar o split é possível informar tanto valor fixo (fixedValue, com até 2 casas decimais) quanto percentual (percentualValue, com até 4 casas decimais) sobre a cobrança, podendo combinar as duas opções na mesma cobrança. Em ambos os casos, o cálculo é feito com base no valor líquido (netValue) da cobrança, ou seja, após o desconto da tarifa do Asaas. A soma dos splits percentuais não pode ultrapassar 100%, e a soma total dos splits (fixos e percentuais) não pode ultrapassar o valor líquido da cobrança.

Não informe o walletId da própria conta que está criando a cobrança: o valor líquido que não for direcionado aos recebedores permanece automaticamente nessa conta.

Se, no recebimento ou na antecipação da cobrança, o valor configurado para os splits ultrapassar o valor líquido disponível, o valor e o split são bloqueados para ajuste, com notificação via webhook (PAYMENT_SPLIT_DIVERGENCE_BLOCK) e prazo de 2 dias úteis para correção. Sem ajuste no prazo, o bloqueio expira, os splits são cancelados e a integração recebe o evento PAYMENT_SPLIT_DIVERGENCE_BLOCK_FINISHED. Para acompanhar a liquidação de cada split, utilize o evento PAYMENT_SPLIT_DONE.

Em caso de estorno da cobrança, o split também será estornado, ou seja, todas as contas que receberam o saldo da cobrança em questão terão a transferência estornada.

Para maiores instruções e modelos das requisições, acesse a seção de split em nossa documentação oficial, disponível aqui.

Importante:

• O split de pagamento é uma funcionalidade exclusiva da API do Asaas, não podendo ser configurado através do site. É possível apenas consultar os splits pagos e recebidos pela interface, quando essa opção estiver disponível;
• Cobranças utilizadas como garantia em operações de crédito não podem executar split;
• Para realizar o split, é preciso possuir o walletId (ID da carteira) de todos os envolvidos no split. O walletId é um dado retornado automaticamente na criação de subcontas e também pode ser recuperado via requisição caso você possua a chave de API da conta destino. Também é possível entrar em contato por meio dos nossos canais de atendimento para recuperá-lo.