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

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

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

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

Прим.: Данную статью в будущем планируется исключить из состава документации.

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

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

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

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

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

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

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

Валюта Сумма Представление
EUR 39,95 3995
GBP 450,66 45066
JPY 200 200
KWD 150,155 150155

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

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

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

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

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