(platform-fee) permite que intermediadores — marketplaces, SaaS de pagamentos e plataformas B2B — configurem uma comissão persistente sobre as transações dos seus sellers. Em vez de incluir a própria conta nas splitRules de cada cobrança, a plataforma define a taxa uma vez na subconta e a Malga aplica automaticamente antes de distribuir o valor restante entre os recebedores.
O
platform-fee é uma camada sobre o split de provedor. Ele só se aplica quando a cobrança tem splitRules. Transações sem splitRules não sofrem desconto de taxa.Como funciona
A taxa da plataforma é simples de configurar e opera em dois níveis:- Ativação: Uma flag no merchant habilita ou desabilita a aplicação das taxas. Enquanto desativada, nenhuma regra é aplicada nas transações, dando total controle sobre quando começar a cobrar.
- Regras por método de pagamento: Cada regra define a taxa para um método específico (
credit,pix,boleto). Para cartão de crédito, as regras são configuradas por faixa de parcelamento.
splitRules e a subconta tem platformFee configurado, a Malga executa o seguinte antes de enviar ao provedor:
- Calcula o valor da taxa sobre o montante bruto da transação
- Subtrai esse valor para obter o valor líquido
- Distribui o valor líquido entre os sellers declarados nas
splitRules - O valor não declarado nos
splitRulesvai para a conta da plataforma
Configurando as regras
As regras são configuradas no nível da subconta via API. Cada regra define o método de pagamento e o valor da taxa — em percentual, valor fixo ou ambos combinados. Para cartão de crédito, as regras são configuradas por faixa de parcelamento.| Campo | Descrição |
|---|---|
paymentMethod | Método ao qual a regra se aplica: credit, pix, boleto ou default (fallback). |
percentage | Percentual da taxa (0-100), com até 2 casas decimais. |
fixedAmount | Valor fixo em centavos. Pode coexistir com percentage na mesma regra. |
installment | Número de parcelas. Obrigatório para credit; proibido nos demais métodos. Agrupado em faixas: à vista (1), 2x-6x, 7x-12x, 13x-24x. Apenas uma regra por faixa é permitida. |
A regra
default funciona como fallback: aplica-se quando não há regra específica para o método da transação. Se nenhuma regra default estiver configurada e não houver regra para o método, o platform-fee não é aplicado.Estornos
Em estornos totais ou parciais, oplatform-fee é revertido proporcionalmente ao valor estornado.
Exemplo:
- transação de R 20,00, seller recebeu R$ 980,00).
- Estorno parcial de R$ 500,00:
- Plataforma devolve: R$ 10,00
- Seller devolve: R$ 490,00