Data types and formats
This page describes our data formats, terminology and standards.
Numeric
A number, usually a whole, positive integer, but can also have decimals, f.ex. in case of money amounts (see below for more info on money amounts).
Integer
A whole, positive number, f.ex. 1 or 879613
String
Any sequence of characters (text) - i.e. letters, numbers and special symbols.
Boolean
A parameter that can only have one of two values, 0 or 1.
Usually, 0 roughly translates to "no" and 1 to "yes".
Date/time
Dates are always represented in the format YYYY-MM-DD and time HH:MM:SS. Date and time can be put together, separated by a single space.
Timezone is always CET - Central European Time, usually equivalent to UTC+1 or UTC+2 in summer (DST - Daylight Saving Time).
Money amounts
Money amounts are usually represented with 2 decimals, separated by a comma. The currency is always specified in a separate parameter.
No thousand separators or other symbols are included.
Country codes
Countries are specified in the 2-letter ISO 3166-1 alpha-2 format.
Language codes
Languages are specified in the 2-letter ISO 639-1 format.
Currency codes
Currencies are specified in the 3-letter ISO 4217 format.
Supported billing currencies (subject to restrictions by merchant location):
- USD
- EUR
- GBP
- CAD
- BRL
- JPY
Updated over 1 year ago