Шаблоны страниц оплаты

Требования к шаблонам

При создании собственных шаблонов страниц оплаты необходимо соблюдать перечисленные ниже требования и правила именования файлов.

Основные требования

  1. Передача ключа и параметров платежа. На странице оплаты должно присутствовать скрытое поле Key со значением {key}. Через него передаются параметры платежа.
  2. Передача дополнительных параметров. Дополнительные параметры могут быть переданы при инициализации сессии в объекте DATA. Для вывода значений на странице используется формат {param}, где {param} — имя параметра, указанное в нижнем регистре.
  3. Обработка ошибок. HTML-код страницы должен содержать блок с плейсхолдером {error} — он используется для отображения ошибок при ответе сервера в не-JSON формате. Для вывода ошибок при JSON-ответе необходимо использовать блок с id="errorTop".
  4. Размещение ресурсов. Все ссылки на используемые ресурсы (CSS, изображения и др.) должны иметь следующий вид: /Templates/{Key}/{File}, где {Key} — идентификатор продавца.
  5. Отсутствие внешних переходов. Шаблон не должен содержать ссылок, перенаправляющих пользователя на сторонние веб-сайты.
  6. Расположение файлов при использовании нескольких шаблонов. В случае применения нескольких шаблонов все ресурсы (CSS, JS, изображения и др.) должны храниться в общей папке.
  7. Запрет на использование внешних ресурсов. Не допускается подключение ресурсов, размещенных вне шаблона. Все изображения, файлы стилей и скрипты должны поставляться вместе с шаблонами и храниться локально.
  8. Поддержка нескольких языков. При необходимости можно использовать многоязычные шаблоны. В этом случае язык передается через параметр {Language} в составе объекта DATA при инициализации сессии.

Имена файлов

При использовании нескольких языков в шаблонах параметр {Language} должен подставляться в путь к файлам. Поддерживаются два стандартных значения:

  • Default — русский язык (значение по умолчанию)
  • English — английский язык

Структура путей к локализованным файлам должна иметь вид:

/Templates/{Key}/{Language}/{File}

где:

  • {Key} — идентификатор продавца
  • {Language} — язык интерфейса (Default или English)
  • {File} — имя файла шаблона, изображения, стиля или скрипта

Если требуется поддержка других языков, можно самостоятельно создать дополнительные каталоги в рамках своей библиотеки шаблонов, следуя той же структуре. Использование новых языков полностью остается на усмотрение клиента и не регулируется платформой.

Имя файла шаблона должно формироваться согласно следующей схеме:

[CUSTOMERS]VWMerchant-Add-MyCustom-English.template
Часть имениЗначение
[CUSTOMERS]Префикс интерфейса:
MERCHANT — для интерфейса InPay
CUSTOMERS — для интерфейса eWallet
VWMerchantНаименование терминала в системе. По умолчанию Merchant
AddТип шаблона:
Pay — шаблон оплаты
Add — шаблон привязки карты
Return — страница возврата (открывается после 3DS-проверки)
MyCustomНазвание шаблона, если используется несколько шаблонов. По умолчанию Default
EnglishЯзык шаблона, если используются шаблоны на разных языках. По умолчанию Default
.templateРасширение файла шаблона