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

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

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

Схема работы

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

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



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

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

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

  • 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 > Rocketpay.
  2. Щелкните кнопку Manage.
  3. Задайте необходимые настройки работы плагина, как описано далее.
    • Флажок Enable Rocketpay — если этот флажок установлен, на сайте отображается метода оплаты с помощью платежной страницы Rocketpay.
    • Параметры платежной страницы:
      • Наименование — название метода оплаты, которое будет отображаться на сайте.
      • Описание — описание метода оплаты, которое будет отображаться на сайте.
      • Display mode — способ отображения платежной страницы: в объекте iframe — во всплывающем окне или в той же вкладке.
      • Base URL — в этом поле укажите доменное имя Payment Page. Доменное имя Payment Page узнавайте у своего курирующего менеджера или в службе поддержки.
      • Additional parameters — в этом поле укажите дополнительные параметры. Если вам нужно задать несколько параметров, добавляйте их в это поле, используя в качестве разделителя амперсанд (&). Полный список дополнительных параметров доступен здесь.
    • Параметры Project ID и Secret key задавать не нужно, потому что с тестовом режиме они не используются.
  4. Обязательно убедитесь, что установлен флажок Test mode.
  5. Щелкните кнопку Save changes.

Выполнение тестовых заказов

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

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

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

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

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

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

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

Запуск

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

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

Чтобы получить параметры подключения к платежным решениям Rocketpay:

  1. Свяжитесь со службой технической поддержки Rocketpay и сообщите следующие параметры:
    • название и URL сайта,
    • валюту платежной страницы,
    • URL для приема оповещений (URL-адрес, указанный в настройках, в разделе Callback endpoint).
  2. Получите от службы технической поддержки Rocketpay значения следующих параметров:
    • Project ID — идентификатор сайта.
    • Secret key — секретный ключ, который генерируется для конкретного мерчанта на стороне Rocketpay.

Определение рабочих настроек плагина

Задайте рабочие настройки плагина в следующем порядке:

  1. Откройте WordPress.
  2. Перейдите на вкладку WooComerce > Settings > Payments > Rocketpay и задайте рабочие настройки плагина:
    • Убедитесь, что установлен флажок Enable Rocketpay.
    • Снимите флажок Test mode.
    • Заполните поля Project ID и Secret key значениями, полученными от службы технической поддержки Rocketpay.
    • Base URL — в этом поле укажите доменное имя Payment Page. Доменное имя Payment Page узнавайте у своего курирующего менеджера или в службе поддержки.
    • В поле Additional parameters при необходимости укажите в этом поле другие параметры, для которых надо задать значения, используя в качестве разделителя амперсанд (&). Полный список дополнительных параметров доступен здесь.
  3. Щелкните кнопку Save changes.

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

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

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

ОПАСНО
Если после запуска плагина вам потребуется переключить его в тестовый режим, обязательно имейте в виду описанную далее особенность. Если установлены флажки Test mode и Enable Rocketpay, метод оплаты с помощью платежной страницы Rocketpay отображается на сайте, но все платежи и возвраты проводятся как тестовые!

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

При возникновении вопросов по работе плагина обращайтесь в службу технической поддержки Rocketpay по адресу support@rocketpay.kz.