O Split de Pagamentos é um serviço que divide recebíveis de maneira automática, entre duas ou mais partes envolvidas em uma transação,
usado por marketplaces, franquias, aplicativos de delivery, entre outros tipos de negócios que têm a necessidade de
fazer a divisão de recebíveis.
Métodos de pagamento suportados
Os métodos de pagamento suportados pelo serviço de split são:
Recebedores do Split
Os recebedores (sellers) precisam estar cadastrados antes de aparecer em splitRules. Na cobrança direta e na criação da sessão com split, os identificadores de seller informados devem corresponder a recebedores já existentes. O serviço de sessions valida essa existência ao criar a sessão; no fluxo da transação, a Malga trata o encadeamento com o provedor e o status do seller para a captura.
Para cadastro e gestão, veja Recebedor (seller) e a API de sellers.
Dois modos de uso do split
O split pode ser utilizado de duas formas; em ambas, cada regra referencia um sellerId válido.
1. Cobrança direta (POST /v1/charges)
Você envia splitRules no corpo da criação da cobrança. A Malga aplica essas regras nessa transação. Guia completo: Cobrança com Split.
2. Sessão ou link de pagamento
Você envia splitRules ao criar a sessão (POST /v1/sessions). As regras ficam armazenadas na sessão. No pagamento (POST /v1/sessions/{id}/charge), você não reenvia splitRules; a cobrança herda o split definido na sessão. Detalhes e exemplos: Split em sessão ou link de pagamento.
Em pagamento de sessão, não inclua splitRules no corpo da requisição de cobrança. Configure o split apenas na criação da sessão.
