Шаблоны страниц оплаты
Требования к шаблонам
При создании собственных шаблонов страниц оплаты необходимо соблюдать перечисленные ниже требования и правила именования файлов.
Основные требования
- Передача ключа и параметров платежа. На странице оплаты должно присутствовать скрытое поле
Keyсо значением{key}. Через него передаются параметры платежа. - Передача дополнительных параметров. Дополнительные параметры могут быть переданы при инициализации сессии в объекте
DATA. Для вывода значений на странице используется формат{param}, где{param}— имя параметра, указанное в нижнем регистре. - Обработка ошибок. HTML-код страницы должен содержать блок с плейсхолдером
{error}— он используется для отображения ошибок при ответе сервера в не-JSON формате. Для вывода ошибок при JSON-ответе необходимо использовать блок сid="errorTop". - Размещение ресурсов. Все ссылки на используемые ресурсы (CSS, изображения и др.) должны иметь следующий вид:
/Templates/{Key}/{File}, где{Key}— идентификатор продавца. - Отсутствие внешних переходов. Шаблон не должен содержать ссылок, перенаправляющих пользователя на сторонние веб-сайты.
- Расположение файлов при использовании нескольких шаблонов. В случае применения нескольких шаблонов все ресурсы (CSS, JS, изображения и др.) должны храниться в общей папке.
- Запрет на использование внешних ресурсов. Не допускается подключение ресурсов, размещенных вне шаблона. Все изображения, файлы стилей и скрипты должны поставляться вместе с шаблонами и храниться локально.
- Поддержка нескольких языков. При необходимости можно использовать многоязычные шаблоны. В этом случае язык передается через параметр
{Language}в составе объектаDATAпри инициализации сессии.
Имена файлов
При использовании нескольких языков в шаблонах параметр {Language} должен подставляться в путь к файлам. Поддерживаются два стандартных значения:
- Default — русский язык (значение по умолчанию)
- English — английский язык
Структура путей к локализованным файлам должна иметь вид:
/Templates/{Key}/{Language}/{File}где:
{Key}— идентификатор продавца{Language}— язык интерфейса (DefaultилиEnglish){File}— имя файла шаблона, изображения, стиля или скрипта
Если требуется поддержка других языков, можно самостоятельно создать дополнительные каталоги в рамках своей библиотеки шаблонов, следуя той же структуре. Использование новых языков полностью остается на усмотрение клиента и не регулируется платформой.
Имя файла шаблона должно формироваться согласно следующей схеме:
[CUSTOMERS]VWMerchant-Add-MyCustom-English.template| Часть имени | Значение |
|---|---|
[CUSTOMERS] | Префикс интерфейса:MERCHANT — для интерфейса InPayCUSTOMERS — для интерфейса eWallet |
VWMerchant | Наименование терминала в системе. По умолчанию Merchant |
Add | Тип шаблона:Pay — шаблон оплатыAdd — шаблон привязки картыReturn — страница возврата (открывается после 3DS-проверки) |
MyCustom | Название шаблона, если используется несколько шаблонов. По умолчанию Default |
English | Язык шаблона, если используются шаблоны на разных языках. По умолчанию Default |
.template | Расширение файла шаблона |
