;

Расширение для CMS ModX

Инструкция по установке

Скопировать папки "assets" и "core", находящиеся в папке "ERIP", в корневую директорию сайта.

Перейти в вкладку «Администрирование» на сайте.

Перейти в раздел "Ресурсы", нажать кнопку «Новый документ» (Рисунок 1).

Рисунок 1 - кнопка «Новый документ»

Рисунок 1 - кнопка «Новый документ»

Заполнить поля (Рисунок 3):

Заголовок: Результат

Шаблон: Основной

Скрыть из меню: Да

ВАЖНО!!! Обязательно запишите ID ресурса (Рисунок 2), это значение понадобится для дальнейшей настройки модуля

Рисунок 2 - ID ресурса

Рисунок 2 - ID ресурса

Рисунок 3 - новый документ

Рисунок 3 - новый документ

Настраиваем платежную систему:

В административной панели перейти "Пакеты" => "miniShop2"=> "Настройки" (Рисунок 4).

Рисунок 4 - раздел «Настройки»

Рисунок 4 - раздел «Настройки»

Перейти "Способы оплаты" -> "Создать" (Рисунок 5).

Рисунок 5 - создание платежной системы

Рисунок 5 - создание платежной системы

Заполнить поля (Рисунок 6):

Имя: ЕРИП

Класс-обработчик: Erip

Поставить галочку "Включен"

Рисунок 6 - настройка платежной системы

Рисунок 6 - настройка платежной системы

Далее переходим на вкладку "Варианты доставки" и выбираем необходимые варианты доставки.

В административной панели перейти "Системные настройки" (Рисунок 7)

Рисунок 7 - раздел «Системные настройки»

Рисунок 7 - раздел «Системные настройки»

Нажать кнопку «Создать новый параметр» (Рисунок 8).

Рисунок 8 - кнопка «Создать новый параметр»

Рисунок 8 - кнопка «Создать новый параметр»

Создать и заполнить поля параметров (Рисунок 9 - 20).

Ключ: EXPRESS_PAY_RESOURCE_ID

Название: ID ресурса для формирования результирующей страницы

Тип поля: Текстовое поле

Пространство имён: minishop2

Значение: (вводим ID ранее созданного ресурса)

Рисунок 9 - параметр  «ID ресурса для формирования результирующей страницы»

Рисунок 9 - параметр «ID ресурса для формирования результирующей страницы»

Ключ: EXPRESS_PAY_SERVICE_ID_ERIP

Название: Номер услуги ЕРИП

Описание: Номер услуги ЕРИП в сервисе express-pay.by

Тип поля: Текстовое поле

Пространство имён: minishop2

Значение: (вводим номер услуги ЕРИП предоставленный в личном кабинете сервиса «Экспресс Платежи»)

Рисунок 10 - параметр  «Номер услуги ЕРИП»

Рисунок 10 - параметр «Номер услуги ЕРИП»

Ключ: EXPRESS_PAY_TOKEN_ERIP

Название: Токен для ЕРИП

Описание: Токен для ЕРИП, который предоставляет сервис express-pay.by

Тип поля: Текстовое поле

Пространство имён: minishop2

Значение: (вводим API-ключ услуги ЕРИП предоставленный в личном кабинете сервиса «Экспресс Платежи»)

Рисунок 11 - параметр  «Токен для ЕРИП»

Рисунок 11 - параметр «Токен для ЕРИП»

Ключ: EXPRESS_PAY_TEST_MODE

Название: Использовать тестовый режим

Описание: Использовать тестовый режим в котором взаимодействие происходит с тестовым сервером

Тип поля: Да/Нет

Пространство имён: minishop2

Рисунок 12 - параметр  «Использовать тестовый режим»

Рисунок 12 - параметр «Использовать тестовый режим»

Ключ: EXPRESS_PAY_SECRET_WORD_ERIP

Название: Секретное слово для формирования цифровой подписи

