Sign in

v1

latestOpenAPI 3.0.32026-07-26208618579.9 KB
Get FX exchange rates

FX Exchange Rates for supported payment schemas (Visa, Mastercard)

This operation is to get the Visa/Mastercard treasury FX rates for a given “from” and “to” currency pair.

post/v2/{paymentScheme}/fx

Path parameters

paymentScheme'VISA' | 'MC' required

Indicates the applicable payment scheme

Payment scheme

Query parameters

auditUserstring required

The audit user to log the request

Request body

fromAmountnumber required

The transaction amount in the foreign currency that the end user requests to convert

fromCurrencystring required

The foreign currency that the end user requests to convert. Currency is given with a ISO 4217 currency code and needs to be a European Central Bank ("ECB") supported currency.

toCurrencystring required

The card's settlement currency. Currency is given with a ISO 4217 currency code and needs to be a ECB supported currency.

issuerMarkupPercentagenumber double required

The issuer's mark-up percentage that is applied to foreign currency purchases

Example request

{
  "fromCurrency": "EUR",
  "toCurrency": "EUR",
  "issuerMarkupPercentage": 10
}

Response

fromAmountnumber

The transaction amount in the foreign currency that the end user requests to convert

fromCurrencystring

The foreign currency that the end user requests to convert. Currency is given with a ISO 4217 currency code and needs to be a European Central Bank ("ECB") supported currency.

toCurrencystring

The card's settlement currency. Currency is given with a ISO 4217 currency code and needs to be a ECB supported currency.

toAmountWithSchemeRatenumber

The transaction amount in the card's settlement currency converted with the payment scheme's rate but not considering the issuer mark-up. Derived by converting the fromAmount using payment scheme rates between from and to currency pairs. Mark-up rate is not included in the calculations. Exchange rates used for conversion will be the latest rates available. The value is always rounded to two (2) decimal places.

toAmountWithMarkupnumber

The transaction amount in the card's settlement currency converted with payment scheme's rate considering the issuer mark-up. Derived by converting the fromAmount using ECB rates between from and to currency pairs. Additional rate is not included in the calculations. Exchange rates used for conversion will be the latest rates available. The value is always rounded to two (2) decimal places.

toAmountWithEcbRatenumber

The transaction amount in the card's settlement currency converted with the ECB's rate but not considering the issuer mark-up. Derived by converting the fromAmount using ECB rates between from and to currency pairs. Mark-up rate is not included in the calculations. Exchange rates used for conversion will be the latest rates available. The value is always rounded to two (2) decimal places.

fxRatePaymentSchemenumber

Payment scheme exchange rate for the fromCurrency and toCurrency currency pair. This rate will not include any issuer mark-up. The value is always rounded to four (4) decimal places. As of 12/2022, Visa and Mastercard update their exchange rates on business days at 1 AM (GMT) and at 6 PM (GMT) respectively. Please note that the times at which payment schemes update their rates is subject to change without advance notice. However, the exchange rate applied and provided by Enfuce is always the latest one at any given time.

fxRatePaymentSchemeRawnumber

Payment scheme exchange rate for the fromCurrency and toCurrency currency pair. This rate will not include any issuer mark-up. The value is always rounded to eight (8) decimal places. As of 12/2022, Visa and Mastercard update their exchange rates on business days at 1 AM (GMT) and at 6 PM (GMT) respectively. Please note that the times at which payment schemes update their rates is subject to change without advance notice. However, the exchange rate applied and provided by Enfuce is always the latest one at any given time.

fxRateWithMarkupnumber

Applicable exchange rate for the customer, i.e. payment scheme exchange rate between the fromCurrency and toCurrency currency pair including issuer mark-up. The value is always rounded to four (4) decimal places.

fxRateWithMarkupRawnumber

Applicable exchange rate for the customer, i.e. payment scheme exchange rate between the fromCurrency and toCurrency currency pair including issuer mark-up. The value is always rounded to eight (8) decimal places.

fxRateEcbnumber

ECB exchange rate between the fromCurrency and toCurrency currency pair including issuer mark-up. The value is always rounded to four (4) decimal places. As of 12/2022, the ECB updates exchange rates once per business day around 2 PM (GMT). Please note that the times at which the ECB updates its rates is subject to change without advance notice. However, the exchange rate applied and provided by Enfuce is always the latest one at any given time.

fxRateEcbRawnumber

ECB exchange rate between the fromCurrency and toCurrency currency pair including issuer mark-up. The value is always rounded to decimal (8) decimal places. As of 12/2022, the ECB updates exchange rates once per business day around 2 PM (GMT). Please note that the times at which the ECB updates its rates is subject to change without advance notice. However, the exchange rate applied and provided by Enfuce is always the latest one at any given time.

markupPercentageOverEcbnumber

Comparison of the customer applicable rate (payment scheme rate plus issuer mark-up) versus the ECB rate expressed as a percentage. A positive value represents in percentages how much higher the customer applicable rate is compared to the ECB rate.

Example response

{
  "fromCurrency": "EUR",
  "toCurrency": "EUR"
}