Specifying data type

The messages exchanged between the merchant and the payment gateway follow a certain syntax.

Here is a table with a description of used annotations.

Table 1. Description of used annotations
Annotation Description
a Alphabetic characters (from A to Z and from a to z)
n Numeric characters (from 0 to 9)
s Special characters
an Alphanumeric characters
ans Alphanumeric and special characters
3 Fixed length of 3 characters
..12 Flexible length up to 12 characters

The data in the messages can be of different types:

Table 2. Description of data in the messages
Data type Description
boolean A boolean can only have two responses: true or false.

true can be replaced by yes or 1.

false can be replaced by no or 0.

dateTime Used for defining a moment in time, generally represented as date or hour.

Contains a year, a month, a day, an hour, minutes, seconds and milliseconds.

The value is expressed in universal coordinated time (UTC) and ISO 8601 - W3C.

Comparing to local time, a date and time given in UTC is the same everywhere at the same time.

Example: 2016-07-16T19:20:00Z

int Represents an integer, i.e. a number without decimals.
long Represents an integer coded in 64 bits.

This type of data is used when the data of int type is not large enough (e.g. to specify the transaction amount).

string May contain characters, line feeds, carriage returns and tabs.