Использование плагина Woocommerce ECommPay для CMS WordPress

В данной инструкции описана работа с плагином Woocommerce ECommPay версии 1.0. Этот плагин позволяет проводить оплаты и возвраты с использованием платёжных решений ECommPay на сайтах, созданных на базе CMS WordPress версии 4.9 или выше с использованием плагина WooCommerce версии 3.2 или выше.

Скачать плагин Woocommerce ECommPay можно здесь.

Схема работы

Проведение платежей осуществляется через платёжную страницу ECommPay, а проведение возвратов — через консоль при выборе Refund via ECommPay.

Рис.: Схема проведения платежей с использованием плагина

Запросы на открытие платёжной страницы формируются автоматически (с помощью плагина) при выборе ECommPay в методах оплаты.

Если по какой-либо причине платёж не прошёл, у пользователя есть возможность повторно ввести данные на платёжной странице.

По результатам проведения платежей и возвратов на сайт отправляются оповещения, которые также автоматически обрабатываются с помощью плагина. В соответствии с результатом операции изменяется статус заказа:

  • On hold — платёж не прошёл.
  • Processing без изменения суммы заказа— платёж прошёл.
  • Processing с изменением суммы заказа — частичный возврат прошёл.
  • Refunded — полный возврат прошёл.
  • Partially refunded — частичный возврат прошёл.

Подключение

Для подключения плагина необходимо:

  1. Открыть WordPress.
  2. Перейти на вкладку Plugins и щёлкнуть кнопку Add New.


  3. Щёлкнуть кнопку Upload Plugin.


  4. Выбрать архив с плагином и щёлкнуть кнопку Install Now.
  5. После установки плагина щёлкнуть кнопку Activate Plugin.


  6. Убедиться, что появилось сообщение Plugin activated.


Тестирование

По умолчанию при активации плагина используется тестовый режим. Этот режим позволяет ознакомиться с работой плагина на сайте, к которому он подключён, без проведения реальных операций. В тестовом режиме можно настраивать и проверять работу плагина, проводить тестовые заказы, полный и частичный возвраты и просматривать информацию по ним.

Настройка

Для настройки параметров работы плагина в тестовом режиме необходимо:

  1. Перейти на вкладку WooComerce > Settings > Payments > ECommPay.
  2. Щёлкнуть кнопку Manage.
  3. Задать необходимые настройки (см. далее).
  4. Убедиться, что установлен флажок Test mode.
  5. Щёлкнуть кнопку Save changes.


Параметры работы плагина включают в себя:

  • Флажок Enable ECommPay — для отображения метода оплаты с помощью платёжной страницы ECommPay на сайте.
  • Параметры работы платёжной страницы при её отображении:
    • Title — название метода оплаты на сайте.
    • Description — описание метода оплаты на сайте.
    • Additional parameters — дополнительные параметры работы платёжной страницы.

      Список этих параметров доступен здесь. При задании нескольких параметров их необходимо записывать с разделителем «&».

    • Display mode — способ отображения платёжной страницы: в объекте iframe, во всплывающем окне или в той же вкладке.
  • Параметры Project ID и Secret key для подключения к платёжным решениям ECommPay.

    В тестовом режиме эти параметры не используются.

Проведение тестовых заказов

После настройки параметров работы плагина следует провести тестовые заказы на сайте и проверить информацию по этим заказам в WordPress, на вкладке WooComerce > Orders.

Прим.: В тестовом режиме для изменения статуса заказа с On hold на Processing после совершения платежа необходимо щёлкнуть кнопку Вернуться на сайт. В противном случае заказ остаётся со статусом On hold.

Проведение тестовых возвратов

После проведения тестовых заказов следует провести тестовые возвраты и проверить изменение статуса заказа и суммы в WordPress, на вкладке WooComerce > Orders.

Для проведения возврата необходимо:
  1. Перейти на вкладку Orders.
  2. Выбрать необходимый заказ. Статус заказа должен быть Processing или Completed.
  3. Щёлкнуть кнопку Refund.
  4. Ввести сумму для возврата.
  5. Щёлкнуть кнопку Refund via ECommPay.

После проведения возврата сумма заказа должна измениться на сумму возврата, а также должно появиться сообщение о проведенной операции в Order notes.

Прим.: Статус заказа меняется на Partially refunded, если проведён частичный возврат, и на Refunded, если проведён полный возврат.

Запуск

После проверки работы плагина с использованием всех планируемых способов оплаты его можно переводить в рабочий режим. Для этого необходимо получить рабочие параметры и скорректировать настройки.

Получение рабочих параметров

Для получения параметров подключения к платёжным решениям ECommPay необходимо:

  1. Связаться со службой технической поддержки ECommPay и сообщить следующие параметры:
    • название и URL сайта,
    • валюту платёжной страницы,
    • URL для приёма оповещений (URL, указанный в настройках, в разделе Callback endpoint).


  2. Получить от службы технической поддержки ECommPay значения следующих параметров:
    • Project ID — идентификатор сайта.
    • Secret key — секретный ключ, который генерируется для конкретного мерчанта на стороне ECommPay.

Задание рабочих настроек

Для задания рабочих настроек необходимо:

  1. Открыть WordPress.
  2. Перейти на вкладку WooComerce > Settings > Payments > ECommPay и задать рабочие настройки:
    • Убедиться, что установлен флажок Enable ECommPay.
    • Снять флажок Test mode.
    • Заполнить поля Project ID и Secret key в соответствии со значениями, полученными от службы технической поддержки ECommPay.
    • Убедиться, что для остальных параметров заданы необходимые значения.
  3. Щёлкнуть кнопку Save changes.

Использование

После запуска плагина он работает автономно.

Мы рекомендуем контролировать проведение заказов на вкладке WooComerce > Orders, а также следить, чтобы номера заказов были уникальными в рамках сайта. При дублировании номера заказа платёжная страница не открывается и заказ остаётся со статусом On hold.

Если после запуска плагина появляется необходимость переключить его в тестовый режим, следует обратить внимание на отображение метода оплаты на сайте. При установке флажков Test mode и Enable ECommPay метод оплаты с помощью платёжной страницы ECommPay отображается на сайте, но все платежи и возвраты проводятся как тестовые.

Перед переводом плагина обратно в рабочий режим, необходимо убедиться, что поля Project ID и Secret key заполнены в соответствии со значениями, полученными от службы технической поддержки ECommPay.

При возникновении вопросов по работе плагина следует обращаться в службу технической поддержки ECommPay по адресу support@ecommpay.com.