
Introdução ao Split de Pagamentos
O split de pagamentos é essencial para plataformas que conectam compradores e vendedores — marketplaces, software houses, franquias e qualquer modelo de negócio com múltiplos recebedores.
O que é split de pagamentos?
Split é a divisão automática do valor de uma transação entre diferentes contas no momento do pagamento. Em vez de receber 100% do valor e repassar manualmente, a Alfasu Pay distribui os valores conforme regras pré-configuradas.
Casos de uso comuns
Marketplaces
Um cliente compra um produto de R$ 100. A plataforma retém 10% (R$ 10) e o vendedor recebe R$ 90 — tudo de forma automática e instantânea após a confirmação do Pix.
Software houses
Sua aplicação cobra o cliente final, mas parte da receita vai para o parceiro que indicou o negócio ou para a licença do software base.
Franquias
A matriz recebe royalties e taxas de franquia automaticamente a cada venda realizada pela unidade.
Como funciona na Alfasu Pay
- Cadastre os recebedores (subcontas) no painel
- Defina as regras de split (percentual ou valor fixo)
- Inclua o array
splitsna criação da cobrança - O repasse acontece automaticamente após a confirmação
{
"amount": 10000,
"splits": [
{ "recipient_id": "rec_vendedor", "percentage": 90 },
{ "recipient_id": "rec_plataforma", "percentage": 10 }
]
}
Atenção
A soma dos percentuais deve ser exatamente 100%. Requisições com valores incorretos retornam erro 422.
Vantagens
- Conformidade: repasses rastreáveis e auditáveis
- Agilidade: sem transferências manuais entre contas
- Transparência: cada recebedor vê seu extrato no painel
Para implementar, consulte a documentação de split na área de desenvolvedor ou fale com nosso time comercial.