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

💡

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
  }
]