Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.malga.io/llms.txt

Use this file to discover all available pages before exploring further.

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:
ProvedorCartãoPixBoleto

​
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. 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.