Formats and data types

UTF-8 encoding

Gate 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.

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 Gate 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 Gate or received in responses and callbacks transmitted according to ISO standard 4217 alpha-3.

Languages

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