POST
/
v2
/
{paymentScheme}
/
fx

Path Parameters

paymentScheme
enum<string>
required

Payment scheme

Available options:
VISA,
MC

Query Parameters

auditUser
string
required

The audit user to log the request

Body

application/json
fromAmount
number
required

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

fromCurrency
string
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.

toCurrency
string
required

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

issuerMarkupPercentage
number
required

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

Response

200 - application/json
fromAmount
number

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

fromCurrency
string

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.

toCurrency
string

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

toAmountWithSchemeRate
number

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.

toAmountWithMarkup
number

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.

toAmountWithEcbRate
number

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.

fxRatePaymentScheme
number

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.

fxRateWithMarkup
number

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.

fxRateEcb
number

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.

fxRateEcbRaw
number

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.

markupPercentageOverEcb
number

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.