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

# Fees

> Consulta y configuración de comisiones.

El módulo Fees permite consultar y crear configuraciones de comisiones para el business autenticado.

Fees v3 mantiene el mismo contrato de request y response que v2. Obtén un token con [POST /v3/auth/login](https://docs.mesadepagos.com/v3/auth.md) y envía `Authorization: Bearer {accessToken}` en cada request.

## Consultar Fees

```http theme={null}
GET /v3/fees
```

### Query Params

| Parámetro | Requerido | Valores |
| - | - | - |
| `type` | No | `FIXED`, `PERCENTAGE` |
| `pair` | No | Par soportado, por ejemplo `USDC/BOB` |
| `transactionType` | No | Tipos de transacción soportados |
| `status` | No | `CURRENT`, `OLD` |

Usa `status=CURRENT` para consultar las configuraciones vigentes o `status=OLD` para los valores anteriores. Si omites `status`, se devuelven ambos estados. Los pares y tipos de transacción aceptados están listados en la [referencia API](https://docs.mesadepagos.com/v3/api-reference/fees/consultar-fees.md). Una consulta exitosa devuelve HTTP `200`.

### Response

```json theme={null}
[
  {
    "pair": "USDC/BOB",
    "transactionType": "withdrawal_express",
    "amount": 0.5,
    "feeType": "PERCENTAGE",
    "status": "CURRENT",
    "createdBy": "Partner User",
    "validUntil": null,
    "supersededBy": null,
    "predecessor": null
  }
]
```

## Crear Fee

```http theme={null}
POST /v3/fees
```

Los cuatro campos son obligatorios. `amount` debe ser un número mayor o igual a cero; usa `type` para elegir `FIXED` o `PERCENTAGE`. Un request exitoso devuelve HTTP `201`.

```json theme={null}
{
  "pair": "USDC/BOB",
  "transactionType": "withdrawal_express",
  "amount": 0.5,
  "type": "PERCENTAGE"
}
```

### Response

```json theme={null}
{
  "pair": "USDC/BOB",
  "transactionType": "withdrawal_express",
  "amount": 0.5,
  "feeType": "PERCENTAGE",
  "status": "CURRENT",
  "createdBy": "Partner User"
}
```

## Tipos de Fee

| Tipo | Descripción |
| - | - |
| `PERCENTAGE` | Se aplica sobre el tipo de cambio. |
| `FIXED` | Se aplica sobre el monto total. |

Para el mismo par, tipo de transacción y tipo de fee, enviar un monto diferente actualiza el fee vigente y conserva el valor anterior con estado `OLD`. Enviar el mismo monto mantiene la configuración actual.

Consulta la [referencia API de creación de fees](https://docs.mesadepagos.com/v3/api-reference/fees/crear-fee.md) para el esquema completo. Los parámetros de consulta o campos inválidos devuelven HTTP `400`; un token ausente, inválido o expirado devuelve HTTP `401`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.