Understanding "Enhanced Foreign Exchange Rates API" Response

Regular Visitor

Understanding "Enhanced Foreign Exchange Rates API" Response

Hi,

 

I'm using the Enhanced Foreign Exchange Rates API, but I do not completely understand the values I receive.  I read the documentation and the explanation even that is not clear enough, seems to be fine.

 

For example I'm trying to get the Markup with the following values:

 

{
   "toCurrency":"EUR",
   "additionalRate":"1.25",
   "additionalFee":"0",
   "asOfDate":1606780800,
   "fromAmount":"1.00",
   "fromCurrency":"HRK"
}

 

 

The values I receive are the following:

 

{
   "asOfDate":1606780800,
   "fromAmount":"1.00",
   "fromCurrency":"HRK",
   "fromCurrencyName":"Croatian Kuna",
   "toCurrency":"EUR",
   "toCurrencyName":"Euro",
   "toAmountWithVisaRate":"0.134725",
   "toAmountWithAdditionalFee":"0.136409",
   "fxRateVisa":"0.1347252934",
   "fxRateWithAdditionalFee":"0.1364093596",
   "lastUpdatedVisaRate":1582670435,
   "benchmarks":[
      {
         "benchmarkSystem":"ECB",
         "benchmarkBaseCurrency":"EUR",
         "benchmarkBaseCurrencyName":"Euro",
         "toAmountWithBenchmarkRate":"0.132384",
         "markupWithoutAdditionalFee":"0.017683",
         "markupWithAdditionalFee":"0.030404",
         "benchmarkFxRate":"0.1323837009",
         "lastUpdatedBenchmarkRate":1606748733
      }
   ]
}

 

 

I have 2 doubts about this:

 

1) "toAmountWithAdditionalFee" 

Why this field is showing a value of "0.136409" but if I go here  I see different values inputting the same input parameters. Screenshot attached as well.

Currency Converter - Exchange Rate Calculator _ Visa.png

 

2) "markupWithoutAdditionalFee" and "markupWithAdditionalFee"

Are these 2 fields percentages? If yes "markupWithAdditionalFee" in my response is giving me a 3%, is this correct? If it is I see it too much, I do not see that value anywhere. Other banks for the same currency, same date, are setting values much lower than that of VISA fee. Even in your currency conversor that I attached screenshot.

 

 

Thank you in advance for your help.

 

Regards. Daniel.

1 REPLY 1
Visa Dev Moderator
Visa Dev Moderator

Re: Understanding "Enhanced Foreign Exchange Rates API" Response

Hi @bov,

 

The sandbox environment is populated with sample data and you will get a canned response when you make the API call.
Typically one would use sandbox testing to understand the API and its interface. When you promote you project to the production environment, you will be able to receive live data. 

 

markupWithAdditionalFee: Number field with at most 6 decimal places using radix separator as ".". Markup calculated between the toAmountWithAdditionalFee and toAmountWithBenchmarkRate. Calculated as (toAmountWithAdditionalFee - toAmountWithBenchmarkRate)/toAmountWithBenchmarkRate. Will be returned only if either the additionalRate or additionalFee is specified in the request. No symbols other than +/- and radix separator “.” allowed.

 

markupWithoutAdditionalFee: Number field with at most 6 decimal places using radix separator as ".". Markup calculated between the toAmountWithVisaRate and toAmountWithBenchmarkRate. Calculated as (toAmountWithVisaRate - toAmountWithBenchmarkRate)/toAmountWithBenchmarkRate. Rate of Mark-Up/Down in +/- (e.g. +2.00). No symbols other than +/- and radix separator “.” will be returned.

 

Hope this helps.


Best,
Stacey

Was your question answered? Don't forget to click on "Accept as Solution" to help other devs find the answer to the same question.