All timestamps are formatted as ISO 8601 with timezone information. For API calls that allow for a timestamp to be specified, we use that exact timestamp. These timestamps look something like "2014-02-27T15:05:06.123Z". All timestamps are stored in Visa Payments Limited payment platform as UTC.
For endpoints that require dates, we expect a date string format of "YYYY-MM-DD" (e.g. 2014-02-27).
Wherever an API contains a field referring to a currency, then it requires a currency code.
Visa Payments Limited uses the ISO 4217 3 letter currency code (e.g. USD, GBP, EUR).
Where an API contains a field referring to a country, then it requires a country code.
Visa Payments Limited uses the ISO 3166 2 letter country code (e.g. GB, US, CH).
The REST API represents financial amounts as decimals. However, Visa Payments Limited backend system converts this into a 'Monetary Amount' class, which takes into account the number of decimal places for the specific currency and uses Java BigDecimal to handle floating point precision.
We expect all data that is sent to Visa Payments Limited APIs to be UTF-8 encoded.