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