Data types and formats
This page describes our data formats, terminology and standards.
Numeric
A number is typically a whole, positive integer, but it can also be a decimal, for example, in the case of money amounts (see below for more information on money amounts).
Integer
A whole positive number, for example 1 or 879613.
String
Any sequence of characters (text) - for example, letters, numbers, and special symbols.
Boolean
A parameter can only have one of two values: 0 or 1. Typically, 0 means "no" and 1 means "yes".
Date/time
Dates are always represented in the format YYYY-MM-DD and time in HH:MM:SS. Date and time can be combined and separated by a single space.
The timezone is always CET - Central European Time, which is usually equivalent to UTC+1 or UTC+2 during summer (DST - Daylight Saving Time).
Money amounts
Money amounts are usually represented with two 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 6 months ago