# FX rates API

Use the FX rates API to retrieve the indicative foreign exchange (FX) rates that Checkout.com uses for acquiring and card payouts.

Understanding the FX rates can help you offer multi-currency pricing, display transparent rates to your customers, and reconcile your funds. The rates provided include Checkout.com's margin.

> **Information**
>
> Your agreement with Checkout.com determines whether the daily acquiring FX rates or the scheme acquiring FX rates are used for your payments. Contact your account manager or [request support](https://dashboard.checkout.com/support/new) to confirm which rates apply to you.

---

## Daily acquiring FX rates

> **Information**
>
> Daily acquiring FX rates are guaranteed. Checkout.com honors the rate for your payments.

Daily acquiring FX rates are provided by Checkout.com as a single rate per currency pair. They are set daily and fixed for a calendar day.

As the same rate applies across all card schemes, you can use the fixed daily FX rate to offer products in multiple currencies at a margin.

Call the [Get FX rates](https://api-reference.checkout.com/tag/Forex#operation/getFxRates) endpoint and provide:

- `daily_acquiring` as the `product` query parameter.
- The currency pair to check FX rates for as the `currency_pairs` query parameter. For example, `USDGBP` or `EURJPY`.
- The processing channel ID as the `processing_channel_id` query parameter. You can [view your processing channel ID](https://www.checkout.com/docs/business-operations/use-the-dashboard/manage-processing-channels.md#View_processing_channels) in the Dashboard.

> **Information**
>
> Your base URL's `{prefix}` value is unique to your account and environment. To learn how to retrieve your base URLs for the sandbox and production environments, see [API endpoints](https://www.checkout.com/docs/developer-resources/api/api-endpoints.md).

**Production**

`GET` `https://{prefix}.api.checkout.com/forex/rates?product=daily_acquiring`

**Sandbox**

`GET` `https://{prefix}.api.sandbox.checkout.com/forex/rates?product=daily_acquiring`

### Response example

```json
{
  "product": "daily_acquiring",
  "rates": [
    {
      "currency_pair": "USDGBP",
      "rate": "0.79123"
    }
  ],
  "invalid_currency_pairs": []
}
```

Currency pairs that Checkout.com could not retrieve FX rates for are returned in the `invalid_currency_pairs` array. For example, if the currency pair is not supported by the scheme.

---

## Scheme acquiring FX rates

> **Information**
>
> Scheme acquiring FX rates are indicative. They may not represent the actual rates at the point of transaction conversion.

Scheme acquiring FX rates are provided by the relevant card scheme. Rates may differ between schemes as they publish their own rates on their own schedules:

- Mastercard updates their FX rates daily.
- Visa updates their FX rates daily, except for weekends and on some public holidays.

The API always returns the most up-to-date rate available from the requested scheme.

Call the [Get FX rates](https://api-reference.checkout.com/tag/Forex#operation/getFxRates) endpoint and provide:

- `scheme_acquiring` as the `product` query parameter.
- The card scheme to check FX rates for as the `source` query parameter.
- The currency pair to check FX rates for as the `currency_pairs` query parameter. For example, `USDGBP` or `EURJPY`.
- The processing channel ID as the `processing_channel_id` query parameter. You can [view your processing channel ID](https://www.checkout.com/docs/business-operations/use-the-dashboard/manage-processing-channels.md#View_processing_channels) in the Dashboard.

> **Information**
>
> Your base URL's `{prefix}` value is unique to your account and environment. To learn how to retrieve your base URLs for the sandbox and production environments, see [API endpoints](https://www.checkout.com/docs/developer-resources/api/api-endpoints.md).

**Production**

`GET` `https://{prefix}.api.checkout.com/forex/rates?product=scheme_acquiring`

**Sandbox**

`GET` `https://{prefix}.api.sandbox.checkout.com/forex/rates?product=scheme_acquiring`

### Response example

```json
{
  "product": "scheme_acquiring",
  "source": "visa",
  "rates": [
    {
      "currency_pair": "USDGBP",
      "rate": "0.79014"
    }
  ],
  "invalid_currency_pairs": []
}
```

Currency pairs that Checkout.com could not retrieve FX rates for are returned in the `invalid_currency_pairs` array. For example, if the currency pair is not supported by the scheme.

---

## Card payouts FX rates

> **Information**
>
> Card payouts FX rates are indicative. They may not represent the actual rates at the point of transaction conversion.

Card payouts FX rates are provided by the relevant card scheme. Rates may differ between schemes.

- `card_payouts` as the `product` query parameter.
- The card scheme to check FX rates for as the `source` query parameter.
- The currency pair to check FX rates for as the `currency_pairs` query parameter. For example, `USDGBP` or `EURJPY`.
- The processing channel ID as the `processing_channel_id` query parameter. You can [view your processing channels](https://www.checkout.com/docs/business-operations/use-the-dashboard/manage-processing-channels.md#View_processing_channels) in the Dashboard.

> **Information**
>
> Your base URL's `{prefix}` value is unique to your account and environment. To learn how to retrieve your base URLs for the sandbox and production environments, see [API endpoints](https://www.checkout.com/docs/developer-resources/api/api-endpoints.md).

**Production**

`GET` `https://{prefix}.api.checkout.com/forex/rates?product=card_payouts`

**Sandbox**

`GET` `https://{prefix}.api.sandbox.checkout.com/forex/rates?product=card_payouts`

### Response example

```json
{
  "product": "card_payouts",
  "source": "visa",
  "rates": [
    {
      "currency_pair": "USDGBP",
      "rate": "0.79014"
    }
  ],
  "invalid_currency_pairs": []
}
```

Currency pairs that Checkout.com could not retrieve FX rates for are returned in the `invalid_currency_pairs` array. For example, if the currency pair is not supported by the scheme.