Skip to content
Card Payouts / FX rates endpoint

FX rates endpoint

Last updated: April 29, 2022

The FX rates endpoint provides you with the daily foreign exchange rates we use to process Visa Direct Original Credit Transactions (OCTs).

The request

Use the following endpoint to get the daily exchange rate.

Endpoint

    get

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

    Note

    This endpoint is only available in the live environment.

    Header and path parameter

    HeaderValue

    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

    PathValue

    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

    Response example

    1
    [
    2
      {
    3
        "name": "VISA",
    4
        "rate": {
    5
          "currency_pair": "GBPEUR",
    6
          "exchange_rate": 1.11264000
    7
        }
    8
      }
    9
    ]

    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 the availability of our data source (VisaDirect). The source data is updated daily (on weekdays; excludes bank holidays and weekends) around 12:00am UTC, responses before 02:00 UTC may not reflect today's rates.