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
﻿Foreign exchange rates﻿ 
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
﻿Foreign exchange overview﻿ 
﻿Request and response codes﻿ 
﻿Error codes﻿ 

Action	API Call	Description
Foreign exchange rates	GET /api/FXRates	For a currency pair, gets updated foreign exchange rate information from the card network

🤔

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 15 Oct 2024

Did this page help you?

Transaction management

OFAC