Configurações gerais e recomendações para uso do Split
Utilizando a funcionalidade de Split, você pode criar um pedido que terá mais de um recebedor. Tais recebedores terão acesso a parte do valor da compra. Cada pedido na Pagar.me pode ser informados os valores ou as porcentagens que serão destinados a cada um dos recebedores.
Regras de Negócio
Divisão de valores no Split
É importante observar como os valores são divididos em um sistema de Split:
O valor principal (Amount principal) deve ser um número decimal. No entanto, o Amount de cada recebedor deve ser um número inteiro, uma vez que não se permite valores fracionados no Split.
Exemplo:
Suponhamos que precisamos dividir R$ 1,25 entre dois recebedores, a divisão de R$ 1,25 por dois resultaria em R$ 0,625 para cada recebedor, o que multiplicado por 100, não é um número inteiro. Portanto, precisamos ajustar o Amount de cada recebedor para ser um número inteiro.
Logo
Recebedor 1: R$ 0,62 multiplicado por 100 resulta em 62.
Recebedor 2: R$ 0,63 multiplicado por 100 resulta em 63.
Observação
Como não é permitido ter valores fracionados no Split, todos os valores no Amount do recebedor devem ser multiplicados por 100. Por exemplo, se tivermos R$ 9,34, multiplicamos por 100 para obteremos o número 934, que é o valor a ser usado no recebedor.
Configuração dos indicadores
Os campos changeProcessingFee
, chargeRemainderFee
e liable
devem ser configurados como true
em ao menos UM (1) recebedor. Pois esses campos, configuram a responsabilidade de cada recebedor nessa transação.
Caso não seja configura em nenhum, a transação irá falhar.
changeProcessingFee
changeProcessingFee
Indica se o recebedor vinculado à regra será cobrado pelas taxas da transação. Assim, ao menos um dos recebedores deve ter esse parâmetro true, mas também é possível configurar ambos como true
. Nesse último caso, as taxas serão divididas de acordo com o split previamente aplicado. Lembrando que a configuração do charge_processing_fee
vale apenas para as taxas percentuais de uma transação. As taxas fixas (gateway e antifraude) serão sempre cobradas do recebedor principal, ou seja, do Markeplace.
chargeRemainderFee
chargeRemainderFee
É usado para a seguinte situação:
Quando é feita a divisão das taxas de uma regra de split, é possível que, pela questão da divisão ser feita percentualmente (mesmo que a regra tenha sido estabelecida por Amount), haja um, ou alguns, centavos restantes, que ficam "à deriva", não sendo atribuídos para nenhum dos recebedores. Por padrão, cobramos esse "restante" do recebedor principal. No entanto, é possível inserir o parâmetro charge_remainder_fee
como true
para o recebedor do qual deseja que seja cobrado.
liable
liable
Indica se o recebedor atrelado assumirá os riscos de chargeback da transação. Ou seja, no caso de haver um chargeback em alguma transação, este será debitado do recebedor que tiver configurado como true
. Assim, ao menos um dos recebedores deve ter esse parâmetro true
, mas também é possível configurar ambos como true
. Nesse último caso, o débito referente ao chargeback será dividido conforme o split previamente aplicado.
Caso se escolha que todos os recebedores estejam como "true" será dividido igualmente, Caso for escolhido somente um recebedor responsável pela variáveis, as taxas e chagerback será somente cobrado deste recebedor.
Soma dos valores dos campos Amount nos recebedores
Existem duas (2) formas de realizar a divisão dos valores para os recebedores, via flat
ou percentage
. A forma de divisão escolhida deve ser configurada no campo SplitType
em cada recebedor, e deve ser a mesma para todos. Caso contrario, poderá dar erro na aplicação.
Para o caso de percentage
a SOMA da divisão nos campos Amount em cada recebedor deve ser igual a 100 (100%).
Para o caso de flat
, a SOMA deve ser igual ao valor do Amount principal informado na transação.
Se as regras de Split não forem enviadas no fluxo transacional, a liquidação da transação será destinada ao recebedor principal referente ao Stone Code configurado na rota de Ativação.
Cancelamento com Split
Para cancelamento TOTAL da transação, não é necessário o envio dos campos de Split.
No ambiente Pagar.me, ainda não tem transações em voucher
Bandeira suportadas no ambiente pagar.me!
- Visa
- Master
- Elo
- Amex
- Hiper