Introdução
Divida automaticamente os valores de uma transação entre múltiplos recebedores com segurança, rastreabilidade e controle total sobre a taxa transacional, com nota fiscal de serviço emitida pela Safe2Pay para o responsável pelo pagamento da taxa. Ideal para marketplaces, plataformas SaaS, apps de serviços e gateways white-label.
Esse mecanismo está disponível apenas para contas do tipo Marketplace.
O que é o split de pagamento?
O split permite que uma única transação seja automaticamente distribuída entre diferentes contas (Subconta), de forma transparente e programável.
Você pode dividir:
- Por percentual ou valor fixo;
- Entre a conta principal e uma ou mais subcontas;
- Com ou sem responsabilidade de taxas para cada recebedor.
Como funciona
Ao criar uma transação (via Cartão, Boleto ou Pix), você pode incluir um array Splits
com as instruções de repasse.
Cada item define:
- Quem é o recebedor
IdReceiver
; - Quanto ele receberá
Amount
; - Se o valor será fixo ou percentual
CodeTaxType
; - Se o recebedor arca com as tarifas da transação
IsPayTax
.
Formas de configurar
Split vs Tarifas — O que cada um controla?
Split: quem recebe quanto
O Split determina como o valor da transação será distribuído.
Você pode:
- Dividir por valor fixo ou percentual;
- Definir a regra diretamente na Subconta (split estático) ou na transação (split dinâmico);
- Incluir vários recebedores, desde que estejam vinculados ao seu marketplace;
- Garantir que a soma total dos splits seja igual ao valor da cobrança.
O Split apenas define a distribuição do valor bruto. A responsabilidade pelos custos da transação é tratada separadamente.
Tipos de split
Tipo | Descrição |
---|---|
Split estático (por subconta) | Definido no cadastro ou atualização da Subconta. Aplicado automaticamente a cada transação. |
Split dinâmico (por transação) | Enviado via API junto com a transação. Permite personalização total por operação, exceto para configuração de repasse de taxa, caso a origem da geração da transação seja a Subconta. |
Os dois tipos de split podem ser usados em conjunto. O split dinâmico não sobrepõe o estático, ambos são executados de forma acumulativa.
Isso permite, por exemplo, que a Subconta receba seu percentual padrão via split estático, e o marketplace direcione um valor adicional via split dinâmico para outro parceiro na mesma transação.
Tudo que é configurado no split estático será exibido como taxa para Subconta.
Tarifas: quem arca com os custos da transação
O campo IsPayTax
define quem será responsável por pagar as tarifas cobradas pela Safe2Pay (ex: taxa do cartão, boleto, pix).
Como funciona:
IsPayTax
: true ➡️ o recebedor arca com os custos referentes à sua parte;IsPayTax
: false ➡️ a conta principal assume o custo total da transação.
O campo
IsPayTax
é individual por recebedor, permitindo que cada um tenha valores líquidos distintos, mesmo com valores de split iguais.
Exemplo de payload com split dinâmico
"Splits": [
{
"IdReceiver": 123456, // ID da conta recebedora do split
"CodeTaxType": 1, // 1 = Percentual, 2 = Valor fixo
"Amount": 80.00, // Valor do split
"IsPayTax": true // Subconta arca com as tarifas
},
{
"IdReceiver": 654321,
"CodeTaxType": 1,
"Amount": 20.00,
"IsPayTax": false // Conta principal arca com as tarifas
}
]
Updated 22 days ago