Fees - ON RAMP by Mesadepagos

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 and send Authorization: Bearer {accessToken} with every request.

Retrieve Fees

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. A successful query returns HTTP 200.

Response

[
  {
    "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

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.

{
  "pair": "USDC/BOB",
  "transactionType": "withdrawal_express",
  "amount": 0.5,
  "type": "PERCENTAGE"
}

Response

{
  "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 for the full schema. Invalid query parameters or request fields return HTTP 400; a missing, invalid, or expired token returns HTTP 401.

​Retrieve Fees

​Query Parameters

​Response

​Create a Fee

​Response

​Fee Types

Retrieve Fees

Query Parameters

Response

Create a Fee

Response

Fee Types