Использование плагина Rocketpay payment module для CMS OpenCart 2.3

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

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

Схема работы

Взаимодействие с платежными решениями Rocketpay осуществляется через платежную страницу.

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



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

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

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

  • Failed status — платеж не проведен.
  • Success status — платеж проведен.
  • Pending status — ожидание проведения платежа.
  • Reversed status — выполнен возврат средств до закрытия операционного дня, в котором был проведен платеж.
  • Refunded status — выполнен возврат средств после закрытия операционного дня, в котором был проведен платеж.

Подключение

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

  1. Открыть OpenCart.
  2. Перейти на вкладку Модули/Расширения > Установка расширений.
  3. Щелкнуть кнопку Загрузить и выбрать файл с плагином (в формате ocmod.zip или ocmod.xml).
  4. Щелкнуть кнопку Продолжить.
  5. Убедиться, что отобразилось сообщение: Модуль успешно установлен!

  6. Перейти на вкладку Модификаторы и убедиться, что в списке модификаторов появился Rocketpay payment module.
  7. Щелкнуть кнопку , чтобы обновить кеш модификатора.

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

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

Настройка

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

  1. Перейти на вкладку Модули/Расширения > Модули/Расширения и выбрать тип расширения — Оплата.

  2. Найти в таблице Оплата строку со способом оплаты Rocketpay и щелкнуть расположенную в этой строке кнопку .
  3. Щелкнуть в этой же строке кнопку , чтобы настроить параметры работы плагина.
  4. Задать необходимые настройки (см. далее).
  5. Убедиться, что установлен флажок Test mode.
  6. Щелкнуть кнопку , чтобы сохранить изменения.

На вкладке Settings настраиваются основные параметры работы плагина:

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

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

    • Language — язык платежной страницы.
    • Currency — валюта платежной страницы. Необходимо задать количество знаков после запятой. В противном случае сумма платежа отображается некорректно.
    • Popup mode — способ отображения платежной страницы: во всплывающем окне или в той же вкладке.
    • Sort Order — номер в списке платежных методов на сайте.
  • Geo Zone. Определяет регионы, для которых доступен данный платежный метод.
  • Project ID и Secret key. Используются для подключения к платежным решениям Rocketpay.

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

На вкладке Order Status можно присвоить названия статусам заказа, описанным в пункте Схема работы.

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

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

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

Запуск

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

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

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

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

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

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

  1. Открыть OpenCart.
  2. Перейти на вкладку Модули/Расширения > Модули/Расширения и выбрать тип расширения — Оплата.
  3. Найти Rocketpay в таблице Оплата и щелкнуть кнопку .
  4. Задать рабочие настройки:
    • Снять флажок Test mode.
    • Заполнить поля Project ID и Secret key в соответствии со значениями, полученными от службы технической поддержки Rocketpay.
    • Убедиться, что для остальных параметров заданы необходимые значения.
  5. Щелкнуть кнопку , чтобы сохранить изменения.

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

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

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

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

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

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