Использование плагина ecommpay payments для CMS PrestaShop
В данной инструкции описана работа с плагином ecommpay payments версии 1.0. Этот плагин позволяет проводить оплаты и возвраты с использованием платёжных решений ecommpay на сайтах, созданных на базе CMS PrestaShop версии 1.7 или выше.
Скачать плагин ecommpay payments можно на портале GitHub.
Схема работы
Проведение платежей осуществляется через платёжную страницу ecommpay, а проведение возвратов — через клиентский интерфейс PrestaShop при выборе Refund ecommpay.
Запросы на открытие платёжной страницы формируются автоматически (с помощью плагина) при выборе ecommpay в методах оплаты.
Если по какой-либо причине платёж не прошёл, у пользователя есть возможность повторно ввести данные на платёжной странице.
По результатам проведения платежей и возвратов на сайт отправляются оповещения, которые также автоматически обрабатываются с помощью плагина. В соответствии с результатом платежа изменяется статус заказа:
- Pending — платёж не прошёл.
- Approved без изменения суммы заказа — платёж прошёл.
- Approved с изменением суммы заказа — частичный возврат прошёл.
- Возмещено — полный возврат прошёл.
- Partially refunded — частичный возврат прошёл.
Подключение
Для подключения плагина необходимо:
- Открыть PrestaShop.
- Перейти на вкладку .
- Щёлкнуть кнопку ЗАГРУЗИТЬ МОДУЛЬ и выбрать архив с плагином.
- Убедиться, что появилось сообщение Модуль установлен!
Тестирование
По умолчанию при активации плагина используется тестовый режим. Этот режим позволяет ознакомиться с работой плагина на сайте, к которому он подключён, без проведения реальных операций. В тестовом режиме можно настраивать и проверять работу плагина, проводить тестовые заказы, полный и частичный возвраты и просматривать информацию по ним.
Настройка
Для настройки параметров работы плагина в тестовом режиме необходимо:
- Перейти на вкладку .
- Выбрать ecommpay payments и щёлкнуть кнопку НАСТРОЙКА.
- Задать необходимые настройки (см. далее).
- Убедиться, что установлен флажок Test mode.
- Щёлкнуть кнопку Save Settings.
Параметры работы плагина включают в себя:
- Параметры работы платёжной страницы ecommpay при её отображении:
- Title — название метода оплаты на сайте.
- Описание — описание метода оплаты на сайте.
- Currency — валюта платёжной страницы.
- Language — язык платёжной страницы.
- Popup mode — способ отображения платёжной страницы: во всплывающем окне или в той же вкладке.
- Additional parameters — дополнительные параметры работы платёжной страницы.
Список этих параметров доступен здесь. При задании нескольких параметров их необходимо записывать с разделителем «&».
- Параметры Project ID и Secret key для подключения к платёжным решениям ecommpay.
В тестовом режиме эти параметры не используются.
Проведение тестовых заказов
После настройки параметров работы плагина следует провести тестовые заказы на сайте и проверить информацию по этим заказам в PrestaShop, на вкладке .
Проведение тестовых возвратов
После проведения тестовых заказов следует провести тестовые возвраты и проверить изменение статуса заказа и суммы в PrestaShop, на вкладке .
- Перейти на вкладку Заказы.
- Выбрать необходимый заказ. Статус заказа должен быть Approved.
- Щёлкнуть кнопку Частичное возмещение.
- Ввести сумму для возврата.
- Выбрать флажок
Refund ecommpay
и щёлкнуть кнопку Частичное возмещение.
После проведения возврата сумма заказа должна измениться на сумму возврата, а также должно появиться сообщение Частичный возврат средств успешно создан.
Запуск
После проверки работы плагина с использованием всех планируемых способов оплаты его можно переводить в рабочий режим. Для этого необходимо получить рабочие параметры и скорректировать настройки.
Получение рабочих параметров
Для получения параметров подключения к платёжным решениям ecommpay необходимо:
- Связаться со службой технической поддержки ecommpay и сообщить следующие параметры:
- название и URL сайта,
- валюту платёжной страницы,
- URL для приёма оповещений (URL, указанный на вкладке Настройка).
- Получить от службы технической поддержки ecommpay значения следующих параметров:
- Project ID — идентификатор сайта.
- Secret key — секретный ключ, который генерируется для конкретного мерчанта на стороне ecommpay.
Задание рабочих настроек
Для задания рабочих настроек необходимо:
- Открыть PrestaShop.
- Перейти на вкладку .
- Выбрать ecommpay payments и щёлкнуть кнопку НАСТРОЙКА.
- Задать рабочие настройки:
- Снять флажок Test mode.
- Заполнить поля Project ID и Secret key в соответствии со значениями, полученными от службы технической поддержки ecommpay.
- Убедиться, что для остальных параметров заданы необходимые значения.
- Щёлкнуть кнопку Save Settings.
Использование
После запуска плагина он работает автономно.
Мы рекомендуем контролировать проведение заказов на вкладке Pending.
, а также следить, чтобы номера заказов были уникальными в рамках сайта. При дублировании номера заказа платёжная страница не открывается и заказ остаётся со статусомЕсли после запуска плагина появляется необходимость переключить его в тестовый режим, следует обратить внимание на отображение метода оплаты на сайте. При установке флажка Test mode метод оплаты с помощью платёжной страницы ecommpay отображается на сайте, но все платежи проводятся как тестовые.
Перед переводом плагина обратно в рабочий режим, необходимо убедиться, что поля Project ID и Secret key заполнены в соответствии со значениями, полученными от службы технической поддержки ecommpay.
При возникновении вопросов по работе плагина следует обращаться в службу технической поддержки ecommpay support@ecommpay.com.