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

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

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


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

Инструкция по установке
1. Скачайте последнюю версию плагина.
2. Убедитесь, что ваш магазин использует BYN валюту с ISO кодом 933, в противном случае плагин не будет функционировать.
3. Перейдите в back-офис вашего магазина, затем выберите вкладку "Модули"->"Модули и сервисы", после чего нажмите "Добавить модуль" и загрузите скачанный .zip файл.
4. После загрузки модуля нажмите на кнопку "Установить" и настройте модуль используя данные полученные на сайте express-pay.by.
5. Установив модуль не забудьте отключить "Тестовый режим".
6. Перейдите в раздел "Модули"->"Способ оплаты" и установите BYN валюту для установленного модуля.

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


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

Инструкция по установке
1. Скачайте последнюю версию плагина.Распакуйте архив. В архиве находятся два модуля. Модуль "expresspay" для оплаты через систему ЕРИП и модуль "expresspaycard" для оплаты через интернет-эквайринг.
2. Убедитесь, что ваш магазин использует BYN валюту с ISO кодом 933, в противном случае плагин не будет функционировать.
3. Перейдите в back-офис вашего магазина, затем выберите вкладку "Модули"->"Модули и сервисы", после чего нажмите "Добавить модуль" и загрузите нужный .zip файл.
4. После установки настройте модуль используя данные полученные на сайте express-pay.by.
5. Установив модуль не забудьте отключить "Тестовый режим".
6. Перейдите в раздел "Оплата"->"Настройки" и установите BYN валюту для установленного модуля.

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


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

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

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

2. Перейти в раздел "Модули" => "Module Manager"(Рисунок 1).

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

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

3. Нажать кнопку «Загрузить» (Рисунок 2).

Рисунок 2 – кнопка «Загрузить модуль»

Рисунок 2 – кнопка «Загрузить модуль»

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

Рисунок 3 – «Окно выбора модуля»

Рисунок 3 – «Окно выбора модуля»

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

5.1 Прокручиваем страницу «Module manager» до конца нажимаем кнопку «Настроить» напротив платёжного модуля.

Рисунок 4 – кнопка «Настроить»

Рисунок 4 – кнопка «Настроить»

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

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

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

Рисунок 6 – значение для заполнения полей «API-ключ (токен) доступа к API»

Рисунок 6 – значение для заполнения полей «API-ключ (токен) доступа к API»

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

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

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

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

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

5.4 Включение опции «Показывать Qr-код» позволяет отображать Qr-код для оплаты через мобильные приложения банков.

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

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

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

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

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

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

5.10 Значение из поля «Путь к ЕРИП» будет отображаться плательщику при выводе информации о заказе, которое содержит путь по ветке ЕРИП.

5.11 Значение из поля «Сообщение при успешном заказе» будет отображаться плательщику при выводе информации о заказе.

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

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

6.1 Переведите переключатель «Работа в тестовом режиме» в положение «Да».

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

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

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