Использование плагина Rocketpay для CMS «1С-Битрикс»

В этом разделе описана работа с плагином Rocketpay версии 1.0. Этот плагин позволяет использовать платежные решения Rocketpay на сайтах, созданных на базе CMS «1С-Битрикс» в редакциях «Малый бизнес», «Бизнес» и «Энтерпрайз».

Схема работы

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

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



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

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

По результатам проведения платежей на сайт мерчанта в «1С-Битрикс» отправляются оповещения, которые автоматически обрабатываются плагином. В соответствии с результатом платежа плагин изменяет статус заказа в «1С-Битрикс». Соответствие результатов платежей и статусов заказов настраивается в параметрах CMS «1С-Битрикс».

Подключение

Установка плагина

Для подключения плагина необходимо выполнить следующие действия:

  1. Загрузите архив с плагином Rocketpay здесь.
  2. Откройте CMS «1С-Битрикс».
  3. Перейдите на вкладку Контент > Структура сайта > Файлы и папки.
  4. Добавьте папку rocketpay в папку bitrix/modules.
  5. Перейдите на вкладку Настройки > Модули.
  6. Щелкните Установить напротив Rocketpay.

    После установки плагина его статус должен измениться на Установлен.

Прием оповещений

Автоматическое изменение платежного статуса заказа обеспечивается с помощью приема оповещений от Rocketpay. Для получения оповещений необходимо:

  1. Добавить файл формата php в раздел Контент > Структура сайта > Файлы и папки.

    Файл должен содержать следующий программный код:

    <? $APPLICATION->IncludeComponent(
    "bitrix:sale.order.payment.receive",
    "",
    Array(
        "PAY_SYSTEM_ID_NEW" => "22"
    )
);
?>

    В параметре PAY_SYSTEM_ID_NEW укажите значение идентификатора платежной системы Rocketpay, который можно найти на вкладке Магазин > Настройки > Платежные системы в столбце ID.

  2. Сообщите службе технической поддержки Rocketpay URL-адрес для приема оповещений.

    Если файл rocketpay.php расположен в корневом каталоге сайта, то URL-адрес для приема оповещений имеет вид:

    https://<полное_доменное_имя>/rocketpay.php

    Если файл rocketpay.php расположен не в корневом каталоге сайта, то URL-адрес для приема оповещений имеет вид:

    https://<полное_доменное_имя>/<путь_к_каталогу>/rocketpay.php

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

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

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

Чтобы настроить параметры работы плагина в тестовом режиме:
  1. На вкладке Настройка > Модули убедитесь, что статус модуля — Установлен.
  2. Перейдите на вкладку Магазин > Настройки > Платежные системы.
  3. Выберите в списке Rocketpay и щелкните Изменить.
  4. Задайте необходимые настройки в разделе (см. далее).
  5. Выберите Да в поле Тестовый режим.
  6. Щелкните Сохранить.
Параметры работы плагина могут настраиваться по умолчанию для всех типов плательщиков или отдельно для каждого типа плательщиков. У плагина есть следующие параметры работы:
  • Параметры отображения платежной страницы Rocketpay:
    • Поле Активность — отображение платежного метода в списке доступных.
    • Поле Описание — описание платежного метода.
    • Поле Логотип — логотип платежной системы.

    • Поля Открывать в новом окне и Модальное окно служат для выбора режима отображения платежной страницы. Возможны три режима отображения: встраивание платежной страницы в веб-страницу (iframe), открытие в модальном окне и открытие в отдельной вкладке браузера.

      Чтобы платежная страница отображалась как встроенная (iframe) в веб-страницу, снимите флажок Открывать в новом окне и выберите Нет в поле Модальное окно.

      Чтобы платежная страница открывалась в модальном окне, снимите флажок Открывать в новом окне и выберите Да в поле Модальное окно.

      Чтобы платежная страница открывалась в отдельной вкладке браузера, установите флажок Открывать в новом окне и выберите Нет в поле Модальное окно.

    • Поле Язык платежного терминала — язык платежной страницы. При заполнении этого поля необходимо выбрать Значение и задать код языка в соответствии со стандартом ISO 639-1 alpha-2.
    • Поле Дополнительные параметры — дополнительные параметры работы платежной страницы.

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

    • Поле Отображать страницу выбора способа оплаты служит для настройки отображения страницы выбора платежного метода перед переходом к оплате.
  • Поля ID проекта и Секретная соль проекта необходимы для подключения к платежным решениям и в тестовом режиме не используются.

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

После настройки параметров работы плагина следует выполнить тестовые заказы на сайте и проверить информацию по этим заказам в «1С-Битрикс», на вкладке Магазин > Заказы.

Запуск

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

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

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

Настройка рабочих параметров

  1. Откройте CMS «1С-Битрикс».
  2. Перейдите на вкладку Магазин > Настройки > Платежные системы.
  3. Выберите в списке Rocketpay и щелкните Изменить.
  4. Задайте рабочие параметры:
    • Убедитесь, что в поле Активность установлен флажок.
    • Выберите Нет в поле Тестовый режим.
    • Заполните поля Секретная соль проекта и ID проекта в соответствии со значениями, полученными от службы технической поддержки Rocketpay.
    • Убедитесь, что для остальных параметров заданы необходимые значения.
  5. Щелкните Сохранить.

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

После запуска плагин работает самостоятельно и дополнительной настройки не требует.

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

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

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

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