Описание: Секретное для ЕРИП слово которое, известно только серверу и клиенту. Используется для формирования цифровой подписи. Задается в кабинете пользователя сервиса express-pay.by

Тип поля: Текстовое поле

Пространство имён: minishop2

Значение: (секретное слово введенное в личном кабинете пользователя)

Рисунок 13 - параметр  «Секретное слово для формирования цифровой подписи»

Рисунок 13 - параметр «Секретное слово для формирования цифровой подписи»

Ключ: EXPRESS_PAY_IS_USE_SIGNATURE_FROM_NOTIFICATION_ERIP

Название: Использовать цифровую подпись для получения уведомлений

Описание: Значение должно соответствовать значению установленному в личном кабинете

Тип поля: Да/Нет

Пространство имён: minishop2

Значение: (секретное слово введенное в личном кабинете пользователя)

Рисунок 14 - параметр  «Использовать цифровую подпись для получения уведомлений»

Рисунок 14 - параметр «Использовать цифровую подпись для получения уведомлений»

Ключ: EXPRESS_PAY_SECRET_WORD_FROM_NOTIFICATION_ERIP

Название: Секретное слово для получения уведомлений

Описание: Секретное для уведомлений слово которое, известно только серверу и клиенту. Используется для формирования цифровой подписи. Задается в кабинете пользователя сервиса express-pay.by

Тип поля: Текстовое поле

Пространство имён: minishop2

Значение: (секретное слово введенное в личном кабинете пользователя)

Рисунок 15 - параметр «Секретное слово для получения уведомлений»

Рисунок 15 - параметр «Секретное слово для получения уведомлений»

Ключ: EXPRESS_PAY_PATH_TO_ERIP

Название: Путь по ветке ЕРИП

Описание: Задается при подключении. Указано в личном кабинете

Тип поля: Текстовое поле

Пространство имён: minishop2

Значение: (Путь ветки ЕРИП указанный в личном кабинете пользователя)

Рисунок 16 - параметр «Путь по ветке ЕРИП»

Рисунок 16 - параметр «Путь по ветке ЕРИП»

Ключ: EXPRESS_PAY_IS_NAME_EDITABLE

Название: Разрешено изменять ФИО плательщика

Описание: Разрешено изменять ФИО плательщика при оплате в системе ЕРИП

Тип поля: Да/Нет

Пространство имён: minishop2

Рисунок 17 - параметр «Разрешено изменять ФИО плательщика»

Рисунок 17 - параметр «Разрешено изменять ФИО плательщика»

Ключ: EXPRESS_PAY_IS_ADRESS_EDITABLE

Название: Разрешено изменять адрес плательщика

Описание: Разрешено изменять адрес плательщика при оплате в системе ЕРИП

Тип поля: Да/Нет

Пространство имён: minishop2

Рисунок 18 - параметр «Разрешено изменять адрес плательщика»

Рисунок 18 - параметр «Разрешено изменять адрес плательщика»

Ключ: EXPRESS_PAY_IS_AMOUNT_EDITABLE

Название: Разрешено изменять сумму оплаты

Описание: Разрешено изменять сумму оплаты при оплате в системе ЕРИП

Тип поля: Да/Нет

Пространство имён: minishop2

Рисунок 19 - параметр «Разрешено изменять сумму оплаты»

Рисунок 19 - параметр «Разрешено изменять сумму оплаты»

Ключ: EXPRESS_SHOW_QR_CODE

Название: Показывать Qr-код

Описание: Показывать ли Qr-код для оплаты в мобильных приложениях банков

Тип поля: Да/Нет

Пространство имён: minishop2

Рисунок 20 - параметр «Показывать Qr-код»

Рисунок 20 - параметр «Показывать Qr-код»

Настройка модуля, для работы в тестовом режиме:

Установите флажок в поле «Использовать тестовый режим» в положение «Да».

В полях «API-ключ (токен) доступа к API» и «Номер услуги в сервисе «Экспресс Платежи» введите значения, которые доступны по следующей ссылке.

