Форматы и типы данных
Кодировка 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.
Курсы валют перечисленных банков обновляются один раз в день, а сервиса Currencylayer — каждые шесть часов.
Для каждого проекта используется один базовый источник курсов валют и дополнительные — на случаи, когда необходимый курс не предоставляется со стороны базового источника. Базовый источник может быть выбран со стороны ECommPay или со стороны мерчанта, через обращение в техническую поддержку. Для выбора необходимого источника валютных курсов следует обращаться к специалистам технической поддержки — support@ecommpay.com.
Информацию о конвертации, выполненной на стороне платёжной платформы, можно получать в оповещениях о результатах платежей, в интерфейсе Old Dashboard и в регулярных отчётах, отправляемых на заданные адреса электронной почты. Эту информацию рекомендуется учитывать при сверках с ECommPay, потому что учёт операций по счёту мерчанта со стороны эмитента или альтернативной платёжной системы, как правило, ведётся в валюте этого счёта.