International transactions
cross river international card transactions the same cross river transaction apis serve domestic as well as international transactions an international transaction involves the following multi country a cross border transaction, where the origination and destination countries for the payment are different here, the country of the card issuer determines the conditions of the transaction currency exchange sometimes, a transaction happens with a us issued payment card outside the us or, it can occur within the us using a non us issued card these transactions require changing from one currency to another the foreign exchange (fx) rates api makes it easy to access the conversion rate for the currencies of two different countries currency conversion rates are indicative this means they are dynamic, not fixed conversion rates depend on the currency pair the network exchange rate real time exchange rates cross river provides you with the real time foreign exchange rate in the currency of the party receiving the payment cross river fx rates reflect the rates now available in financial networks in the case of visa and mastercard, the api responds to a function call with a list of rate data from the card networks these rates can differ between networks they are updated once each day the forex rates api provides clear information about any network processing transactions mastercard rates change every day at 15 05 est in the us they remain valid for 24 hours let's say a transaction occurred on may 1st, 2023 at 04 00 est the rate that applies to the transaction would be the rate set on april 30th, 2023 that rate covers the period from 15 05 est on april 30th to 15 05 est on may 1st visa rates change once a day at 19 00 est (midnight gmt) over the weekend, the system uses the rates from friday use case for example, suppose a customer from sweden wants to buy products from your american online store as a merchant partner, you need to perform an international transaction that's because the customer is buying in kronor (the currency of sweden) products being sold in us dollars cross river provides a call to the fx rate api endpoint you make this call before performing the transaction request these rates are most useful when working with multi currency or cross border transactions in addition to the current exchange rate, the fx rates api also reflects the markup fee a network charges for a foreign transaction for transaction settlement, the currency conversion rate returned by the api may differ from the actual rate of exchange offered in the market the fx rates function call is standalone it returns the exchange rate without actually determining the international transaction api reference learn about the docid\ c7lrwhp81empw2u9ln4i api endpoint