Split em cobranças antecipadas

Antecipe cobranças com Split

Ao antecipar uma cobrança com Split, considere as taxas do Asaas e da antecipação no valor disponível para repasse.

O Split passa a ser validado ou calculado sobre o valor líquido final após a antecipação, e não sobre o valor bruto da cobrança.

Antes de solicitar a antecipação

Verifique se:

a cobrança possui Split configurado;
a cobrança está elegível para antecipação;
o valor do Split é compatível com o valor líquido estimado após as taxas;
sua conciliação considera o valor efetivamente antecipado.

Consulte o guia de Antecipações.

📘
Importante
Em cobranças antecipadas, o split deve considerar o valor líquido final da cobrança após a dedução das taxas do Asaas e das taxas de antecipação.
Por isso, não utilize o valor bruto da cobrança como base para validar o valor que será repassado por split.

Como funciona

%%{init: {"flowchart": {"nodeSpacing": 28,"rankSpacing": 32,"diagramPadding": 8,"padding": 10}}}%%
flowchart TD
    A["Criar cobrança com Split"] --> B["Simular a antecipação"]
    B --> C["Calcular o valor líquido final"]
    C --> D["Validar a regra de Split"]
    D --> E["Solicitar a antecipação"]
    E --> F["Processar a antecipação"]
    F --> G["Liquidar os Splits"]
    G --> H["Receber os Webhooks"]

    classDef inicio fill:#DBEAFE,stroke:#2563EB,color:#1E3A8A,stroke-width:3px,font-size:17px
    classDef validacao fill:#E0F2FE,stroke:#0284C7,color:#0C4A6E,stroke-width:2px,font-size:17px
    classDef sucesso fill:#DCFCE7,stroke:#16A34A,color:#14532D,stroke-width:3px,font-size:17px

    class A inicio
    class B,C,D,E,F,G validacao
    class H sucesso

    linkStyle default stroke:#94A3B8,stroke-width:2px

Você pode simular a antecipação antes de solicitá-la:

POST /v3/anticipations/simulate

Consulte o endpoint Simular antecipação.

🚧
Atenção
Em cobranças antecipadas, o valor líquido após antecipação é a base operacional para validar ou calcular o split.
Isso pode reduzir o valor disponível para repasse quando comparado ao valor líquido original sem antecipação.

Split com valor fixo

Para fixedValue, o valor configurado precisa ser compatível com o valor líquido disponível após as taxas da cobrança e da antecipação.

Exemplo:

Valor bruto da cobrança: R$ 100,00
Valor líquido após taxas do Asaas e antecipação: R$ 90,00
Split fixo configurado: R$ 95,00

Nesse cenário, o Split configurado ultrapassa os R$ 90,00 disponíveis e precisa ser ajustado.

Prefira validar essa relação antes de solicitar a antecipação.

Split percentual

Para percentualValue, o percentual é aplicado sobre o valor líquido final após a antecipação.

Exemplo:

Valor bruto da cobrança: R$ 100,00
Valor líquido após taxas do Asaas e antecipação: R$ 90,00
Split percentual configurado: 50%

Resultado:

Base de cálculo do Split: R$ 90,00
Percentual: 50%
Valor do Split: R$ 45,00

Com percentualValue = 100, todo o valor líquido disponível após a antecipação será destinado ao Split.

Tipo	Como tratar na antecipação
`fixedValue`	Valide se o valor cabe no líquido final disponível
`percentualValue`	Calcule o percentual sobre o líquido final após a antecipação

📘
Boa prática
Antes de solicitar a antecipação, valide se a regra de split configurada é compatível com o valor líquido estimado após as taxas.
Isso reduz recusas e divergências de conciliação.

Bloqueio por divergência

Se o valor dos Splits ultrapassar o líquido disponível durante o processamento da antecipação, o Asaas pode bloquear o valor por divergência.

Nesse fluxo, acompanhe:

PAYMENT_SPLIT_DIVERGENCE_BLOCK

O ajuste deve ocorrer em até 2 dias úteis.

Quando o bloqueio for finalizado, o Asaas envia:

PAYMENT_SPLIT_DIVERGENCE_BLOCK_FINISHED

Durante um bloqueio por divergência, a atualização do split pode ser permitida mesmo em cobranças antecipadas. Nesse cenário, nenhum outro campo da cobrança pode ser alterado.

Consulte o endpoint Atualizar cobrança existente.

Antecipação automática com Split fixo

Na antecipação automática de cartão de crédito, quando o Split fixo é definido na emissão da cobrança, o cálculo considera a maior taxa aplicável ao cartão utilizado.

Considere esse comportamento ao conciliar valores líquidos entre os recebedores.

Acompanhe por Webhooks

Utilize os eventos de cobrança para acompanhar o processamento:

Evento	O que indica
`PAYMENT_ANTICIPATED`	A cobrança foi antecipada
`PAYMENT_SPLIT_DONE`	Um Split específico foi liquidado
`PAYMENT_SPLIT_DIVERGENCE_BLOCK`	O valor foi bloqueado por divergência
`PAYMENT_SPLIT_DIVERGENCE_BLOCK_FINISHED`	O bloqueio por divergência foi finalizado

PAYMENT_SPLIT_DONE é disparado individualmente para cada Split liquidado.

Consulte os Eventos para cobranças.

Próximos passos

Updated 6 days ago

Did this page help you?