Split de pagamento

Split de pagamento é dividir o valor de uma venda entre mais de um recebedor no momento em que ela é paga. Na xFlow Payments, você faz isso em cada cobrança Pix, entre contas da xFlow, por porcentagem ou por valor fixo. A divisão pode ir direto na cobrança, pela API, ou ficar como regra padrão da conta.

Esse split é comercial. Ele não é o split payment da reforma tributária, que é o recolhimento de IBS e CBS na liquidação financeira, previsto na Lei Complementar 214/2025. A diferença entre os dois está explicada em split de pagamento x split payment.

Como o split funciona na xFlow

1. Você cria a cobrança com POST /api/v1/charges e envia o campo splits, com os recebedores e a parte de cada um.
2. A xFlow valida o split. Se algo estiver errado, a API responde 400 e nada é criado.
3. O pagador paga o Pix normalmente. Ele vê uma cobrança só, com o valor cheio.
4. A xFlow confere o pagamento na adquirente.
5. Com o pagamento confirmado, cada recebedor é creditado no próprio saldo na xFlow. O que sobra fica no seu saldo.
6. Cada conta saca o próprio saldo por Pix, quando quiser.

O split funciona sobre a mesma API Pix e passa pelo mesmo roteamento entre as 11 adquirentes da xFlow. A forma de dividir não muda conforme a adquirente.

Dois tipos de divisão: porcentagem e valor fixo

Os dois tipos podem ser usados juntos na mesma cobrança. A soma dos percentuais não pode passar de 100.

Exemplo de cobrança com split

curl -X POST https://app.xflowpayments.com/api/v1/charges \
  -u "pk_live_...:sk_live_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: pedido-9012" \
  -d '{
    "amountCents": 10000,
    "customer": { "name": "Cliente Exemplo", "email": "cliente@exemplo.com", "document": "00000000000" },
    "description": "Pedido #9012",
    "external_reference": "pedido-9012",
    "splits": [
      { "recipient_id": "id-do-seller-B", "type": "PERCENTAGE", "percent": 40 },
      { "recipient_id": "id-do-seller-C", "type": "FIXED", "amount": 1500 }
    ]
  }'

Nessa cobrança de R$ 100,00, a conta B recebe 40% do valor líquido e a conta C recebe R$ 15,00. O restante fica com a conta que criou a cobrança. A reserva da conta, quando existe, incide só sobre a parte que sobra para você.

Na cobrança ou como regra da conta

• Na cobrança. Você envia splits em cada POST /api/v1/charges. Serve para quando a divisão muda de venda para venda, como num marketplace em que cada pedido é de um vendedor diferente.
• Como regra da conta. A divisão fica como regra padrão, configurada na sua conta com a equipe da xFlow, e vale para as cobranças da conta. Serve para quando a divisão é sempre igual, como uma comissão fixa de parceiro.

Regras de validação

• A soma dos percentuais não pode passar de 100.
• O recebedor precisa ser uma conta da xFlow ativa e diferente da conta que cria a cobrança.
• O recipient_id é o id da empresa recebedora. A própria empresa encontra esse id em GET /api/v1/company.
• Split inválido retorna 400, e a cobrança não é criada.
• No ambiente de teste (chave pk_test_), cobranças com splits retornam 400.

Por que fazer o split na cobrança

Sem split, quem recebe a venda precisa repassar a parte de cada pessoa depois, com uma transferência para cada uma. Isso cria trabalho, abre espaço para erro e deixa o dinheiro dos outros passando pela sua conta. Com o split na cobrança, a divisão acontece na confirmação do pagamento:

• Sem repasse manual. Cada recebedor é creditado direto no próprio saldo.
• Sem planilha de comissão. A regra vai junto com a cobrança ou fica salva na conta.
• Cada um saca o seu. O recebedor movimenta o próprio saldo, sem depender de você.
• Conciliação mais simples. A cobrança, o pagamento e a divisão ficam ligados pelo mesmo id e pelo seu external_reference.

O que acontece depois do pagamento

Com o pagamento confirmado, o webhook transaction.paid chega ao seu endpoint com o valor, o líquido (net) e a taxa (fee). Cada recebedor vê a parte dele no próprio saldo, consultado em GET /api/v1/balance, e saca por Pix pela API ou pelo painel. O passo a passo do saque está em API de saque Pix.

Para quem o split faz sentido

• Marketplaces, que dividem cada venda entre o vendedor e a plataforma. Veja xFlow para marketplaces e o guia de split de pagamento para marketplace.
• Plataformas com parceiros ou afiliados, que repassam uma parte fixa ou percentual de cada venda.
• Operações com sócios ou unidades, que precisam separar o valor de cada venda entre contas diferentes.