---
title: "View currency conversion rates"
method: GET
path: "/pay/v3/conversionRates"
tags: ["Ecommerce"]
---

# View currency conversion rates

`GET /pay/v3/conversionRates`

<img src="https://files.readme.io/d0d9414-convert_icon.png" alt="Convert" align="left"> For multi-currency pricing (MCP), use this endpoint to retrieve a list of currencies and their current conversion rates in order to convert your prices into the customer's local currency. This endpoint only works with a gateway connection that supports MCP. To enable your merchant account for retrieving the currency conversion rates, contact [Integrations Support](https://docs.nexiopay.com/page/contact-us).

The rates are based on the settlement currency that is specified in the merchant account. To use this endpoint, take the price (in the based currency) and divide by the rate for the customer's currency.

<!-- theme: warning -->
> ⚠️ Try It
> 
> To use the Try It feature for this endpoint, you must use the credentials for your [Sandbox API user](https://docs.nexiopay.com/docs/sandbox-environments) and have a gateway connection that supports MCP.


<div style="display:none;">

## Response parameters
- merchantId
- rates
- rates.currency
- rates.rate

</div>

## Response `200`

Success

- object — An array of all currencies and their conversion rates
  - `merchantId` MerchantId — unresolved $ref
  - `rates` object[] — Currency conversion rate information.
    - `currency` string — The [three-character ISO code](https://en.wikipedia.org/wiki/ISO_4217) for the currency to match with the customer's currency.
    - `rate` number — The current conversion rate from the listed currency to the settlement currency of the merchant account.

## Other responses

- `401` — Unauthorized. For help with this error and other error codes, see [Common errors](https://docs.nexiopay.com/docs/common-errors) in the Guides area.

---

[API](https://skmtc.dev/nexiopay/apis/payments-api-reference.md) · [All operations](https://skmtc.dev/nexiopay/apis/payments-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nexiopay/payments-api-reference/revisions/b414b73979e5/schema)