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

# Consultar Taxas

> Retorna as taxas de processamento configuradas para sua conta

## Consultar taxas

```
GET /api/user/fees
```

**Autenticação**: Bearer Token (JWT)

Retorna as taxas configuradas para a conta do merchant — taxa fixa (em centavos) + percentual variável + percentual de reserva, para cada método de pagamento.

### Exemplo

```bash theme={null}
curl --request GET \
  --url https://upay-sistema-api.onrender.com/api/user/fees \
  --header 'Authorization: Bearer SEU_JWT_TOKEN'
```

### Resposta (`200 OK`)

```json theme={null}
{
  "success": true,
  "data": {
    "userId": "550e8400-e29b-41d4-a716-446655440000",
    "pix": {
      "fixed": "2,99",
      "variable": "3,99",
      "reserve": "0,50",
      "fixedCents": 299,
      "variablePercent": 3.99,
      "reservePercent": 0.50
    },
    "boleto": {
      "fixed": "4,38",
      "variable": "4,50",
      "reserve": "0,50",
      "fixedCents": 438,
      "variablePercent": 4.50,
      "reservePercent": 0.50
    },
    "card": {
      "fixed": "3,99",
      "variable": "5,99",
      "reserve": "0,50",
      "fixedCents": 399,
      "variablePercent": 5.99,
      "reservePercent": 0.50,
      "installments": {
        "2": "14,99",
        "3": "16,49",
        "12": "29,99"
      }
    },
    "isDefault": true
  },
  "message": "Taxas padrão retornadas - usuário não possui taxas configuradas"
}
```

| Campo                          | Descrição                                              |
| ------------------------------ | ------------------------------------------------------ |
| `fixed` / `fixedCents`         | Taxa fixa por transação (formato BR / em centavos)     |
| `variable` / `variablePercent` | Taxa percentual sobre o valor bruto                    |
| `reserve` / `reservePercent`   | Percentual de reserva retido por período               |
| `installments`                 | Taxas por número de parcelas (1×–12×) — apenas cartão  |
| `isDefault`                    | `true` quando a conta ainda não tem taxas customizadas |

<Note>
  A taxa total de uma transação é: `taxa_fixa + (valor × variablePercent / 100) + (valor × reservePercent / 100)`. O `netAmountCents` creditado na carteira é o valor bruto menos essa soma.
</Note>

<Card title="Consultar saldo" icon="wallet" href="./get" horizontal>
  Verifique o saldo disponível e a liberar.
</Card>