Поле «Секретное слово для цифровой подписи» заполняется только в том случае, если был выбран API ключ с параметрами«Применять цифровую подпись» и «Секретное слово».

Оставшиеся поля можно оставить без изменений, поскольку на работу модуля в тестовом режиме они не влияют

Настройка модуля, для работы:

Убрать флажок в поле «Работа в тестовом режиме».

Поля «API-ключ (токен) доступа к API» и «Номер услуги в сервисе «Экспресс Платежи» заполнить значениями, которые указаны в Личном кабинете сервиса «Экспресс Платежи» в разделе «Настройка» -> «Услуги» -> «API» (Рисунок 21, Рисунок 22)

Рисунок 21 – раздел «API» в настройках услуг в личном кабинете сервиса «Экспресс Платежи»

Рисунок 21 – раздел «API» в настройках услуг в личном кабинете сервиса «Экспресс Платежи»

Рисунок 22 – значение для заполнения полей «API-ключ (токен) доступа к API» и «Номер услуги в сервисе «Экспресс Платежи»

Рисунок 22 – значение для заполнения полей «API-ключ (токен) доступа к API» и «Номер услуги в сервисе «Экспресс Платежи»

В разделе «Настройка» -> «Услуги» -> «API» личного кабинета сервиса «Экспресс Платежи» включите опцию «Применять цифровую подпись» и укажите значения в поле «Секретное слово». Значение из поля «Секретное слово» также следует указать в поле «Секретное слово для цифровой подписи» настройки новой платежной системы на вашем сайте.

Значение [адрес_вашего_сайта]/assets/components/minishop2/payment/erip.php необходимо скопировать в личный кабинет сервиса «Экспресс Платежи» в раздел «Настройка» -> «Услуги» -> «Уведомления» (Рисунок 23). Значение необходимо поместить в поле «URL для уведомлений», предварительно включив опцию «Получать уведомления об оплате на URL» (Рисунок 24). Данная опция позволяет автоматически изменять статус заказа после оплаты.

Рисунок 23 – раздел «Уведомления» в настройках услуг в личном кабинете сервиса «Экспресс Платежи»

Рисунок 23 – раздел «Уведомления» в настройках услуг в личном кабинете сервиса «Экспресс Платежи»

Рисунок 24 – включение уведомлений об оплате на сайт

Рисунок 24 – включение уведомлений об оплате на сайт

Поля «Использовать цифровую подпись при получении уведомлений» и «Секретное слово для цифровой подписи уведомлений» используются для формирования цифровой подписи. Формирование цифровой подписи для передаваемых данных обеспечивает целостность информации и гарантирует, что передаваемые данные не были изменены посторонними лицами в процессе передачи.

При включении данной опции, значения в полях «Секретное слово для цифровой подписи уведомлений» в настройках платежной системы сайта ModX и «Секретное слово» в личном кабинете сервиса «Экспресс Платежи» в разделе «Настройка» -> «Услуги» -> «Уведомления» должны быть одинаковыми.

Значение из поля «Путь ветки ЕРИП услуги» будет отображаться клиенту после формирования заказа и выставления счета в системе «Расчет» (Рисунок 25).

Рисунок 25 - путь ветки ЕРИП услуги при формировании заказа

Рисунок 25 – путь ветки ЕРИП услуги при формировании заказа

Включение опции «Разрешено изменять ФИО плательщика» позволяет плательщику изменять ФИО при оплате заказа в дереве ЕРИП.

Включение опции «Разрешено изменять адрес плательщика» позволяет плательщику изменять адрес при оплате заказа в дереве ЕРИП.

Включение опции «Разрешено изменять сумму оплаты» позволяет плательщику изменять сумму при оплате заказа в дереве ЕРИП.

Включение опции «Показывать Qr-код» позволяет отображать клиенту после формирования заказа Qr-код для оплаты в мобильных приложениях банка. (Рисунок 26).

Рисунок 26 - отображение Qr-кода для оплаты

Рисунок 26 – отображение Qr-кода для оплаты