---
updatedAt: 2026-03-16T20:59:56.000Z
agentTools:
  projectIndex: https://docs.withreach.com/llms.txt
---

# Reach FX rates

Reach supports local processing of payments in 135+ currencies, allowing you to present and process in your customer's local currency. This results in the best foreign exchange (FX) rates for cross-border transactions. Using Reach local processing will improve your sales and help customers avoid high conversion costs and fees. Reach FX solutions give your customers much better rates than their banks currently charge them.

Both the [Drop-In](https://docs.withreach.com/docs/drop-in) and [Checkout API](https://docs.withreach.com/docs/checkout-api) support FX and get rates. Call our API to offer the best foreign exchange rates at your checkout.

This guide provides a simple way to access these rates so customers can shop in their local currency. Watch the following video for more information on FX and getting rates. For more information on Reach FX, see the [Reach FX reference guide](https://docs.withreach.com/docs/reach-reference-guide).

<Embed url="https://www.youtube.com/watch?v=-KfV9ZBhBGQ" href="https://www.youtube.com/watch?v=-KfV9ZBhBGQ" typeOfEmbed="youtube" html="%3Ciframe%20class%3D%22embedly-embed%22%20src%3D%22%2F%2Fcdn.embedly.com%2Fwidgets%2Fmedia.html%3Fsrc%3Dhttps%253A%252F%252Fwww.youtube.com%252Fembed%252F-KfV9ZBhBGQ%253Fstart%253D645%2526feature%253Doembed%2526start%253D645%26display_name%3DYouTube%26url%3Dhttps%253A%252F%252Fwww.youtube.com%252Fwatch%253Fv%253D-KfV9ZBhBGQ%26image%3Dhttps%253A%252F%252Fi.ytimg.com%252Fvi%252F-KfV9ZBhBGQ%252Fhqdefault.jpg%26type%3Dtext%252Fhtml%26schema%3Dyoutube%22%20width%3D%22854%22%20height%3D%22480%22%20scrolling%3D%22no%22%20title%3D%22YouTube%20embed%22%20frameborder%3D%220%22%20allow%3D%22autoplay%3B%20fullscreen%3B%20encrypted-media%3B%20picture-in-picture%3B%22%20allowfullscreen%3D%22true%22%3E%3C%2Fiframe%3E" />

# Get rates

Use the [/getRates ](https://docs.withreach.com/reference/getrates) call to get the list of current foreign exchange rates for your cross-border transactions. We guarantee these rates for 24 hours. Returns based on these rates are honored for up to 30 days.

<CardCallout type="brand" title="Expired rates">
  Attempting to create an order using an expired rate will cause an error. We recommend sending a [/getRates ](https://docs.withreach.com/reference/getrates) call once every six hours to ensure you have the latest rate.
</CardCallout>

Each response will contain the following parameters:

| Parameter  | Description                                                                                                                            |
| :--------- | :------------------------------------------------------------------------------------------------------------------------------------- |
| `Id`       | A unique identifier used to identify the rate offer during checkout.                                                                   |
| `Currency` | The currency of the given rate offer.                                                                                                  |
| `Expiry`   | The date and time the rate expires. The rate is valid for 24 hours.                                                                    |
| `Rate`     | The rate of the given currency compared to your remittance currency. Use this to calculate the prices your customers see in your shop. |

<Image align="center" src="https://files.readme.io/d1831575f7fcaf3267d3b3a494e347c5681b7a10f3763abe9dbad3dd3b54f723-GetRates.png" />

# Using getRates on your store

When a shopper selects or uses the default currency, the checkout cart sends a [/getRates](https://docs.withreach.com/reference/getrate)  call. The response updates the prices in the cart to reflect the latest currency rate for the selected currency. It also saves the `rateOfferID` and passes it into the checkout call.

<Image align="center" src="https://files.readme.io/a39dece1a7e87593eceb4dffbbd28b4fcee18e2bf1ab90b02b8a8de650d3653e-GetRatesAPI.png" />

## Rate offers

Using a [/getRate](https://docs.withreach.com/reference/getrate) call, you can retrieve details about any rate offer your customer has received within 24 hours.

<CardCallout type="info" title="Note">
  Rate offers are based on the remittance currency configured for each supplier. If your remittance currency is USD, the rate offer uses USD as the base currency.
</CardCallout>

To maintain accurate pricing visibility for your customers, save the `rateOfferID` in cookies or browser storage so they can view the same prices they were presented with over the last 24 hours, regardless of currency fluctuations.

<CardCallout type="info" title="Latest rates">
  We recommend sending a [/getRates ](https://docs.withreach.com/reference/getrates) call once every six hours to ensure you have the latest rate.
</CardCallout>

To get a customer's rate offer, use [/getRate](https://docs.withreach.com/reference/getrate) and include the `MerchantId` and `RateOfferId` as query parameters, as shown in the following example.

```http /getRate query parameters example
https://checkout.rch.how/v<x>.<yy>/getRate?MerchantId=%7BYourMerchantId%7D&RateOfferId=%7BYourRateOfferId%7D
```

The response will return a JSON object with the offer's `Id`, `Currency`, `Expiry` date and `Rate`.

```json /getRate response example
{
  "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "Currency": "string",
  "Expiry": "2025-05-19T15:46:57.695Z",
  "Rate": 0
}
```