FX rates API
Beta
Last updated: December 10, 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 daily acquiring.
You can also query the source of the rates, which can be Mastercard Send or Visa Direct.
The API always returns 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.
Information
The rates are indicative, so they may not represent the actual rates at the point of transaction conversion.
Call the Get FX rates endpoint, and provide the following query parameters:
product– The product you want to request rates for, which can be one of:card_payouts,daily_acquiring.source– The scheme that provided the FX rates, which can be one of:mastercard,visa.currency_pairs– The list of currency pairs you want to get the rates for. For example,USDGBP,EURJPY,THBNZD.processing_channel_id– The processing channel ID.
get
https://api.checkout.com/forex/rates
Information
This endpoint is currently only available for Visa and Mastercard sourced FX Rates.
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.