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

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

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

Схема работы

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

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



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

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

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

  • Pending — платеж не прошел,
  • Processing — платеж прошел.

Подключение

Для подключения плагина необходимо перенести файлы плагина в корень проекта в папку public_html. После подключения плагин должен отображаться в списке плагинов на вкладке Modules > Payment.

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

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

Настройка

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

  1. Перейти на вкладку Modules > Payment.
  2. Выбрать в списке Rocketpay и щелкнуть кнопку Edit.
  3. Задать необходимые параметры (см. далее).
  4. Убедиться, что в поле Test mode выбрано True.
  5. Щелкнуть кнопку Save.

У плагина есть следующие параметры:

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

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

    • Sort Order — номер в списке платежных методов на сайте.
  • Другие параметры работы плагина:
    • Payment Zone — регионы, для которых доступен данный платежный метод.
    • Set Order Status — статус заказа при успешном прохождении платежа.
  • Параметры Project ID и Secret key для подключения к платежным решениям Rocketpay.

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

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

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

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

Запуск

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

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

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

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

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

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

  1. Открыть osCommerce.
  2. Перейти на вкладку Modules > Payment.
  3. Выбрать в списке Rocketpay и щелкнуть кнопку Edit.
  4. Задать рабочие настройки:
    • Убедиться, что в поле Status выбрано True.
    • Выбрать False в поле Test mode.
    • Заполнить поля Project ID и Secret key в соответствии со значениями, полученными от службы технической поддержки Rocketpay.
    • Убедиться, что для остальных параметров заданы необходимые значения.
  5. Щелкнуть кнопку Save.

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

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

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

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

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

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