Introdução - Split de pagamento

Como dividir parte dos valores recebidos.

Conheça o Split de Pagamentos

O Split de Pagamentos distribui automaticamente parte do valor recebido em uma cobrança entre outras contas Asaas.

A cobrança permanece na conta responsável pela venda ou serviço, enquanto os valores configurados são repassados às carteiras indicadas no Split.

Escolha o fluxo

A configuração do Split varia conforme o tipo de cobrança:

Necessidade	Conteúdo
Dividir uma cobrança avulsa	Split em cobranças avulsas
Dividir os valores de um parcelamento	Split em parcelamentos
Aplicar Split às cobranças de uma assinatura	Split em assinaturas
Antecipar uma cobrança que possui Split	Split em cobranças antecipadas
Consultar Splits pela interface	Consulta de Splits via interface
Utilizar Split sem desenvolver uma integração própria	Usando o Split sem API
Configurar pelo WooCommerce	Split no WooCommerce
Configurar pela Pluga	Split na Pluga

Também é possível criar automações com Split utilizando o Make.

Antes de começar

Para configurar um Split:

cada recebedor deve possuir uma conta Asaas;
obtenha o walletId das contas que receberão os valores;
defina se cada repasse será fixo ou percentual;
não informe o walletId da própria conta que cria a cobrança.

O walletId é retornado na criação de uma subconta e também pode ser recuperado via API quando você possui acesso à conta de destino.

⚠️
Atenção
Não informe o walletId da conta que cria a cobrança. O valor líquido que não for direcionado aos recebedores permanece automaticamente nessa conta.
Cobranças utilizadas como garantia em operações de crédito não podem executar Split.

Como funciona

Considere uma venda realizada pela conta de João em que Marcelo deve receber 20%:

João cria a cobrança em sua própria conta;
o Split informa o walletId de Marcelo e o percentual de 20%;
após o recebimento, o Asaas calcula o Split sobre o valor líquido da cobrança;
o valor correspondente é repassado para Marcelo;
o saldo líquido não distribuído permanece com João.

📘
Importante
O Split é calculado sobre o netValue, ou seja, o valor da cobrança após o desconto das taxas aplicáveis.

Defina o valor do Split

O repasse pode ser configurado de duas formas:

Campo	Como funciona	Limite de casas decimais
`fixedValue`	Define um valor fixo para o recebedor	2
`percentualValue`	Define um percentual sobre o `netValue`	4

É possível combinar valores fixos e percentuais na mesma cobrança.

Não existe prioridade entre os tipos de Split. Todos são validados considerando o valor líquido disponível.

Por exemplo, para uma cobrança com netValue de R$ 98,00:

fixedValue = R$ 50,00
percentualValue = 50%

50% de R$ 98,00 = R$ 49,00

R$ 50,00 + R$ 49,00 = R$ 99,00

Nesse cenário, a configuração ultrapassa o netValue e não pode ser processada.

Para Splits exclusivamente percentuais, a soma não pode ultrapassar 100%.

Regras específicas de parcelamentos, como totalFixedValue, estão detalhadas em Split em parcelamentos.

Acompanhe o Split

Utilize Webhooks para acompanhar a liquidação sem realizar consultas recorrentes à API.

O evento:

PAYMENT_SPLIT_DONE

é enviado individualmente quando um Split é liquidado.

Quando uma cobrança possui mais de um Split, cada liquidação pode gerar um evento diferente.

Identifique o Split correspondente por:

{
  "additionalInfo": {
    "splitId": "064a4957-1eee-4d06-9c96-deaf8a17534d"
  }
}

Consulte os Eventos para cobranças.

Bloqueio por divergência

Se, no recebimento ou na antecipação, o valor configurado para os Splits ultrapassar o valor líquido disponível, o valor e o Split são bloqueados para ajuste.

A integração recebe:

PAYMENT_SPLIT_DIVERGENCE_BLOCK

O prazo para correção é de 2 dias úteis.

Se a configuração for corrigida dentro do prazo e passar a respeitar o valor disponível, o Split é processado.

Se não houver correção, o bloqueio expira, os Splits são cancelados e a aplicação recebe:

PAYMENT_SPLIT_DIVERGENCE_BLOCK_FINISHED

Estornos

Quando uma cobrança com Split é estornada, os repasses relacionados também são estornados.

Considere esse comportamento na conciliação das contas que receberam valores da cobrança.

Status do Split

Os status disponíveis são:

Status	Interpretação
`PENDING`	Split pendente
`AWAITING_CREDIT`	Aguardando crédito
`DONE`	Split concluído
`CANCELLED`	Split cancelado
`REFUSED`	Split recusado
`REFUNDED`	Split estornado

Quando o status for REFUSED, o campo refusalReason pode indicar o motivo da recusa.

O motivo RECEIVABLE_UNIT_AFFECTED_BY_EXTERNAL_CONTRACTUAL_EFFECT indica que o Split não foi executado devido à existência de efeitos de contrato.

Próximos passos

Updated 3 days ago

Did this page help you?