Formats and data types

UTF-8 encoding

Payment Page 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

Dates and times passed to Payment Page or received in responses and callbacks transmitted 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 Payment Page or received in responses and callbacks transmitted according to ISO standard 4217 alpha-3.

Languages

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