> ## Documentation Index
> Fetch the complete documentation index at: https://docs.z2pay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Taxas

> Como funcionam as taxas (MDR e fixo) da Z2Pay e como consultar a tabela resolvida da sua conta.

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.

<Note>
  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](/pt-BR/valores/split).
</Note>

***

## Como a taxa é composta

Toda taxa é descrita por dois campos:

<ResponseField name="percentage" type="number">
  Percentual da taxa. Exemplo: `3.99` significa **3,99%** sobre o valor da transação. Use `0` quando não há componente percentual.
</ResponseField>

<ResponseField name="fixed" type="number">
  Parcela fixa em **centavos** (inteiro). Exemplo: `350` significa **R\$ 3,50**. Use `0` quando não há componente fixo.
</ResponseField>

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.

<Warning>
  Valores monetários são **sempre inteiros em centavos**. `fixed: 350` = R\$ 3,50, nunca R\$ 350,00. Veja [Convenções](/pt-BR/convencoes).
</Warning>

***

## 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

| Método | Rota    | Descrição                                                   |
| ------ | ------- | ----------------------------------------------------------- |
| `GET`  | `/fees` | [Retorna a tabela resolvida da sua conta](/pt-BR/fees/list) |

A resposta traz Pix, boleto, cartão de 1x a 12x, saque, estorno e chargeback (taxa e multa), cada um
com `percentage` e `fixed`.

<Warning>
  **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.
</Warning>

***

## Veja também

<CardGroup cols={2}>
  <Card title="Referência: Fees" href="/pt-BR/fees" icon="percent">
    Detalhe técnico do endpoint de taxas.
  </Card>

  <Card title="Split" href="/pt-BR/valores/split" icon="split">
    Como dividir valores entre recebedores e injetar a taxa de plataforma.
  </Card>

  <Card title="Visão geral de valores" href="/pt-BR/valores/visao-geral" icon="coins">
    Como a Z2Pay calcula taxas, splits e liquidação.
  </Card>

  <Card title="Liquidação" href="/pt-BR/valores/liquidacao" icon="banknote">
    Quando e como os valores líquidos caem na sua carteira.
  </Card>
</CardGroup>