POST
/
v1
/
visa
/
fx
curl --request POST \
  --url https://integration-api-cat2./%7B{environment}%7D.ext.%7B{realm}%7D.cia.enfuce.com/exchange-rate/v1/visa/fx \
  --header 'Content-Type: application/json' \
  --data '{
  "fromAmount": 1,
  "fromCurrency": "EUR",
  "toCurrency": "EUR"
}'
{
  "fromAmount": 123,
  "fromCurrency": "EUR",
  "toCurrency": "EUR",
  "toAmountWithVisaRate": 123,
  "toAmountWithAdditionalFee": 123,
  "fxRateVisa": 123,
  "fxRateWithAdditionalFee": 123,
  "visaRateLastUpdatedTimestamp": "2023-11-07T05:31:56Z",
  "benchmarks": [
    {
      "benchmarkSystem": "<string>",
      "toAmountWithBenchmarkRate": 123,
      "markupWithAdditionalFee": 123,
      "benchmarkFxRate": 123,
      "benchmarkRateLastUpdatedTimestamp": "2023-11-07T05:31:56Z"
    }
  ]
}

Query Parameters

​
auditUser
string
required

The audit user to log the request

Body

application/json
​
fromAmount
number
required

From Amount also known as transaction amount that will be converted from the "fromCurrency" and to the "toCurrency"

Required range: x > 0
​
fromCurrency
string
required

Any ECB supported currency with valid ISO 4217 currency code

Example:

"EUR"

​
toCurrency
string
required

Any ECB supported currency with valid ISO 4217 currency code

Example:

"EUR"

Response

200
application/json
​
fromAmount
number

From Amount also known as transaction amount that will be converted from the "fromCurrency" to the "toCurrency".

​
fromCurrency
string

Any ECB supported currency with valid ISO 4217 currency code

Example:

"EUR"

​
toCurrency
string

Any ECB supported currency with valid ISO 4217 currency code

Example:

"EUR"

​
toAmountWithVisaRate
number

To Amount also referred to as Cardholder Billing amount without additionalRate. Derived by converting the fromAmount using Visa Treasury Rates between from and to currency pairs. Additional rate is not included in the calculations. Visa treasury rates used for conversion will be as of the last rates available.

​
toAmountWithAdditionalFee
number

Also referred to as Cardholder Billing amount with additional rate. Derived by converting the fromAmount using Visa Treasury Rates between fromCurrency and toCurrency currency pairs. additionalRate is included in the calculations. Visa treasury rates used for conversion will be as of the last rates available.

​
fxRateVisa
number

Visa Treasury Exchange Rate for the fromCurrency and toCurrency currency pair. This rate will not include any additionalRate

​
fxRateWithAdditionalFee
number

Applicable Exchange Rate between the fromCurrency and toCurrency currency pair including additionalRate.

​
visaRateLastUpdatedTimestamp
string

ISO-8601 date when the Visa Treasury rates were last updated for calculations.

​
benchmarks
object[]

Will return all the benchmark properties that apply to the fromCurrency and toCurrency pair in the Visa system. The API is built to support several benchmarks but ECB is the only available benchmark for now.