Data formats

Overview

This article covers general information about the ways to encode data and about the formats of data which is used in the scope of interaction with the ecommpay payment platform.

Information about general approaches to generating requests, responses, and callbacks is provided in the Interaction concepts article, information about service codes that identify elements of different registers—in the References section, detailed information about special cases of data formats—in the articles about different capabilities and in the article Parameters for opening payment form. Besides, you can also contact our technical support specialists with any questions that arise.

Data encoding

The generation of requests sent to the platform and the processing of responses and callbacks received from the platform must be carried out with the use of the UTF-8 encoding. Besides that, in certain cases, it is required to use other encoding methods, including Base64. Such cases are stipulated in this documentation, including the article Parameters for opening payment form.

Dates and times

In the scope of interaction with the platform, dates and times are usually represented in the following format YYYY-MM-DDThh:mm:ss±hhmm (according to the ISO 8601 requirements), where YYYY-MM-DD is a date, T is a separating character, hh:mm:ss is a time, hhmm is a UTC (Coordinated Universal Time) offset. For example, 2025-05-25T15:30:25+0000.

Along with that, in certain cases, the date and time format can differ from the described one. Such cases are stipulated in this documentation, including the article Parameters for opening payment form.

Amounts

In the scope of interaction with the platform, payment and operation amounts are specified in the smallest currency units and with no decimal separator, For example, 100 dollars are represented in cents and specified as 10000 (but neither as 100 nor as 100.00). The examples of other currencies representation are provided in the table.

The number of fractional digits of different currencies is defined according to the ISO 4217 standard and provided in the currency reference.

Currency, country, and language codes

In the scope of interaction with the ecommpay payment platform, the following codes can be used:

• three-letter currency codes—according to the ISO 4217 standard
• two-letter country codes—according to the ISO 3166-1 standard
• single-, two-, and three-character territory codes (such as states, provinces, and regions)—according to the ISO 3166-2 standard
• language codes—containing two letters, according to the ISO 639-1 standard, or another number of letters, which can be coordinated with the ecommpay specialists and used, for example, for opening the payment form with texts in a certain dialect of a language

These codes, except for territory codes and language codes which should be defined individually, are provided in the references.