> ## 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 ler as taxas da sua conta — os dois componentes de toda taxa e o valor já resolvido para você.

A **taxa** é quanto a Z2Pay cobra por operação: Pix, boleto, cartão de 1x a 12x, saque, reembolso e
chargeback. Uma única chamada devolve a tabela inteira, e cada linha traz sempre os mesmos dois
componentes — um percentual sobre o valor e uma parcela fixa em centavos.

O que você recebe é o **valor efetivo da sua conta**, não a configuração bruta. As taxas são
definidas em camadas e resolvidas na ordem plataforma → conta → global antes de sair na resposta:
você não calcula precedência nem precisa saber de onde cada número veio.

<Info>
  Todas as rotas exigem o header `x-api-key` (sua chave de sandbox). Veja
  [Autenticação](/pt-BR/autenticacao). Os exemplos nas páginas de cada endpoint usam a base URL de
  sandbox `https://api.sandbox.z2pay.com/v1`.
</Info>

***

## Endpoints

Cada endpoint tem sua própria página, com os campos aceitos, exemplos e o playground para testar.

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

***

## Como ler uma taxa

Toda taxa da resposta tem os mesmos dois componentes, e eles se somam. Ler um sem o outro dá o
número errado — uma venda de R\$ 100,00 com `percentage: 3.99` e `fixed: 350` custa R\$ 7,49, não
R\$ 3,99.

| Componente   | O que é                                       | Exemplo                  |
| ------------ | --------------------------------------------- | ------------------------ |
| `percentage` | Percentual aplicado sobre o valor da operação | `3.99` significa 3,99%   |
| `fixed`      | Parcela fixa, em centavos                     | `350` significa R\$ 3,50 |

### Três detalhes que mudam a leitura

<Note>
  **`creditCard` sempre traz 12 itens,** de 1x a 12x, mesmo que sua conta não opere com todas as
  parcelas. Não conte com a posição no array: procure pelo campo `installments` da parcela que você
  quer.
</Note>

<Note>
  **Taxa não configurada vem como `0`, não ausente.** O campo existe na resposta com valor zero, o
  que significa "sem cobrança configurada" — e não "informação indisponível".
</Note>

<Note>
  **A taxa é resolvida por moeda.** Sem uma configuração específica para a moeda pedida, vale a taxa
  que não distingue moeda. Hoje o único valor aceito é `BRL` (veja
  [Convenções](/pt-BR/convencoes)).
</Note>

***

## Veja também

<CardGroup cols={2}>
  <Card title="Conceito de Taxas" icon="percent" href="/pt-BR/valores/taxas">
    Como as taxas são modeladas e resolvidas por precedência.
  </Card>

  <Card title="Liquidação" icon="banknote" href="/pt-BR/valores/liquidacao">
    Como a taxa entra no cálculo do valor líquido a receber.
  </Card>

  <Card title="Split" icon="split" href="/pt-BR/valores/split">
    Quem paga a taxa quando o valor é dividido entre recebedores.
  </Card>

  <Card title="Chargebacks" icon="gavel" href="/pt-BR/chargebacks">
    Onde a taxa e a multa de chargeback são cobradas.
  </Card>
</CardGroup>