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

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

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

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

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