> ## 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

> Retrieve and configure fees.

The Fees module retrieves and creates fee configurations for the authenticated business.

Fees v3 uses the same request and response contract as v2. Get a token with [POST /v3/auth/login](https://docs.mesadepagos.com/en/v3/auth.md) and send `Authorization: Bearer {accessToken}` with every request.

## Retrieve Fees

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

### Query Parameters

| Parameter | Required | Values |
| - | - | - |
| `type` | No | `FIXED`, `PERCENTAGE` |
| `pair` | No | Supported currency pair, for example `USDC/BOB` |
| `transactionType` | No | Supported transaction types |
| `status` | No | `CURRENT`, `OLD` |

Use `status=CURRENT` to retrieve active configurations or `status=OLD` for previous values. If you omit `status`, both are returned. The currency pair and transaction type values are listed in the [API reference](https://docs.mesadepagos.com/en/v3/api-reference/fees/consultar-fees.md). A successful query returns 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
  }
]
```

## Create a Fee

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

All four fields are required. `amount` must be a number greater than or equal to zero; use `type` to select `FIXED` or `PERCENTAGE`. A successful request returns 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"
}
```

## Fee Types

| Type | Description |
| - | - |
| `PERCENTAGE` | Applied to the exchange rate. |
| `FIXED` | Applied to the total amount. |

For the same currency pair, transaction type, and fee type, submitting a different amount updates the active fee and preserves the previous value with status `OLD`. Submitting the same amount keeps the current configuration.

See the [create fee API reference](https://docs.mesadepagos.com/en/v3/api-reference/fees/crear-fee.md) for the full schema. Invalid query parameters or request fields return HTTP `400`; a missing, invalid, or expired token returns HTTP `401`.


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