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

Кодировка UTF-8

Old Dashboard использует UTF-8 кодировку для запросов и ответов. Таким образом, все передаваемые в Old Dashboard данные должны быть сконвертированы в UTF-8; все получаемые от Old Dashboard данные также будут переданы в формате UTF-8.

Суммы платежей

Все суммы платежей, передаваемые в запросах или полученные в ответах и оповещениях, передаются целочисленным значением в минорных единицах валюты в соответствии с ISO 4217; размер дробной части приведен в таблице Active codes, столбец E.

Минорной единицей валюты называется часть номинальной единицы валюты, обычно, 1/100. Например, 1 цент США равен 1/100 доллара США. Примеры соотношения номинальных и минорных единиц валют приведены в таблице ниже.

Сумма в номинальных единицах валюты Сумма в минорных единицах валюты
450,66 GBP 45066
39,95 USD 3995
200 JPY 200
150,155 KWD 150155

Страны

При передаче информации о странах Old Dashboard получает и передает код страны в соответствии с ISO 3166-1 alpha-2.

Даты и время

  • В запросах дата и время передаются в формате YYYY-MM-DD hh:mm:ss в соответствии с ISO 8601. Часовой пояс передаётся отдельно в виде трёхбуквенного кода (List of time zone abbreviations).
  • В ответах дата и время передаются в UTC+0 в соответствии с ISO 8601. Например, 2017-07-21T03:31:24+0000.

Валюты

Все валюты, передаваемые на Old Dashboard или полученные в ответах, передаются в соответствии со стандартом ISO 4217 alpha-3.

Конвертация валют

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

Допустим, специалист мерчанта выполняет перевод средств в евро со счёта мерчанта, открытого в фунтах стерлингов, на счёт пользователя, открытый в рублях. В таком случае сумма платежа последовательно конвертируется из фунтов в евро и из евро в рубли. Первый из этих пересчётов выполняется на стороне платёжной платформы ECommPay, а второй — на стороне эмитента (и не контролируется со стороны ECommPay).

Конвертация, выполняемая на стороне ECommPay, поддерживается для любых платёжных методов. Для такой конвертации используются валютные курсы одного из следующих источников:

Курсы валют перечисленных банков обновляются один раз в день, а сервиса Currencylayer — каждые шесть часов.

Для каждого проекта используется один базовый источник курсов валют и дополнительные — на случаи, когда необходимый курс не предоставляется со стороны базового источника. Базовый источник может быть выбран со стороны ECommPay или со стороны мерчанта, через обращение в техническую поддержку. Для выбора необходимого источника валютных курсов следует обращаться к специалистам технической поддержки — support@ecommpay.com.

Информацию о конвертации, выполненной на стороне платёжной платформы, можно получать в оповещениях о результатах платежей, в интерфейсе Old Dashboard и в регулярных отчётах, отправляемых на заданные адреса электронной почты. Эту информацию рекомендуется учитывать при сверках с ECommPay, потому что учёт операций по счёту мерчанта со стороны эмитента или альтернативной платёжной системы, как правило, ведётся в валюте этого счёта.