Se você opera um marketplace ou uma plataforma de afiliados, cada venda precisa ser dividida entre vários recebedores: o vendedor que de fato entrega o produto, a casa que opera a plataforma, talvez um afiliado que indicou. Fazer isso com TED manual no D+1 é convite a erro contábil e atraso pro seller.

O que é split de pagamentos

Split é a capacidade do gateway de distribuir o valor da cobrança entre múltiplas contas Vanilla Pag no momento exato em que o cliente paga. O seller vê o dinheiro cair na conta dele em segundos, sem você precisar mover nada.

Como funciona na Vanilla Pag

Você adiciona um campo splits no POST de criação da cobrança. Cada item especifica um recipient_user_id (outro usuário Vanilla Pag) e um percentual ou valor fixo.

POST /v1/payment-transaction/create
{
  "amount": 10000,                  // R$ 100,00
  "external_id": "pedido-1",
  "customer": { ... },
  "splits": [
    { "recipient_user_id": 42, "split_percent": 80 },   // seller fica com 80%
    { "recipient_user_id": 19, "split_percent": 5 }     // afiliado fica com 5%
    // o restante (15%) fica na conta de quem criou a cobrança
  ]
}

Combinando percentual e valor fixo

Você pode misturar split_percent e split_fixed_cents no mesmo array. Útil quando o marketplace quer cobrar uma taxa fixa do seller mais uma parcela variável.

"splits": [
  { "recipient_user_id": 42, "split_percent": 90 },
  { "recipient_user_id": 88, "split_fixed_cents": 200 }   // R$ 2,00 fixo
]

Limites e regras

  • A soma dos splits não pode passar de 100% do valor.
  • Cada recebedor precisa ter conta Vanilla Pag aprovada.
  • Os splits são registrados no momento da criação e movimentados quando o status vai pra PAID.
  • Se a transação for estornada, os splits são revertidos automaticamente.

E na contabilidade?

Cada recebedor vê a parcela dele entrar via Vendas no painel, com o ID da transação original como referência. Você consegue auditar a cadeia inteira no journal contábil. Sem TED, sem planilha, sem reconciliação manual.

Cadastre-se grátis e configure splits na primeira cobrança.