Документация для разработчиков
Недоступно в редакциях: Стандарт, Старт

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

В этом разделе

  • Структура папки обработчика
  • Кастомизация шаблона обработчика
  • Кастомизация обработчика
  • Получение результата от платежной системы
  • Структура папки обработчика

    Интеграция магазина с платежными системами осуществляется через обработчики платежных систем. Системные обработчики хранятся в папке /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.

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



    © «Битрикс», 2001-2020, «1С-Битрикс», 2020
    Наверх