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

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

Схема работы

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

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

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

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

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

Подключение

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Запуск

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

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

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

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

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

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

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

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

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

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

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