As taxas são configuradas por escopo e resolvidas na ordem plataforma → company → global. Quando
nada foi configurado, o valor cai em
0. A resposta entrega sempre o valor efetivo para a sua
conta, já resolvido. Entenda o modelo em Valores · Taxas.Como ler uma taxa
Toda taxa tem dois componentes:percentage
Percentual aplicado sobre o valor.
3.99 significa 3,99%.fixed
Parcela fixa em centavos (inteiro).
350 significa R$ 3,50.BRL, USD, …). A taxa é resolvida por moeda; sem override
específico para a moeda pedida, cai na taxa moeda-agnóstica configurada.
Endpoints
| Método | Rota | Descrição |
|---|---|---|
GET | /fees | Tabela de taxas resolvida da conta |
x-api-key. Veja Autenticação.
Consultar a tabela de taxas
Parâmetros de query
Código da moeda em ISO 4217, exatamente 3 letras (ex:
BRL). É normalizado para maiúsculas
automaticamente, então brl e BRL funcionam igual.Opcional. Quando omitido, usa a moeda padrão da sua company. Se a company também não tiver moeda
padrão configurada, o fallback é BRL.Exemplo de requisição
Resposta
200 OK
Os números acima são ilustrativos. As taxas reais dependem da configuração da sua conta — sempre leia
da resposta da API, nunca chumbe valores no seu código.
Campos da resposta
Moeda das taxas retornadas (ISO 4217). Reflete o
currency da query, a moeda padrão da company, ou
BRL como último fallback.Taxa do método pix.
Taxa do método boleto, com os mesmos atributos
percentage e fixed.Lista com uma entrada por parcela, sempre de 1x até 12x (12 itens).
Taxa de saque/payout (
percentage + fixed).Taxa de reembolso (
percentage + fixed).Taxas associadas a chargeback.
Erros
Esse endpoint requer autenticação por API Key. Erros comuns:401—x-api-keyausente ou inválida. Veja Autenticação.
Veja também
Conceito de Taxas
Como as taxas são modeladas e resolvidas por precedência.
Liquidação
Como as taxas impactam o valor líquido a receber.
Split
Divisão de valores entre recebedores.
Autenticação
Como gerar e enviar sua API Key.

