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

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

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

1. Загрузить архив с плагином Flashpay.
2. Открыть CMS «1С-Битрикс».
3. Открыть папку с подключаемыми модулями «1С-Битрикс».

   Для этого следует перейти на вкладку Контент, перейти в раздел Структура сайта > Файлы и папки и щёлкнуть папку bitrix > modules.

4. Добавить папку flashpay в папку bitrix/modules.

   Для этого последовательно следует щёлкнуть Добавить > Добавить папку, после чего откроется следующая страница:

   
   
   

   На этой странице необходимо ввести название папки — flashpay — в поля Название раздела и Имя папки и убедиться, что флажок Создать индексную страницу раздела снят. Затем подтвердить создание папки, щёлкнув кнопку Сохранить.

5. Извлечь содержимое архива с плагином в папку bitrix/modules/flashpay в следующей последовательности:
   1. Щёлкнуть папку с названием flashpay.
   2. Щёлкнуть кнопку Загрузить файл.
   3. Щёлкнуть кнопку Добавить файл на открывшейся странице.
   4. Выбрать архив с плагином в файловой системе и щёлкнуть кнопку Сохранить.
   5. Щёлкнуть загруженный архив правой кнопкой и выбрать Распаковать.
   6. Щёлкнуть кнопку Распаковать в появившемся модальном окне.

   Необходимо убедиться, что структура папок и файлов после распаковки архива выглядит следующим образом:

   
   
   

   Если структура отличается, следует перенести распакованные файлы и папки в папку /bitrix/modules/flashpay.

6. Подключить установленный плагин.

   Для этого следует перейти на вкладку Настройки, затем — в раздел Настройки продукта > Модули и щёлкнуть Установить в строке с модулем Flashpay.

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

Добавление платёжного обработчика

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

1. Открыть форму создания платёжной системы.

   Для этого следует открыть вкладку Магазин, перейти в раздел Настройки > Платёжные системы и щёлкнуть Добавить платёжную систему.

2. Настроить отображение платёжного обработчика, заполнив следующие поля:
   • Обработчик — название провайдера, используемого для проведения платежей (в качестве которого должен быть выбран Flashpay в выпадающем списке).
   • Название — название, которое должно отображаться пользователю при открытии платёжной страницы.
   • Описание — описание платёжного обработчика, необязательное поле.

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

3. Настроить работу платёжного обработчика, заполнив следующие поля:
   • ID проекта — идентификатор проекта, полученный от Flashpay при интеграции;
   • Секретная соль проекта — ключ рабочего проекта, полученный от Flashpay при интеграции;
   • Язык платёжного терминала — код языка в соответствии с ISO 639-1 alpha-2. Если оставить это поле пустым, язык будет определяться автоматически по IP-адресу устройства пользователя;
   • Дополнительные параметры — дополнительные параметры в соответствии с Payment Page API. При указании двух или более параметров необходимо использовать "&" в качестве разделителя. Подробнее о возможных параметрах Payment Page в отдельной статье;
   • Тестовый режим — поле определяет возможность проведения тестовых платежей. Возможные значения: Да и Нет. Если оставить это поле пустым, тестовый режим не будет задействован;
   • Модальное окно — поле позволяет задать, нужно ли открыть платёжную форму в модальном окне. Если оставить это поле пустым, платёжная форма будет открываться в режиме iframe.
   • Отображать страницу выбора способа оплаты — позволяет определить, нужно ли отображать страницу с выбором платёжного метода. Если оставить это поле пустым, пользователю будет предложено оплатить с использованием платёжной карты;
   • Передавать идентификатор покупателя — флажок, который определяет, будет ли плагин передавать в запросе на проведение платежа идентификатор пользователя. Для корректной работы плагина этот флажок надо установить;
     Прим.: Если платёж инициируется неавторизованным пользователем, то идентификатор пользователя в запросе не передается.
4. Настроить поля в разделе Status. Поля в этом разделе определяют, как должен меняться статус заказа в «1С-Битрикс» при изменении статуса платежа в Flashpay.
   • Статус "Оплачен" — в этом поле следует выбрать статус, который должен автоматически присваиваться заказу после подтверждения оплаты, например Оплачен.

     Иначе говоря, когда платёж перейдет в статус success, статус заказа в «1С-Битрикс» изменится на тот, который указан в этом поле. Параметр применяется в одностадийной оплате.

   • Статус авторизованного платежа (двухстадийные платежи) — в этом поле следует выбрать статус, который должен автоматически присваиваться заказу после подтверждения блокировки средств в рамках двухстадийной оплаты, например Авторизован.

     Когда платёж перейдет в статус awaiting capture, статус заказа в «1С-Битрикс» изменится на тот, который выбран в этом поле. Параметр применяется в двухстадийной оплате.

   • Статус подтверждения авторизации платежа (двухстадийные платежи) — в этом поле следует выбрать статус, который должен автоматически присваиваться заказу после подтверждения списания средств в рамках двухстадийной оплаты, например Оплата подтверждена.

     Когда платёж перейдет в статус success, статус заказа в «1С-Битрикс» изменится на тот, который выбран в этом поле. Параметр применяется в двухстадийной оплате.

   • Статус отмена авторизованного платежа (двухстадийные платежи) — в этом поле следует выбрать статус, который должен автоматически присваиваться заказу после отмены блокировки средств в рамках двухстадийной оплаты, например Оплата отменена.

     Когда платёж перейдет в статус canceled, статус заказа в «1С-Битрикс» изменится на тот, который выбран в этом поле. Параметр применяется в двухстадийной оплате.

   • Статус ошибки платежа — в этом поле следует выбрать статус, который должен автоматически присваиваться заказу в случае отмены платежа из-за ошибки, например Ошибка оплаты.

     Когда платёж перейдет в статус internal_error или external_error, статус заказа в «1С-Битрикс» изменится на тот, который выбран в этом поле. Параметр применяется в двухстадийной оплате.

5. Щёлкнуть кнопку Сохранить.

Настройка приёма оповещений

Автоматическое изменение платёжного статуса заказа обеспечивается с помощью приёма оповещений от Flashpay.

Чтобы обеспечить приём оповещений, необходимо:

1. Открыть вкладку Контент и перейти в раздел Структура сайта > Файлы и папки.
2. Создать файл приёмщика оповещений.

   Для этого следует открыть страницу создания файла, щёлкнув кнопки Добавить > Добавить файл.

   На открывшейся странице в поле Имя файла необходимо указать flashpay.php, а в текстовом поле — следующий программный код:

   <?php
   require($_SERVER["DOCUMENT_ROOT"] . "/bitrix/modules/main/include/prolog_before.php");
    
   $APPLICATION->IncludeComponent(
       "bitrix:sale.order.payment.receive",
       "",
       Array(
           "PAY_SYSTEM_ID" => "22",
           "PAY_SYSTEM_ID_NEW" => "22"
       )
   );
    
   require($_SERVER["DOCUMENT_ROOT"] . "/bitrix/modules/main/include/epilog_after.php");
   ?>

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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