Skip to main content
As taxas da Z2Pay têm dois componentes que se somam: um percentual (o famoso MDR) e uma parcela fixa em centavos. Cada método de pagamento (Pix, boleto, cartão por parcela) tem sua própria taxa, além de taxas para saque, reembolso e chargeback.
Esta página é conceitual + referência do endpoint de consulta. Para entender como a taxa de plataforma entra na divisão de valores, veja Split.

​
Como a taxa é composta

Toda taxa é descrita por dois campos:
​
number
Percentual da taxa. Exemplo: 3.99 significa 3,99% sobre o valor da transação. Use 0 quando não há componente percentual.
​
number
Parcela fixa em centavos (inteiro). Exemplo: 350 significa R$ 3,50. Use 0 quando não há componente fixo.
Os dois componentes se somam. Uma taxa de cartão com percentage: 3.99 e fixed: 0 cobra apenas 3,99% do valor. Uma taxa de boleto com percentage: 0 e fixed: 350 cobra R$ 3,50 fixos por boleto, independente do valor.
Valores monetários são sempre inteiros em centavos. fixed: 350 = R$ 3,50, nunca R$ 350,00. Veja Convenções.

​
Taxas resolvidas por conta

A tabela retornada pela API entrega o valor efetivo já resolvido para a sua conta. Você consulta a taxa final que se aplica às suas transações — sem precisar saber de onde ela vem nem combinar regras.
  • Quando uma taxa específica não está configurada, ela cai em 0 (percentual e fixo).
  • A taxa é por moeda (ISO 4217). Hoje o único valor aceito é BRL; sem o parâmetro currency, a API usa a moeda padrão da sua conta.

​
Consultar as suas taxas

A resposta traz Pix, boleto, cartão de 1x a 12x, saque, estorno e chargeback (taxa e multa), cada um com percentage e fixed.
Não existe tabela oficial de taxas — nem aqui, nem em lugar nenhum da documentação. As taxas são configuradas por conta, negociadas comercialmente, e a única fonte da verdade das suas é a resposta de GET /fees para a sua conta. Leia da API a cada consulta; percentual chumbado no código passa a cobrar errado no dia em que a sua tabela for renegociada, sem nada avisar.

​
Veja também

Referência: Fees

Detalhe técnico do endpoint de taxas.

Split

Como dividir valores entre recebedores e injetar a taxa de plataforma.

Visão geral de valores

Como a Z2Pay calcula taxas, splits e liquidação.

Liquidação

Quando e como os valores líquidos caem na sua carteira.