Форматы данных

Общая информация

В этой статье представлены основные сведения о способах кодирования и форматах записи данных, используемых при работе с платёжной платформой ecommpay.

Информацию об общих подходах к формированию запросов, ответов и оповещений можно найти в статье Организация взаимодействия, информацию о служебных кодах, идентифицирующих элементы различных реестров — в разделе Справочники, детальную информацию об особенностях, характерных для отдельных случаев — в статьях о соответствующих возможностях и в статье Параметры вызова платёжной формы. Также при возникновении вопросов можно обращаться к специалистам технической поддержки.

Кодирование данных

При формировании запросов к платформе и при обработке полученных от платформы ответов и оповещений должна использоваться кодировка UTF-8. Кроме того, в некоторых случаях должны дополнительно применяться другие способы кодирования, в частности Base64. Такие случаи отдельно оговариваются в рамках настоящей документации, в том числе в статье Параметры вызова платёжной формы.

Указание даты и времени

При работе с платформой дата и время, как правило, указываются в формате ГГГГ-ММ-ДДTчч:мм:сс±ччмм (в соответствии с требованиями стандарта ISO 8601), где ГГГГ-ММ-ДД — дата, T — служебный символ, чч:мм:сс — время, ччмм — отклонение от всемирного координированного времени. Например, 2025-05-25T15:30:25+0000.

Вместе с тем, в некоторых случаях дата и время могут указываться иначе. Такие случаи отдельно оговариваются в рамках настоящей документации, в том числе в статье Параметры вызова платёжной формы.

Указание сумм

Суммы платежей и операций при работе с платформой указываются в дробных единицах валюты, без применения десятичного разделителя. Например, 100 долларов представляются в центах и указываются как 10000 (но не 100 и не 100,00). Примеры для ряда других валют представлены в таблице.

Количество дробных разрядов для разных валют определяется в соответствии со стандартом ISO 4217 и представлено в справочнике валют.

Указание кодов валют, стран и языков

При работе с платёжной платформой ecommpay могут применяться:

• трёхбуквенные коды валют — в соответствии со стандартом ISO 4217;
• двухбуквенные коды стран — в соответствии со стандартом ISO 3166-1;
• одно-, двух- и трёхсимвольные коды территорий (таких как штаты, провинции и регионы) — в соответствии стандартом ISO 3166-2;
• коды языков — двухбуквенные в соответствии со стандартом ISO 639-1 или иные, согласованные со специалистами ecommpay и используемые, например, для открытия платёжной формы на определённом диалекте того или иного языка.

Перечни таких кодов, за исключением кодов территорий и кодов языков, согласуемых отдельно, приведены в справочниках.