Sobretaxa

O campo IsSubaccountTaxPayer define quem paga a taxa da Safe2Pay, recebe a NFS-e e, por consequência, o que o valor em Tax representa:

`IsSubaccountTaxPayer`	Paga a taxa e recebe a NFS-e	O que vai em `Tax`
`true`	a subconta	somente a sua sobretaxa
`false`	você, marketplace	a taxa da Safe2Pay mais a sua sobretaxa

O campo TaxTypeName define o tipo da taxa, e não o meio de pagamento:

`TaxTypeName`	Tipo	Usado em
`"1"`	percentual	crédito, antecipação
`"2"`	valor em reais	boleto, PIX e os serviços abaixo

ℹ️
Quando a Safe2Pay não cobra taxa de você em determinado meio de pagamento ou serviço, não é possível cobrar sobretaxa da subconta. Informe "Tax": "0" ou não envie o item.

❗
A API (https://api.safe2pay.com.br/v2) responde HTTP 200 mesmo em caso de erro. Sempre verifique o campo HasError do corpo da resposta.

O que é recusado na configuração de sobretaxa

Taxa do tipo percentual, ou mais de uma taxa, no repasse (código 26) e na nota fiscal de serviço (código 23);

Sobretaxa negativa no repasse quando a subconta paga a taxa ("IsSubaccountTaxPayer": true);
No repasse com "IsSubaccountTaxPayer": false, valor menor que a taxa cobrada pela Safe2Pay;
Sobretaxa em qualquer meio de pagamento ou serviço no qual você não paga taxa à Safe2Pay;
Meio de pagamento ou serviço repetido no array, e tipo de taxa repetido dentro de um mesmo meio;
Meio de pagamento ou serviço que não esteja habilitado na sua conta.

Serviços

Além dos meios de pagamento, a subconta pode ter serviços cobrados à parte, configurados no mesmo objeto MerchantSplit e com o mesmo formato. Um serviço só pode ser configurado na subconta se estiver habilitado na sua conta. O código de cada um está na tabela ao final desta página.

Repasse

Transferência do saldo da subconta para a conta bancária dela. A taxa é cobrada apenas nas subcontas com frequência de repasse diária e semanal, repasses mensais não têm cobrança e, por isso, não geram sobretaxa.

⚠️
Repasse

Se você não informar o código 26, a subconta recebe a configuração padrão: A subconta paga a taxa de repasse da Safe2Pay e não há sobretaxa;

Aceita uma única taxa, sempre do tipo valor ("TaxTypeName": "2"). Percentual não é aceito;

Com "IsSubaccountTaxPayer": true, a subconta paga a taxa da Safe2Pay e o valor em Tax é somente a sua sobretaxa, podendo ser zero. Com false, você assume a taxa e o valor em Tax já a inclui, por isso não pode ser menor que ela.

Nota fiscal de serviço

Emissão de NFS-e pela subconta, cobrada por nota emitida.

⚠️
Nota fiscal

Aceita uma única taxa, sempre do tipo valor ("TaxTypeName": "2"). Percentual não é aceito;

SMS

Envio de SMS de cobrança, cobrado por mensagem enviada.

⚠️
SMS

Para repassar o custo da Safe2Pay, configure a taxa do tipo valor ("TaxTypeName": "2") e informe "Tax": "0";

Não é possível sobretaxar o envio de SMS.

Antifraude

Análise antifraude das transações, cobrada por consulta.

Assim como o SMS, configure a taxa do tipo valor ("TaxTypeName": "2") e informe "Tax": "0" para repassar apenas o custo da Safe2Pay, sem sobretaxa.

⚠️
Regras Antifraude

Para repassar o custo da Safe2Pay, configure a taxa do tipo valor ("TaxTypeName": "2") e informe "Tax": "0";

Não é possível sobretaxar o envio de SMS.

ℹ️
A tabela completa de métodos de pagamento e serviços pode ser vista aqui.