Guia de Arquitetura de Split de Pagamentos para Marketplaces e Plataformas SaaS

Marketplaces modernos e plataformas de software distribuem valor entre múltiplos participantes a cada venda. A implementação manual de repasses gera passivos tributários e sobrecarga de conciliação. A arquitetura de Split de Pagamentos nativo na adquirente resolve esse gargalo na origem da transação.

1. O que é Split Nativo de Recebíveis?

Em um modelo tradicional sem split, todo o valor da compra transita na conta da plataforma (gerando risco de faturamento integral e bitributação). No split nativo, a autorizadora financeira recebe a instrução de divisão no momento exato em que a cobrança é aprovada, direcionando as parcelas líquidas diretamente para a subconta de cada seller e retendo apenas a taxa/take-rate da plataforma.

2. Modelagem de Dados e Regras de Negócio

A arquitetura de split da PagLoop suporta regras combinadas por produto ou pedido:

• Split Percentual: Exemplo: 85% para o seller executor, 15% para a plataforma mantenedora.
• Split Fixo + Percentual: Exemplo: R$ 2,50 fixos de taxa de infraestrutura mais 4% de taxa de processamento.
• Rateio de Custos de Processamento: Configuração granular sobre quem absorve a taxa de adquirente (a plataforma ou o vendedor final).

3. Exemplo Prático de Criação com Split

Ao emitir uma ordem de checkout com múltiplos recebedores, a instrução split especifica os IDs das subcontas cadastradas:

curl -X POST https://api.pagloopfinance.com/api/v1/checkouts/order \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 200.00,
    "customer": {
      "name": "Juliana Mendes",
      "email": "[email protected]",
      "document": "98765432100"
    },
    "split_rules": [
      {
        "recipient_id": "sub_seller_8812",
        "percentage": 85.0,
        "liable_for_fees": false
      },
      {
        "recipient_id": "sub_marketplace_01",
        "percentage": 15.0,
        "liable_for_fees": true
      }
    ]
  }'

4. Governança Contábil e D+0

O desacoplamento contábil garante que cada participante receba notas fiscais e relatórios de informe de rendimentos emitidos exclusivamente sobre sua parcela de intermediação, eliminando fricção contábil.