SupportAPI referenceClassic API docs
Guides
Start typing to searchā€¦

Fx rates endpoint

The Fx rates endpoint provides Checkout.com's daily Fx rates used to process Visa Direct Original Credit Transactions (OCTs).

The request

Use the details below to set up your request.

Endpoint

Live

GEThttps://api.checkout.com/forex/rates/{baseCurrency}/{quoteCurrency}

šŸš§

This endpoint is only available in a live environment.

Header and path parameters

Header

Value

Authorization Required

secret key

Use the valid secret key of your Checkout.com account. You can find this in the Hub.

Content-Type\ Required

application/json

Path

Value

baseCurrency Required

The three-letter ISO currency code representing the base currency.\ You can find a list of all valid codes here.

quoteCurrency\ Required

The three-letter ISO currency code representing the quote currency.\ You can find a list of all valid codes here.

The response

Below is an example of a successful response.

Response example

[
  {
    "name": "VISA",
    "rate": {
      "currency_pair": "GBPEUR",
      "exchange_rate": 1.11264000
    }
  }
]

Understanding the response

The response is designed to present your information as clearly as possible.
In this example, the base currency is GBP and the Checkout.com exchange rate to EUR is 1.11264000.

The API will always give the most up to date response possible, depending on availability of our data source (VisaDirect). The source data is updated daily around 12:00am UTC, responses before 02:00 UTC may not reflect today's rates.

on weekdays, excluding bank holidays and weekends

Can we help?

Thanks for using Checkout.com. If you need any help or support, then message our support team at [email protected].

Updated 5 months ago