Um gateway de pagamento para marketplace precisa dividir cada venda entre a plataforma e os vendedores sem planilha no fim do mês: split na cobrança, subconta por recebedor, saque para o titular, webhooks e relatório por vendedor. Na AbacatePay o split roda no Pix do checkout transparente, com até 10 subcontas por cobrança e sem custo extra além da taxa do Pix.
Este checklist é para founder, CTO ou ops de marketplace (ou app multivendor, coprodução, franquia) que quer saber o que o gateway precisa ter antes de contratar. O produto comercial está em marketplaces e split de pagamento. Para a conta da comissão (% vs fixo), leia comissão de marketplace: como calcular.
O que muda no pagamento quando você tem vários vendedores
No e-commerce de um só lojista, o dinheiro cai numa conta só. No marketplace, o comprador paga uma vez e o valor precisa chegar em vários recebedores: plataforma, vendedor, às vezes entregador ou afiliado.
Sem split na cobrança, alguém transfere na mão no fim do dia — planilha, chave Pix errada, atraso. Quando o volume sobe, isso vira risco operacional. A ideia do o que é split de pagamento é definir as partes na API e creditá-las quando o Pix é pago.
Checklist: o que um gateway de marketplace precisa ter
1. Checkout multivendor
O comprador paga uma vez. A plataforma controla a regra de divisão. Pix, boleto e cartão (cartão sob consulta) no mesmo checkout reduzem abandono. Meio Pix: /pix.
2. Split / divisão automática na cobrança
As partes vão na cobrança (data.splits). Quando o Pix é pago, cada subconta recebe o valor. Sem segundo Pix manual. Produto: gateway com split.
3. Subcontas por vendedor (CPF ou CNPJ)
Cada recebedor tem saldo e extrato separados. O recebedor não precisa abrir conta na AbacatePay: a subconta fica dentro da conta da plataforma, identificada pelo documento.
4. KYC / identificação do recebedor
Nome + CPF ou CNPJ no cadastro. O saque da subconta vai só para a chave Pix CPF/CNPJ do titular — sem campo de chave livre, o que reduz desvio de repasse.
5. Comissão % ou valor fixo (ou os dois)
A API recebe partes em centavos. Percentual, valor fixo ou mistura na mesma venda — desde que a soma caiba no valor menos a taxa do Pix. Como montar a conta: comissão de marketplace: como calcular.
6. Saque / payout do vendedor
A plataforma dispara o saque da subconta; o Pix cai na chave do titular. Webhook de conclusão fecha o ciclo no backend. Guia: payouts.
7. Webhooks
Pagamento, split e saque precisam chegar assinados no seu sistema. Hub: desenvolvedores e API Pix. Teste antes: sandbox da AbacatePay.
8. Relatório / extrato por recebedor
Cada parte do split vira linha no extrato (plataforma e subconta). Conciliação sem planilha paralela.
Split automático × transferência manual
| Critério | Split automático | Transferência manual |
|---|---|---|
| Quando o dinheiro chega | Na hora em que o Pix é pago, em cada subconta | Depois, quando alguém transfere na mão |
| Risco de erro | Baixo: a regra vai na cobrança | Alto: planilha, chave errada, atraso |
| Quem paga a taxa do Pix | Sua parte (R$ 0,80); o split em si é R$ 0 | Você paga Pix de recebimento e depois cada repasse |
| Rastreio no extrato | Linha de split por recebedor e cobrança | Depende do que você anotar fora do gateway |
Em quais meios o split funciona hoje
Hoje o split na AbacatePay é no Pix do checkout transparente; o split ainda não está disponível no cartão nem no boleto. Cartão existe como meio de recebimento da plataforma (/cartao, sob consulta), mas sem split confirmado neste produto. Detalhe e simulador: split de pagamento.
Como a AbacatePay resolve
Três chamadas:
- Criar subconta —
POST /v2/sub-accounts/createcom nome + CPF/CNPJ - Cobrar com splits —
POST /v2/transparents/createcommethod: PIXedata.splits - Sacar —
POST /v2/sub-accounts/withdraw→ Pix para a chave do titular; webhookstransfer.completed/transfer.failed
Até 10 subcontas por cobrança. O split custa R$ 0,00 além da taxa do Pix (R$ 0,80), que por padrão sai da parte da plataforma. A conta da plataforma exige CNPJ (MEI serve); recebedores podem ser CPF ou CNPJ. Liberação do recurso: falar com o time.
Visão de segmento: marketplaces. Visão de produto: split de pagamento. Taxas: /pricing e calculadora de taxas.
Quer split no Pix para o seu marketplace? Fale com o time.
Para quem serve além do marketplace clássico
- Apps de serviço — plataforma + profissionais no mesmo pedido: /apps
- Criadores e coprodução — divisão entre canal, produtor e plataforma: /criadores-de-conteudo e /infoprodutos
- Educação — escola, professor e parceiro na mesma cobrança: /educacao
- SaaS com parceiros — receita compartilhada por conta ou plano: /saas
O que perguntar antes de contratar
- O split roda em qual meio hoje? (na AbacatePay: Pix)
- Quantos recebedores cabem por cobrança? (até 10)
- Quem paga a taxa do Pix por padrão?
- O saque do vendedor vai para quem (chave do titular)?
- Tem webhook de pagamento, split e saque?
- A plataforma precisa de CNPJ? (sim; MEI serve)
- Dá para testar no sandbox antes de ir ao ar?
Checklist geral de gateway (não só marketplace): como escolher gateway de pagamento. Panorama local: gateway de pagamento no Brasil.
Comissão do marketplace: como calcular
Definir a regra (% da plataforma, parte do vendedor, frete fixo, quem absorve a taxa do Pix) é o passo seguinte ao checklist do gateway. Guia com exemplo de R$ 200 no Pix: comissão de marketplace: como calcular e automatizar.
Perguntas frequentes
O que um gateway de pagamento para marketplace precisa ter?
Split na cobrança, subconta por vendedor, saque para o titular, webhooks e extrato por recebedor — além de checkout em que o comprador paga uma vez. Na AbacatePay o split roda no Pix, com até 10 subcontas e sem custo extra além de R$ 0,80.
O que é split de pagamento em marketplace?
É a divisão automática de uma venda entre plataforma e vendedores quando o pagamento é confirmado. Definição curta: o que é split de pagamento.
O split funciona no cartão?
Não. Hoje o split é só no Pix. Cartão como meio da plataforma: /cartao (sob consulta).
O recebedor precisa ter conta na AbacatePay?
Não. A subconta fica dentro da conta da plataforma, com CPF ou CNPJ do recebedor. Para sacar, ele precisa de chave Pix com esse documento no banco dele.
Quantos vendedores cabem numa cobrança?
Até 10 subcontas por cobrança. A soma das partes cabe no valor da venda menos a taxa do Pix; o que sobra fica com a plataforma.
Tem custo extra para usar split?
Não. Só a taxa do Pix (R$ 0,80), que por padrão sai da parte da plataforma. O split em si é R$ 0,00.
Preciso de CNPJ para a plataforma?
Sim. A conta da plataforma na AbacatePay é para CNPJ — e MEI serve. Recebedores das subcontas podem ser CPF ou CNPJ. Detalhe: precisa de CNPJ? MEI também vale.
Como libero o split?
Fale com o time em /contato. O recurso é liberado pelo suporte; não é self-serve silencioso.
Quer split no Pix para o seu marketplace? Fale com o time.
Leia também: comissão de marketplace: como calcular · marketplaces · split de pagamento · o que é split · payouts · como escolher gateway