FX rates API
Beta
Last updated: February 28, 2024
The Forex (FX) rates API enables you to get the indicative foreign exchange rates that Checkout.com uses to process payments for card payouts and scheme acquiring. 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.
Information
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.
get
https://api.checkout.com/forex/rates
Information
This endpoint is currently only available for Visa and Mastercard sourced FX Rates.
| Query parameter | Value |
|---|---|
string | The FX product you want to request a conversion for. Only If you specify a query parameter value for a product not enabled on your Checkout.com account, you will receive a |
integer | The source of provided rates. Currently only supports Visa and Mastercard. |
string | Comma-separated list of currency pairs. For example, |
integer | 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.