Split de pagamento em marketplaces: arquitetura e operação

Em um marketplace, receber do cliente é apenas o começo. A plataforma precisa calcular comissões, distribuir valores, lidar com taxas, antecipações, cancelamentos e explicar cada centavo para todos os participantes.

O que é split de pagamento

Split é a divisão programática de uma cobrança entre recebedores. Em vez de a plataforma receber o valor total e transferir manualmente, o provedor processa a distribuição conforme regras previamente definidas.

Isso não elimina a responsabilidade de manter um livro financeiro interno. O sistema precisa registrar valor bruto, tarifas, comissão, valor do prestador, impostos aplicáveis, status e identificadores do provedor.

A arquitetura orientada por eventos

Pagamentos são assíncronos. Uma cobrança pode ser criada, autorizada, capturada, recusada, estornada ou contestada em momentos diferentes. Webhooks comunicam essas mudanças, mas podem chegar repetidos ou fora de ordem.

Uma implementação confiável valida a assinatura do evento, trata repetição com idempotência, registra o conteúdo recebido e responde rapidamente. O processamento mais pesado acontece em segundo plano.

Conciliação não é relatório opcional

Conciliação compara o que a aplicação esperava com o que o provedor efetivamente liquidou. Ela identifica divergências de tarifa, falhas de repasse, estornos pendentes e transações que não fecharam corretamente.

O painel operacional deve permitir investigar por pedido, cobrança, recebedor e período. Sem isso, a equipe financeira depende de exportações manuais e perde confiança nos números.

Perguntas para o discovery

1. Quem é o responsável comercial pela transação?
2. Quando o prestador tem direito ao repasse?
3. Quem absorve taxas e estornos?
4. Como funciona o cancelamento parcial?
5. Há retenção, reserva ou antecipação?
6. Quais informações precisam aparecer em notas e relatórios?

Essas respostas variam por modelo de negócio e devem ser avaliadas com suporte jurídico e contábil. A tecnologia implementa a regra; ela não substitui essa definição.

Métricas que ajudam a operar

Taxa de aprovação, tempo de liquidação, divergência de conciliação, volume de estornos e falhas de webhook mostram onde existe atrito. Monitorar apenas o volume transacionado pode esconder problemas relevantes.

Uma boa plataforma financeira oferece rastreabilidade, mecanismos de recuperação e alertas antes que uma exceção vire trabalho manual em escala.