Quem fica com o centavo que sobra?

Quem você indicar. Numa divisão de R$ 100,03 em duas partes iguais, cada parte trunca em R$ 25,00 sobre o que sobra e o centavo de arredondamento vai para o recebedor que você apontou. A soma das partes é sempre exatamente igual ao total.

A divisão do fluxo substitui a da requisição?

Não, é o contrário: o split enviado na criação do pagamento vence o do fluxo. A divisão de um pagamento é decidida uma única vez, e o nó de split não recalcula o que já está gravado.

Quem responde pelo chargeback de cada parcela?

Você define por recebedor. Na estimativa de saldo, um estorno total reverte a parcela inteira e um chargeback reverte só a de quem foi marcado como responsável.

Marketplace

Divida a venda sem perder um centavo

Defina quanto cada vendedor, parceiro ou afiliado recebe. O cálculo reserva as parcelas fixas, aplica os percentuais sobre o que sobra e entrega os centavos de arredondamento a quem você escolher.

Até 20 recebedores por venda
A soma fecha ao centavo
Simule antes de cobrar

Testar no sandbox Documentação de split

Como funciona

1
Cadastre os recebedores
Documento com dígito conferido, conta bancária ou chave Pix, e o padrão de divisão de cada um.
2
Defina a divisão
Na criação do pagamento ou num nó do fluxo. Percentual em basis points, valor fixo em centavos.
3
Simule
O simulador usa a mesma função do motor e devolve cada parcela, os centavos de arredondamento e o que fica com a conta principal.
4
Cobre
A divisão é decidida uma única vez e fica gravada na transação, inclusive quando o fluxo é retomado depois.

No painel

O simulador

Informe o valor e as regras. O resultado mostra cada parcela, quem fica com os centavos de arredondamento e quanto sobra para a conta principal, sem gravar nada.

Simulação de divisão de R$ 100,03 entre dois recebedores, com os centavos resolvidos.

No painel

Os recebedores

Cada recebedor tem documento validado, destino de repasse, divisão padrão e a definição de quem responde pelo chargeback da parcela dele.

Cadastro de recebedores, com dados bancários mascarados e divisão padrão.

O que está incluído

O que não foi dividido fica com você
Não é preciso cadastrar a sua própria empresa como recebedor para ficar com a comissão. "90% para o vendedor" basta, e os outros 10% ficam na conta principal, sem gerar linha de split.
Quatro regras, nesta ordem
As parcelas fixas são reservadas primeiro. Os percentuais valem sobre o que sobra, truncados no centavo, então ninguém leva mais do que configurou. Os centavos de arredondamento vão para o recebedor que você indicar. O resto fica com a conta principal.
O banco não deixa a conta estourar
Além da validação na API, um gatilho no banco impede gravar parcelas que somem mais do que o pagamento. É a última trava, para o caso de um caminho novo esquecer a primeira.
Erro com motivo nomeado
Soma acima de 100%, parcela fixa maior que o valor, recebedor repetido ou inexistente: cada um volta com o motivo e o campo, antes de qualquer cobrança acontecer.
percentage_over_100 · fixed_exceeds_amount · duplicate_recipient
Simulador com a mesma função do motor
Configuração inválida não devolve erro: devolve a lista de problemas, separados entre o que impede e o que é só aviso, como centavos de arredondamento ou a fatia que ficará com a conta principal.
POST /v1/recipients/split-preview
Dado bancário mascarado por padrão
Documento, conta e chave Pix aparecem mascarados em listagem e em webhook. E trocar a conta de repasse fica na auditoria com quem pediu e de onde, porque essa é a fraude clássica de marketplace.

Pagamento com split

POST /v1/payments{  "amount": 10003,  "customerId": "cus_01HQ...",  "paymentMethodId": "pm_01HQ...",  "splits": [    { "recipientId": "rcp_vendedor", "type": "percentage", "value": 2500 },    { "recipientId": "rcp_parceiro", "type": "percentage", "value": 2500 }  ],  "splitRemainderRecipientId": "rcp_parceiro"}

Documentação de split

A liquidação ainda é do estabelecimento

A divisão é calculada, validada e gravada, e segue para o parceiro nas instruções do pagamento. Mas as adquirentes disponíveis hoje não aplicam essas instruções: o valor é liquidado inteiro para o seu estabelecimento, e a divisão fica registrada no Minstrel para consulta e conciliação. O repasse automático chega com o primeiro parceiro que suportar a capacidade de split.

Dúvidas frequentes

O detalhe técnico de cada resposta está na documentação de split.

Quem fica com o centavo que sobra?
Quem você indicar. Numa divisão de R$ 100,03 em duas partes iguais, cada parte trunca em R$ 25,00 sobre o que sobra e o centavo de arredondamento vai para o recebedor que você apontou. A soma das partes é sempre exatamente igual ao total.
A divisão do fluxo substitui a da requisição?
Não, é o contrário: o split enviado na criação do pagamento vence o do fluxo. A divisão de um pagamento é decidida uma única vez, e o nó de split não recalcula o que já está gravado.
Quem responde pelo chargeback de cada parcela?
Você define por recebedor. Na estimativa de saldo, um estorno total reverte a parcela inteira e um chargeback reverte só a de quem foi marcado como responsável.

Continua em

Veja funcionando no sandbox

Gratuito, ilimitado e sem prazo. Dá para simular aprovação, cada recusa da ABECS e falha de rede antes de credenciar a primeira adquirente.

Primeiros passos Ver preços