Configure Split em parcelamentos

Ao criar um parcelamento com Split, defina se o valor repassado será calculado por parcela, distribuído a partir de um valor total ou aplicado como percentual.

As regras gerais de walletId, netValue e limites estão em Split de Pagamentos.

Escolha como definir o Split

Como funciona

%%{init: {"flowchart": {"nodeSpacing": 28,"rankSpacing": 32,"diagramPadding": 8,"padding": 10}}}%%
flowchart TD
    A["Definir a regra do Split"] --> B["Criar o parcelamento"]
    B --> C["Gerar as parcelas"]
    C --> D["Receber cada parcela"]
    D --> E["Liquidar o Split correspondente"]
    E --> F["Receber o Webhook"]

    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 validacao
    class F sucesso

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

Defina um valor por parcela

Utilize fixedValue quando já souber quanto deve ser repassado em cada parcela.

Por exemplo, em um parcelamento de R$ 100,00 dividido em 4 parcelas, para repassar R$ 40,00 no total, configure R$ 10,00 por parcela:

{
  "totalValue": 100.00,
  "installmentCount": 4,
  "split": [
    {
      "walletId": "48548710-9baa-4ec1-a11f-9010193527c6",
      "fixedValue": 10.00
    }
  ]
}

Ao final das quatro parcelas, o valor total configurado para esse recebedor será de R$ 40,00.

Defina um valor total para o parcelamento

Utilize totalFixedValue quando quiser informar o valor total que deverá ser distribuído entre todas as parcelas.

Exemplo:

{
  "totalValue": 300.00,
  "installmentCount": 3,
  "split": [
    {
      "walletId": "0b763922-aa88-4cbe-a567-e3fe8511fa06",
      "totalFixedValue": 100.00
    }
  ]
}

Nesse caso, o Asaas distribui os R$ 100,00 entre as três parcelas:

1ª parcela: R$ 33,33
2ª parcela: R$ 33,33
3ª parcela: R$ 33,34

A diferença de arredondamento é aplicada à última parcela.

Defina um percentual

Utilize percentualValue quando o repasse deve acompanhar proporcionalmente o valor líquido de cada parcela:

{
  "totalValue": 300.00,
  "installmentCount": 3,
  "split": [
    {
      "walletId": "0b763922-aa88-4cbe-a567-e3fe8511fa06",
      "percentualValue": 6
    }
  ]
}

Nesse fluxo, o Asaas calcula 6% sobre o netValue de cada parcela.

Consulte o endpoint Criar nova cobrança.

Acompanhe a liquidação

Cada parcela possui sua própria cobrança e seu próprio processamento de Split.

Quando um Split for liquidado, utilize o evento:

PAYMENT_SPLIT_DONE

O evento é disparado individualmente para cada Split liquidado. Em um parcelamento de três cobranças com Split, podem ocorrer três eventos, conforme cada parcela for recebida e o respectivo Split for liquidado.

Utilize additionalInfo.splitId para identificar o Split correspondente.

Consulte os Eventos para cobranças.

Próximos passos

• Consulte as regras gerais do Split de Pagamentos
• Consulte como criar uma cobrança parcelada
• Entenda o Split em cobranças antecipadas
• Consulte Splits pela interface
• Consulte o FAQ do Split