> ## 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. # Tabela de taxas da conta > Retorna a tabela de taxas da sua conta, opcionalmente para uma moeda específica. `GET /fees` Faz parte do recurso [Fees](/pt-BR/fees) — como ler cada taxa e o significado de cada campo estão lá. Retorna a tabela de taxas vigente para a sua conta. Não é uma listagem paginada: a resposta é um único objeto, com uma entrada por método de pagamento. **Leia sempre da resposta; nunca chumbe valores no seu código.** As taxas são configuradas por conta e negociadas comercialmente — o exemplo abaixo é ilustrativo, não uma tabela oficial. Quando uma taxa não foi configurada, ela resolve para `0` (percentual e fixo), o que é indistinguível de uma taxa realmente zerada. ## Exemplo ```bash theme={null} # Usando a moeda padrão da conta curl https://api.sandbox.z2pay.com/v1/fees -H "x-api-key: SUA_CHAVE_DE_SANDBOX" ``` ```bash theme={null} # Forçando uma moeda específica curl "https://api.sandbox.z2pay.com/v1/fees?currency=BRL" -H "x-api-key: SUA_CHAVE_DE_SANDBOX" ``` ```json theme={null} { "currency": "BRL", "pix": { "percentage": 0.99, "fixed": 0 }, "boleto": { "percentage": 0, "fixed": 350 }, "creditCard": [ { "installments": 1, "percentage": 3.99, "fixed": 0 }, { "installments": 2, "percentage": 4.49, "fixed": 0 }, { "installments": 3, "percentage": 4.99, "fixed": 0 }, { "installments": 12, "percentage": 6.99, "fixed": 0 } ], "withdrawal": { "percentage": 0, "fixed": 367 }, "refund": { "percentage": 0, "fixed": 0 }, "chargeback": { "fee": { "percentage": 0, "fixed": 0 }, "penalty": { "percentage": 0, "fixed": 0 } } } ``` ## OpenAPI ````yaml openapi/psp.json GET /fees openapi: 3.0.3 info: title: Z2Pay PSP API version: 1.0.0 description: API pública do PSP — autenticação via API Key (Credential) servers: - url: https://api.sandbox.z2pay.com/v1 description: Sandbox - url: https://api.z2pay.com/v1 description: Produção security: [] tags: - name: Cards description: Cartões salvos de um cliente - name: Chargebacks description: Gerenciamento de chargebacks - name: Customers description: Gerenciamento de clientes (compradores) - name: Fees description: Tabela de taxas da conta (pix, boleto, cartão, saque, refund, chargeback) - name: Recipients description: Gerenciamento de recebedores (sellers/merchants que recebem repasses) - name: Refunds description: Gerenciamento de reembolsos e estornos - name: Splits description: Regras de divisão do valor de uma venda entre recebedores - name: Transactions description: Gerenciamento de transações e payments - name: Wallets description: Saldo, extrato e resumo da carteira de um recebedor, agrupados por moeda - name: Webhooks description: Configuração, gerenciamento e histórico de entregas de webhooks - name: Withdrawals description: Solicitação e acompanhamento de saques (payouts) por recipient paths: /fees: get: tags: - Fees summary: Tabela de taxas da conta description: >- Retorna as taxas resolvidas da company (pix, boleto, cartão 1-12x, saque, refund e chargeback), em percentual e valor fixo (centavos). Aceita ?currency (default: moeda da company). operationId: FeesController_get parameters: - name: currency in: query required: false description: >- Moeda no padrão ISO 4217. Hoje o único valor aceito é 'BRL'. Omitida, usa a moeda padrão da sua conta. schema: type: string enum: - BRL description: >- Moeda no padrão ISO 4217. Hoje o único valor aceito é 'BRL'. Omitida, usa a moeda padrão da sua conta. responses: '200': description: Taxas da conta content: application/json: schema: type: object properties: currency: type: string description: >- Moeda das taxas (ISO 4217). Sem `currency` na query, é a moeda padrão da conta. pix: type: object properties: percentage: type: number description: >- Componente percentual. `3.99` é 3,99% sobre o valor. `0` quando não há. fixed: type: integer description: >- Componente fixo, em centavos. `350` é R$ 3,50. `0` quando não há. required: - percentage - fixed description: Taxa do Pix. boleto: type: object properties: percentage: type: number description: >- Componente percentual. `3.99` é 3,99% sobre o valor. `0` quando não há. fixed: type: integer description: >- Componente fixo, em centavos. `350` é R$ 3,50. `0` quando não há. required: - percentage - fixed description: Taxa do boleto. creditCard: type: array items: type: object properties: percentage: type: number description: >- Componente percentual. `3.99` é 3,99% sobre o valor. `0` quando não há. fixed: type: integer description: >- Componente fixo, em centavos. `350` é R$ 3,50. `0` quando não há. installments: type: integer description: Número de parcelas a que a taxa se aplica. required: - percentage - fixed - installments description: >- Taxa de cartão por parcela — sempre 12 entradas, de 1x a 12x. withdrawal: type: object properties: percentage: type: number description: >- Componente percentual. `3.99` é 3,99% sobre o valor. `0` quando não há. fixed: type: integer description: >- Componente fixo, em centavos. `350` é R$ 3,50. `0` quando não há. required: - percentage - fixed description: Taxa de saque. refund: type: object properties: percentage: type: number description: >- Componente percentual. `3.99` é 3,99% sobre o valor. `0` quando não há. fixed: type: integer description: >- Componente fixo, em centavos. `350` é R$ 3,50. `0` quando não há. required: - percentage - fixed description: Taxa de estorno. chargeback: type: object properties: fee: type: object properties: percentage: type: number description: >- Componente percentual. `3.99` é 3,99% sobre o valor. `0` quando não há. fixed: type: integer description: >- Componente fixo, em centavos. `350` é R$ 3,50. `0` quando não há. required: - percentage - fixed description: Taxa cobrada por chargeback. penalty: type: object properties: percentage: type: number description: >- Componente percentual. `3.99` é 3,99% sobre o valor. `0` quando não há. fixed: type: integer description: >- Componente fixo, em centavos. `350` é R$ 3,50. `0` quando não há. required: - percentage - fixed description: Multa cobrada por chargeback. required: - fee - penalty description: Taxas relacionadas a chargeback. required: - currency - pix - boleto - creditCard - withdrawal - refund - chargeback description: >- Taxas já resolvidas para a sua conta. Taxa não configurada vem com `percentage` e `fixed` em `0` — é a resposta desta rota, e não uma tabela publicada, que vale para a sua conta. example: currency: BRL pix: percentage: 0.99 fixed: 0 boleto: percentage: 1.99 fixed: 350 creditCard: - installments: 1 percentage: 3.99 fixed: 49 - installments: 2 percentage: 4.49 fixed: 49 - installments: 3 percentage: 4.99 fixed: 49 - installments: 4 percentage: 5.49 fixed: 49 - installments: 5 percentage: 5.99 fixed: 49 - installments: 6 percentage: 6.49 fixed: 49 - installments: 7 percentage: 6.99 fixed: 49 - installments: 8 percentage: 7.49 fixed: 49 - installments: 9 percentage: 7.99 fixed: 49 - installments: 10 percentage: 8.49 fixed: 49 - installments: 11 percentage: 8.99 fixed: 49 - installments: 12 percentage: 9.49 fixed: 49 withdrawal: percentage: 0 fixed: 367 refund: percentage: 0 fixed: 0 chargeback: fee: percentage: 0 fixed: 1500 penalty: percentage: 0 fixed: 0 '400': description: >- Requisição inválida — algum parâmetro ou campo do corpo não passou na validação content: application/json: schema: type: object properties: error: type: object properties: code: type: string description: >- Identificador estável do erro. É por ele que você deve ramificar, não pela mensagem. message: type: string description: >- Descrição legível. Pode mudar sem aviso e não deve ser usada em condicional. issues: type: array description: >- Um item por campo rejeitado. Nunca vem vazio: se há 400 de validação, há pelo menos um. items: type: object properties: path: type: string description: >- Campo que falhou. Vem vazio quando o erro é do corpo como um todo. message: type: string description: O que há de errado com esse campo. example: error: code: VALIDATION_ERROR message: Validation failed issues: - path: status message: >- Status inválido. Valores aceitos: pending, waiting_payment, paid, refused, canceled, refunded - path: startDate message: >- Data deve ser ISO 8601 com timezone (ex.: 2026-06-24T00:00:00Z) '401': description: Chave de API ausente, malformada ou inválida content: application/json: schema: type: object properties: error: type: object properties: code: type: string description: >- Identificador estável do erro. É por ele que você deve ramificar, não pela mensagem. message: type: string description: >- Descrição legível. Pode mudar sem aviso e não deve ser usada em condicional. example: error: code: UNAUTHORIZED message: Invalid API key security: - apiKey: [] components: securitySchemes: apiKey: type: apiKey in: header name: x-api-key description: API Key da Credential (gerada no Backoffice) ````