Card payments

Foreign exchange rates

3min

Use Cross Rivers foreign exchange (FX) rates API to get a foreign currency conversion rate from the card network.

About rate change timing in card networks:

Mastercard. Rates change every day at 14:05 CST in the US. They remain valid for 24 hours. Let's say a transaction occurred on May 1st, 2023 at 3:00 AM CST. The rate that applies to the transaction would be the rate set on April 30th, 2023. That rate covers the period from 14:05 CST on April 30th to 14:05 CST on May 1st.

Visa. Rates change once a day at around 19:00 EST (midnight GMT). Over the weekend, the system uses the rates from Friday.

The endpoint listed in this table is described in detail below.

Action

API Call

Description

GET /api/FXRates

For a currency pair, gets updated foreign exchange rate information from the card network

Get International Foreign Exchange (FX) Rate

Returns up-to-date foreign exchange rate information for card-based payments. As a Cross River merchant partner, you do this before making an international transaction.

Add query parameters to filter the response the API returns to all GET calls.

Use Pagination to control presentation of your results.

GET
Request
Response
Body Parameters
requestId
required
String
The GUID that enables the application to link request with response
sourceCurrency
required
String
The currency code for the source (monetary) amount. This is a numeric value based on the currencies listed in ISO-4217. For example, if converting from (USD) 840 to (CAD) 124, the value would be 840.
sourceAmount
optional
String
The amount of money the payer is sending, in the currency indicated in sourceCurrency. This value is needed for source-to-destination lookup. Minor currency units after the decimal point must be ≤ (less than or equal to) the defined currency exponent (the digits following the decimal). This field cannot be 0 or null. The field contains between 1 – 13 characters, including a decimal, for example, 100.55. For example: Two (2) digits indicated after the decimal point for a two-exponent currency (99.85, 99.00, etc.). Three (3) digits indicated after the decimal point for a three-exponent currency (989.333, 989.340, 989.000, etc.). No decimal point or minor units indicated for a zero (0) exponent currency (95, 100, etc.).
destinationCurrency
required
String
The currency code for the destination (monetary) amount. A numeric value based on the currencies listed in ISO-4217. For example, if converting from (USD) 840 to (CAD) 124, the value would be 124.
markupPercentage
optional
String
The fee the card company charges for an international transaction, for example, 0.07. Note: Not relevant for first release.


Related topics

🤔
Have a question?
Our super-smart AI, knowledgeable support team and an awesome community will get you an answer in a flash.
To ask a question or participate in discussions, you'll need to authenticate first.



Updated 29 Sep 2024
Doc contributor
Did this page help you?