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

Расширение для CMS Modx для интеграции с сервисом «Экспресс Платежи» через API. Расширение позволяет выставить счет в системе ЕРИП, получить и обработать уведомление о платеже в системе ЕРИП.

Версия расширения
1.0


Описание
Нажмите для увеличения

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

Настройка платежного модуля для работы с ЕРИП

Настройка платежного модуля для работы с Интернет-эквайрингом

1.Настройка платежного модуля для работы с ЕРИП

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Имя: ЕРИП

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

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

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

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

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

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

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

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

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

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

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

1.5.7 Создать и заполнить поля параметров (Рисунок 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-код»

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

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

1.5.8.2 В полях «API-ключ (токен) доступа к API» и «Номер услуги в сервисе «Экспресс Платежи» введите значения, которые доступны по следующей ссылке: https://express-pay.by/docs/api/v1#sandbox

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

2.Настройка платежного модуля для работы с Интернет-эквайрингом

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

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

2.3 Если вы создавали ресурс для отображения результирующей страницы используйте его же ID, если вы не создавали ресурс обратитесь к пунктам 1.3-1.4 настоящей инструкции

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

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

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

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

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

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

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

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

Имя: Интернет-эквайринг

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

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

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

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

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

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

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

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

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

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

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

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

Примечание: Если вы уже создавали данный параметр то пересоздавать его не нужно.

Ключ: EXPRESS_PAY_RESOURCE_ID

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

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

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

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

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

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

Ключ: EXPRESS_PAY_SERVICE_ID_CARD

Название: Номер услуги интернет-эквайринга

Описание: Номер услуги интернет-эквайринга в сервисе express-pay.by

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

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

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

Рисунок 7 - параметр  «Номер услуги интернет-эквайринга»

Рисунок 7 - параметр «Номер услуги интернет-эквайринга»

Ключ: EXPRESS_PAY_TOKEN_CARD

Название: Токен для интернет-эквайринга

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

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

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

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

Рисунок 8 - параметр  «Номер услуги интернет-эквайринга»

Рисунок 8 - параметр «Номер услуги интернет-эквайринга»

Примечание: Если вы уже создавали данный параметр то пересоздавать его не нужно.

Ключ: EXPRESS_PAY_TEST_MODE

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

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

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

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

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

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

Ключ: EXPRESS_PAY_SECRET_WORD_CARD

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

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

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

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

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

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

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

Ключ: EXPRESS_PAY_IS_USE_SIGNATURE_FROM_NOTIFICATION_CARD

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

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

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

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

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

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

Ключ: EXPRESS_PAY_SECRET_WORD_FROM_NOTIFICATION_CARD

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

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

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

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

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

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

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

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

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

2.4.8.2 В полях «API-ключ (токен) доступа к API» и «Номер услуги в сервисе «Экспресс Платежи» введите значения, которые доступны по следующей ссылке: https://express-pay.by/docs/api/v1#sandbox

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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


Версия расширения
1.0


Описание
Ниже на изображении представлен пример работы расширения в администраторской части CMS ModX Evotution Commerce
Модули для CMS Modx для приема платежей
Нажмите для увеличения

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

Настройка приложения для работы с ЕРИП

Настройка приложения для работы с Интернет-эквайрингом

Настройка приложения для работы с E-POS

1.Настройка платежного модуля для работы с ЕРИП

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

1.2 Перейти в раздел «Модули» => «Extras»(Рисунок 1).

Рисунок 1 – раздел «Extras»

Рисунок 1 – раздел «Extras»

1.3 Нажать кнопку «Выберите файл» (Рисунок 2).

Рисунок 2 – кнопка «Выберите файл»

Рисунок 2 – кнопка «Выберите файл»

1.4 Выбрать необходимый модуль (Рисунок 3).

Рисунок 3 – кнопка «Окно выбора плагина»

Рисунок 3 – кнопка «Окно выбора плагина»

1.5 Нажать кнопку «Установить».

1.7 Перейти в раздел «Элементы» => «Плагины» => «Payment ExpressPay_Erip»(Рисунок 4).

Рисунок 4 – выбор плагина

Рисунок 4 – выбор плагина

1.7 Перейти в раздел «Конфигурация».

1.8 Настраиваем платежный плагин:

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

1.8.1.1 Из выпадающего списка «Использовать тестовый режим» выбрать пункт «Да».

1.8.1.2 В полях «API-ключ (токен) доступа к API» и «Номер услуги»введите значения, которые доступны по следующей ссылке: https://express-pay.by/docs/api/v1#sandbox

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

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

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

1.8.2.1 Из выпадающего списка «Использовать тестовый режим» выбрать пункт «Да».

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

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

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

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

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

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

1.8.2.4 Значение из поля «Адрес для получения уведомлений» необходимо скопировать в личный кабинет сервиса «Экспресс Платежи» в раздел «Настройка» -> «Услуги» -> «Уведомления» (Рисунок 7). Значение необходимо поместить в поле «URL для уведомлений», предварительно включив опцию «Получать уведомления об оплате на URL» (Рисунок 8). Данная опция позволяет автоматически изменять статус заказа после оплаты.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

1.8.4 После настройки модуля нажмите кнопку «Сохранить+Продолжить».

2.Настройка платежного модуля для работы с Интернет-эквайрингом

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

2.2 Перейти в раздел «Модули» => «Extras»(Рисунок 1).

Рисунок 1 – раздел «Extras»

Рисунок 1 – раздел «Extras»

2.3 Нажать кнопку «Выберите файл» (Рисунок 2).

Рисунок 2 – кнопка «Выберите файл»

Рисунок 2 – кнопка «Выберите файл»

2.4 Выбрать необходимый модуль (Рисунок 3).

Рисунок 3 – кнопка «Окно выбора плагина»

Рисунок 3 – кнопка «Окно выбора плагина»

2.5 Нажать кнопку «Установить».

2.6 Перейти в раздел «Элементы» => «Плагины» => «Payment ExpressPay_Erip»(Рисунок 4).

Рисунок 4 – выбор плагина

Рисунок 4 – выбор плагина

2.7 Перейти в раздел «Конфигурация».

2.8 Настраиваем платежный плагин:

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

2.8.1.1 Из выпадающего списка «Использовать тестовый режим» выбрать пункт «Да».

2.8.1.2 В полях «API-ключ (токен) доступа к API» и «Номер услуги»введите значения, которые доступны по следующей ссылке: https://express-pay.by/docs/api/v1#sandbox

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

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

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

2.8.2.1 Из выпадающего списка «Использовать тестовый режим» выбрать пункт «Да».

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

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

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

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

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

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

2.8.2.4 Значение из поля «Адрес для получения уведомлений» необходимо скопировать в личный кабинет сервиса «Экспресс Платежи» в раздел «Настройка» -> «Услуги» -> «Уведомления» (Рисунок 7). Значение необходимо поместить в поле «URL для уведомлений», предварительно включив опцию «Получать уведомления об оплате на URL» (Рисунок 8). Данная опция позволяет автоматически изменять статус заказа после оплаты.

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

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

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

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

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

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

2.8.4 После настройки модуля нажмите кнопку «Сохранить+Продолжить».

3.Настройка платежного модуля для работы с E-POS

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

3.2 Перейти в раздел «Модули» => «Extras»(Рисунок 1).

Рисунок 1 – раздел «Extras»

Рисунок 1 – раздел «Extras»

3.3 Нажать кнопку «Выберите файл» (Рисунок 2).

Рисунок 2 – кнопка «Выберите файл»

Рисунок 2 – кнопка «Выберите файл»

3.4 Выбрать необходимый модуль (Рисунок 3).

Рисунок 3 – кнопка «Окно выбора плагина»

Рисунок 3 – кнопка «Окно выбора плагина»

3.5 Нажать кнопку «Установить».

3.6 Перейти в раздел «Элементы» => «Плагины» => «Payment ExpressPay_Erip»(Рисунок 4).

Рисунок 4 – выбор плагина

Рисунок 4 – выбор плагина

3.7 Перейти в раздел «Конфигурация».

3.8 Настраиваем платежный плагин:

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

3.8.1.1 Из выпадающего списка «Использовать тестовый режим» выбрать пункт «Да».

3.8.1.2 В полях «API-ключ (токен) доступа к API» и «Номер услуги»введите значения, которые доступны по следующей ссылке: https://express-pay.by/docs/api/v1#sandbox

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

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

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

3.8.2.1 Из выпадающего списка «Использовать тестовый режим» выбрать пункт «Да».

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

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

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

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

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

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

3.8.2.4 Значение из поля «Адрес для получения уведомлений» необходимо скопировать в личный кабинет сервиса «Экспресс Платежи» в раздел «Настройка» -> «Услуги» -> «Уведомления» (Рисунок 7). Значение необходимо поместить в поле «URL для уведомлений», предварительно включив опцию «Получать уведомления об оплате на URL» (Рисунок 8). Данная опция позволяет автоматически изменять статус заказа после оплаты.

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

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

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

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

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

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

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

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

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

3.8.4 После настройки модуля нажмите кнопку «Сохранить+Продолжить».