Skip to main content
O split de pagamentos permite dividir automaticamente o valor recebido em cada transação entre o seller principal e um ou mais afiliados. A divisao e aplicada sobre o netAmount (valor após a deducao da taxa da Linka).

​
Como Funciona

Quando uma transação e processada e marcada como PAID, o sistema aplica automaticamente a configuração de split cadastrada para o seller. Os valores sao distribuidos entre as wallets dos participantes sem intervencao manual.
O split e calculado sobre o netAmount (valor após a taxa da Linka), não sobre o valor bruto da transação.

​
Configurando o Split

O split e configurado por seller via API administrativa. A configuração define:
  • Percentual destinado ao seller principal
  • Percentual destinado a cada afiliado
  • O afiliado deve ser um seller cadastrado na plataforma (identificado por ID)

​
Endpoints

MétodoPathDescrição
GET/split-config/:idConsultar configuração de split
PUT/split-config/:idAtualizar configuração
DELETE/split-config/:idRemover configuração

​
Exemplo de Configuração

Configuração de split 70/30
{
  "sellerId": "seller-uuid-principal",
  "affiliateId": "seller-uuid-afiliado",
  "sellerPercentage": 70,
  "affiliatePercentage": 30
}
Os percentuais devem somar 100%.

​
Cálculo do Split

Dado uma transação com amount: 10000 (R$ 100,00) e taxa de 2.5% (fee: 250): 
netAmount = amount - fee
netAmount = 10000 - 250 = 9750 centavos (R$ 97,50)

seller_credit    = netAmount * 70% = 6825 centavos (R$ 68,25)
affiliate_credit = netAmount * 30% = 2925 centavos (R$ 29,25)
O sistema usa Error Diffusion para garantir que a soma dos splits corresponda exatamente ao netAmount, evitando perdas de centavos por arredondamento acumulado ao longo de muitas transações.

​
Métodos Suportados

O split esta disponível para todos os métodos de pagamento:
MétodoQuando o split e aplicado
PIXImediatamente após PAID
BoletoImediatamente após PAID (saldo pendente até D+3)
CartãoImediatamente após PAID (saldo pendente até D+N)

​
Rastreamento no Extrato

Cada crédito de split gera um BalanceStatement na wallet do afiliado com a referência da transação de origem. Isso permite rastrear quais transações geraram cada crédito de split.
Entrada no extrato do afiliado
{
  "type": "CREDIT",
  "amount": 2925,
  "description": "Split de txn_uuid_aqui",
  "transactionId": "txn_uuid_aqui",
  "createdAt": "2026-04-09T12:05:00.000Z"
}

​
Casos de Uso Comuns

Um marketplace recebe pagamentos e repassa uma porcentagem para cada vendedor cadastrado. Cada vendedor e um seller com sua própria wallet.
Pagamento: R$ 200,00
Taxa Linka: R$ 5,00
netAmount: R$ 195,00

Marketplace (seller principal): 80% = R$ 156,00
Vendedor (afiliado):            20% = R$ 39,00

​
Pontos de Atencao

  • O afiliado deve ter uma conta ativa na Linka para receber o split.
  • Alteracoes na configuração de split so afetam transações criadas após a alteracao.
  • Em caso de estorno ou chargeback, o split e revertido proporcionalmente — cada participante devolve a sua parte.
  • A configuração de split e por seller, não por transação individual.