You're viewing documentation for our latest API. This will not impact your integration, but you will need the documentation relevant to you. If you have an account with Checkout.com you have received an email confirming which version to use.
The Forex (FX) rates API enables you to get the indicative foreign exchange rates that Checkout.com uses to process payments for card payouts. You can also query the related source (for example, Visa Direct or Mastercard Send) of rates.
The API will always give the most up to date response possible, depending on the availability of our data sources. The source data for Mastercard is updated daily. The source data for Visa is updated daily, except at weekends and on some public holidays.
To get a detailed view of all required and optional fields, see our API reference.
As the rates are indicative, they may not represent the actual rates at the point of transaction conversion.
Use the following endpoint to get the daily exchange rate.
This endpoint is currently only available for Visa and Mastercard sourced FX Rates.
The FX product you want to request a conversion for.
Currently only supports card_payouts.
The source of provided rates.
Currently only supports Visa and Mastercard.
Comma-separated list of currency pairs.
For example, USDGBP,EURJPY,THBNZD.
The processing channel identifier.
In the following example, the FX exchange rate for GBPEUR is 1.14208777 and the FX exchange rate for USDGBP is 0.83708142, which includes your FX markup. There is also a list of invalid currency pairs.