Использование плагина WooСommerce для CMS WordPress
В данной инструкции описана работа с плагином WooСommerce версии 1.0. Этот плагин позволяет проводить оплаты и возвраты с использованием платёжных решений ecommpay на сайтах, созданных на базе CMS WordPress версии 4.9 или выше с использованием плагина WooCommerce версии 3.2 или выше.
Скачать плагин WooСommerce можно здесь.
Схема работы
Проведение платежей осуществляется через платёжную страницу ecommpay, а проведение возвратов — через консоль при выборе Refund via
ecommpay.
Рис.: Схема проведения платежей с использованием плагина
Запросы на открытие платёжной страницы формируются автоматически (с помощью плагина) при выборе ecommpay в методах оплаты.
Если по какой-либо причине платёж не прошёл, у пользователя есть возможность повторно ввести данные на платёжной странице.
По результатам проведения платежей и возвратов на сайт отправляются оповещения, которые также автоматически обрабатываются с помощью плагина. В соответствии с результатом операции изменяется статус заказа:
- On hold — платёж не прошёл.
- Processing без изменения суммы заказа— платёж прошёл.
- Processing с изменением суммы заказа — частичный возврат прошёл.
- Refunded — полный возврат прошёл.
- Partially refunded — частичный возврат прошёл.
Подключение
Для подключения плагина необходимо:
- Открыть WordPress.
- Перейти на вкладку Plugins и щёлкнуть кнопку Add New.
- Щёлкнуть кнопку Upload Plugin.
- Выбрать архив с плагином и щёлкнуть кнопку Install Now.
- После установки плагина щёлкнуть кнопку Activate Plugin.
- Убедиться, что появилось сообщение Plugin activated.
Тестирование
По умолчанию при активации плагина используется тестовый режим. Этот режим позволяет ознакомиться с работой плагина на сайте, к которому он подключён, без проведения реальных операций. В тестовом режиме можно настраивать и проверять работу плагина, проводить тестовые заказы, полный и частичный возвраты и просматривать информацию по ним.
Настройка
Для настройки параметров работы плагина в тестовом режиме необходимо:
- Перейти на вкладку .
- Щёлкнуть кнопку Manage.
- Задать необходимые настройки (см. далее).
- Убедиться, что установлен флажок Test mode.
- Щёлкнуть кнопку Save changes.
Параметры работы плагина включают в себя:
- Флажок
Enable ecommpay— для отображения метода оплаты с помощью платёжной страницы ecommpay на сайте. - Параметры работы платёжной страницы при её отображении:
- Title — название метода оплаты на сайте.
- Description — описание метода оплаты на сайте.
- Additional parameters — дополнительные параметры работы платёжной страницы.
Список этих параметров доступен здесь. При задании нескольких параметров их необходимо записывать с разделителем «&».
- Display mode — способ отображения платёжной страницы: в объекте iframe, во всплывающем окне или в той же вкладке.
- Параметры Project ID и Secret key для подключения к платёжным решениям ecommpay.
В тестовом режиме эти параметры не используются.
Проведение тестовых заказов
После настройки параметров работы плагина следует провести тестовые заказы на сайте и проверить информацию по этим заказам в WordPress, на вкладке .
Проведение тестовых возвратов
После проведения тестовых заказов следует провести тестовые возвраты и проверить изменение статуса заказа и суммы в WordPress, на вкладке .
- Перейти на вкладку Orders.
- Выбрать необходимый заказ. Статус заказа должен быть Processing или Completed.
- Щёлкнуть кнопку Refund.
- Ввести сумму для возврата.
- Щёлкнуть кнопку
Refund via ecommpay.
После проведения возврата сумма заказа должна измениться на сумму возврата, а также должно появиться сообщение о проведенной операции в Order notes.
Запуск
После проверки работы плагина с использованием всех планируемых способов оплаты его можно переводить в рабочий режим. Для этого необходимо получить рабочие параметры и скорректировать настройки.
Получение рабочих параметров
Для получения параметров подключения к платёжным решениям ecommpay необходимо:
- Связаться со службой технической поддержки ecommpay и сообщить следующие параметры:
- название и URL сайта,
- валюту платёжной страницы,
- URL для приёма оповещений (URL, указанный в настройках, в разделе Callback endpoint).
- Получить от службы технической поддержки ecommpay значения следующих параметров:
- Project ID — идентификатор сайта.
- Secret key — секретный ключ, который генерируется для конкретного мерчанта на стороне ecommpay.
Задание рабочих настроек
Для задания рабочих настроек необходимо:
- Открыть WordPress.
- Перейти на вкладку и задать рабочие настройки:
- Убедиться, что установлен флажок
Enable ecommpay. - Снять флажок Test mode.
- Заполнить поля Project ID и Secret key в соответствии со значениями, полученными от службы технической поддержки ecommpay.
- Убедиться, что для остальных параметров заданы необходимые значения.
- Убедиться, что установлен флажок
- Щёлкнуть кнопку Save changes.
Использование
После запуска плагина он работает автономно.
Мы рекомендуем контролировать проведение заказов на вкладке , а также следить, чтобы номера заказов были уникальными в рамках сайта. При дублировании номера заказа платёжная страница не открывается и заказ остаётся со статусом On hold.
Если после запуска плагина появляется необходимость переключить его в тестовый режим, следует обратить внимание на отображение метода оплаты на сайте. При установке флажков Test mode и Enable
ecommpay метод оплаты с помощью платёжной страницы ecommpay отображается на сайте, но все платежи и возвраты проводятся как тестовые.
Перед переводом плагина обратно в рабочий режим, необходимо убедиться, что поля Project ID и Secret key заполнены в соответствии со значениями, полученными от службы технической поддержки ecommpay.
При возникновении вопросов по работе плагина следует обращаться в службу технической поддержки ecommpay по адресу support@ecommpay.com.