Недоступно в редакциях: Стандарт, Старт

Обработчики платежных систем

Структура папки обработчика

Интеграция магазина с платежными системами осуществляется через обработчики платежных систем. Системные обработчики хранятся в папке /bitrix/modules/sale/handlers/paysystem/. Папка обработчика может содержать следующие подпапки и файлы:

файл обработчика handler.php. Этот файл всегда должен присутствовать в папке обработчика.

Примечание: название класса обработчика должно совпадать с названием папки обработчика и иметь окончание Handler. Например, название папки - myname, а название класса - MyNameHandler.
файл .decription.php - файл с описанием настроек обработчика. Этот файл всегда должен присутствовать в папке обработчика.
подпапку template, в которой расположен шаблон обработчика платежной системы (файл template.php). Эта подпапка может отсутствовать, если у обработчика нет шаблонов вывода.
подпапку lang, в которой расположены файлы языковых сообщений обработчика. Эта подпапка также может отсутствовать.

Кастомизация

Кастомизация шаблона обработчика

Информация по вопросам кастомизации шаблона представлена в уроке Кастомизация шаблона платежной системы курса Разработчик Bitrix Framework.

Кастомизация обработчика

Общая методика кастомизации обработчика такова:

Скопируйте необходимую вам папку обработчика из /bitrix/modules/sale/handlers/paysystem/ в раздел по умолчанию /bitrix/php_interface/include/sale_payment/.

Примечание: путь к пользовательским обработчикам платежных систем устанавливается в настройках модуля Интернет-магазин. По умолчанию он равен /bitrix/php_interface/include/sale_payment.
Обязательно измените название скопированной папки обработчика в разделе /bitrix/php_interface/include/sale_payment/.
В разделе /bitrix/php_interface/include/sale_payment/<папка_обработчика> измените файлы обработчика таким образом, чтобы они удовлетворяли вашим нуждам и соответствовали интерфейсу.
В форме редактирования платежной системы выберите ваш обработчик и выполните необходимые настройки.

Дополнительные сведения по кастомизации обработчика смотрите в курсе Разработчик Bitrix Framework.

Получение результата от платежной системы

Ответы платежных систем, обработчики которых написаны на АПИ ядра D7, обрабатываются на странице /bitrix/tools/sale_ps_result.php.

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