Formats and data types

UTF-8 encoding

Old Dashboard uses UTF-8 encoding for requests and responses. Therefore all data transferred to should be converted into UTF-8; all data received from will also be transmitted in UTF-8 format.

Payment amounts

All payment amounts sent to or received in response and callbacks are passed as integers in minor currency units according to ISO 4217. The size of the fractional part is shown in the Active Code table, column E.

A minor unit of currency is the part of a nominal unit of currency, usually 1/100. For example, 1 US cent equals $1/100. Examples of the ratio of nominal and minor currency units are shown in the table below.

Amount in nominal currency units Amount in minor currency units
450.66 GBP 45066
39.95 USD 3995
200 JPY 200
150.155 KWD 150155

Countries

When transmitting information about countries, the country code is received and transmitted according to ISO 3166-1 Alpha-2.

Dates and times

  • In requests, dates and times are passed in the YYYY-MM-DD hh:mm:ss format according to ISO 8601. The time zone is passed separately as a three-letter code (List of time zone abbreviations).
  • In responses, dates and times are passed in UTC+0. Date and time are specified according to ISO 8601. For example, 2017-07-21t03:31:24+0000.

Currencies

All currencies that are passed to Old Dashboard or received in responses and callbacks transmitted according to ISO standard 4217 alpha-3.

Languages

All languages that are passed to Old Dashboard or received in responses and callbacks transmitted according to ISO standard 639-1 alpha-2.

Currency conversion

In general, a payment may involve three currencies: customer account currency, payment currency, and merchant account currency. If all the three currencies are the same, there is no need for currency conversion, otherwise you need to convert payment amount between currencies.

Suppose that merchant employee uses the merchat pound-denominated account to pay some euros to user whose account is denominated in roubles. The payment amount is consecutively converted from pounds to euros, and then from euros to roubles. The first conversion operation is performed by the ECommPay payment platform. The second conversion operation is performed by issuer or by alternative payment system.

Currency conversion the ECommPay payment platform performes is available ffor all payment methods. The payment platform uses exchange rates from one of the following sources:

The rates in all the sources are updated daily except for Currencylayer which updates its rates every six hours.

By default, each merchant project uses only one source which is assigned byECommPay or selected by merchant when integrating with the ECommPay platform. Although, the ECommPay payment platform may use rates from a different source if the default source fails to provide the required exchange rate. You do need to contact technical support at support@ecommpay.com to set the exchange sate source.

You can get the information about conversion operations performed by the payment platform from the callbacks with payment results, from Old Dashboard, or from regular reports sent to email addresses you specify. We recommend that you use this information for reconciliation with ECommPay, because issuer and alternative payment system use the merchant account currency to keep record of the merchant transactions.