FX rates API
Beta
Last updated: July 16, 2026
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 to confirm which rates apply to you.
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 endpoint and provide:
daily_acquiringas theproductquery parameter.- The currency pair to check FX rates for as the
currency_pairsquery parameter. For example,USDGBPorEURJPY. - The processing channel ID as the
processing_channel_idquery parameter. You can view your processing channel ID 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.
get
https://{prefix}.api.checkout.com/forex/rates?product=daily_acquiring
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.
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 endpoint and provide:
scheme_acquiringas theproductquery parameter.- The card scheme to check FX rates for as the
sourcequery parameter. - The currency pair to check FX rates for as the
currency_pairsquery parameter. For example,USDGBPorEURJPY. - The processing channel ID as the
processing_channel_idquery parameter. You can view your processing channel ID 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.
get
https://{prefix}.api.checkout.com/forex/rates?product=scheme_acquiring
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.
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_payoutsas theproductquery parameter.- The card scheme to check FX rates for as the
sourcequery parameter. - The currency pair to check FX rates for as the
currency_pairsquery parameter. For example,USDGBPorEURJPY. - The processing channel ID as the
processing_channel_idquery parameter. You can view your 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.
get
https://{prefix}.api.checkout.com/forex/rates?product=card_payouts
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.