Добавить обработчик платежной системы битрикс. Обработка платежных систем

Татьяна Старкова

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

Старт, Стандарт

Платежные системы - способы оплаты за товары в интернет-магазине.

Под платежными системами понимаются любые способы оплаты заказа: как платежные системы, принимающие платежи online, так и банковские переводы. В системе может быть создано любое их количество. Управление платежными системами осуществляется на странице Платежные системы (Магазин > Настройки магазина > Платежные системы ).

Создание платежной системы

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


Секция параметров Настройка обработчика ПС состоит из нескольких закладок: закладки По умолчанию и закладок с названиями всех используемых в системе типов плательщиков.

Примечание: использование того или иного имеющегося в системе типа плательщиков настраивается на странице Настройка типов плательщиков для бизнес-смыслов (Магазин > Настройки > Бизнес смыслы > Типы плательщиков ).

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

Для удобства выполнения настроек заполненные свойства скрываются, но вы можете отобразить их по ссылке Показать все . Если около параметра отмечен флаг По умолчанию , то значение поля берется из соответствующего значения по умолчанию, заданного для общих (Магазин > Настройки магазина > Бизнес-смыслы ).

Примечание: чтобы платежная система была доступна только определенному типу плательщиков, следует задать ограничение по типу плательщиков на закладке .

Настройка ограничений

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

Примечание: для каждого типа ограничения можно составить только одно ограничение. Таким образом, если требуется дополнить некоторое ограничение, то следует откорректировать существующее.

Рассмотрим процесс составления ограничения на примере. Допустим, что в магазине оплата заказа текущей платежной системой возможна в том случае, если в качестве доставки выбран самовывоз. Для решения задачи выполните следующие действия:

В результате, если покупатель выберет самовывоз при оформлении заказа, то ему будет доступна наша платежная система, в которой мы настроили ограничение:

При выборе другой службы доставки нашей платежной системы в списке не будет:

Аналогичным образом настраиваются все необходимые вам ограничения платежных систем. Единственное отличие - это указание параметров ограничения во всплывающих окнах, внешний вид которых зависит от типа настраиваемого ограничения.


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

  • файл обработчика 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/ измените файлы обработчика таким образом, чтобы они удовлетворяли вашим нуждам и соответствовали интерфейсу.
  • В форме редактирования платежной системы выберите ваш обработчик и выполните необходимые настройки.

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


Платежные системы - способы оплаты за товары в интернет-магазине.

Под платежными системами понимаются любые способы оплаты заказа: как платежные системы, принимающие платежи online, так и банковские переводы. В системе может быть создано любое их количество. Управление платежными системами осуществляется на странице Платежные системы (Магазин > Настройки магазина > Платежные системы ).

Создание платежной системы

Рассмотрим особенности добавления платежной системы. Для этого перейдите к форме создания платежной системы с помощью кнопки Добавить платежную систему , расположенной на контекстной панели. Форма добавления платежной системы может быть заполнена так:

На первой закладке заполняются общие параметры платежной системы. На закладке Типы плательщиков определяются параметры использования данной платежной системы каждым типом плательщика, определенным в системе (каждому типу плательщика соответствует закладка с его названием). Например, оплата через Сбербанк доступна для типа плательщика Физическое лицо :

На закладке <тип_плательщика> определяется:

  • Отметка в поле Применяется для данного типа плательщика определяет, будет ли для этого типа плательщика работать данная платежная система или нет;
  • Название платежной системы, отображаемое в публичном разделе сайта для данного типа плательщика;
  • Выбирается Обработчик платежей, осуществляемых с помощью данной платежной системы (об обработчиках платежных систем речь пойдет ниже);
  • Флаг в поле Открывать в новом окне означает, что если по результатам работы обработчика платежей пользователю должен быть представлен какой-либо результат (например, платежный документ), то он будет выведен в отдельном окне веб-браузера;
  • В поле Кодировка укажите кодировку, в которой работает сайт платежной системы, например: UTF-8. Кодировка платежной системы указывается в документации, которую получается от службы поддержки выбранной системы вместе с параметрами доступа к ней. В случае с наличными (cash ) в это поле можно ничего не вводить, так как обработчик работает на стороне вашего магазина.
  • Секция Свойства обработчика . Если выбранный вами обработчик платежной системы требует задания значений дополнительных свойств, то в секции будет выведен список этих свойств.
    • Чтобы скрыть список свойств, воспользуйтесь ссылкой Свернуть свойства обработчика .
    • Чтобы раскрыть список свойств, воспользуйтесь ссылкой Развернуть свойства обработчика .

На закладке Службы доставки выбираются службы, при выборе которых будет доступна данная платежная системы при оформлении заказа:

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

Разные платежные системы предлагают различные интерфейсы для интеграции (взаимодействия). Зачастую эти интерфейсы отличаются кардинально: например, интеграция с системой Payflow Pro требует выполнения запросов к платежной системе при помощи устанавливаемого на сервер SDK (Software Development Kit), а интеграция со Сбербанком требует распечатки квитанции Сбербанка .

Обработчик платежных систем - php-скрипт, осуществляющий интеграцию интернет-магазина с платежными системами.

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

Общая методика работы с файлами-обработчиками такова:

  • Скопируйте необходимые вам шаблоны файлов-обработчиков из папки /bitrix/modules/sale/payment/ в папку /bitrix/php_interface/include/sale_payment/ ;

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

  • Измените файлы в папке /bitrix/php_interface/include/sale_payment/ таким образом, чтобы они удовлетворяли вашим нуждам и соответствовали интерфейсу соответствующих платежных систем. Типичные изменения, которые необходимо произвести в этих файлах: изменение тестовых номеров и паролей к платежным системам на реальные номера и пароли, полученные при регистрации в соответствующей платежной системе; добавление изображения оттиска печати и подписей к счету; изменение внешнего вида формы в соответствии с дизайном сайта и т.п.;
  • Добавьте файлы-обработчики с интерфейсами других платежных систем, если они нужны.

Типичные обработчики


Первый тип интерфейса является наиболее простым для интеграции. В обработчике достаточно создать HTML-форму, которая будет отправлять данные на сайт платежной системы, и добавить в форму необходимые платежной системе поля. Конкретные параметры необходимо смотреть в системе помощи по данной платежной системе. Пример такого обработчика можно посмотреть в шаблоне платежной системы Assist (/bitrix/modules/sale/payment/assist/payment.php).

Второй тип является более сложным для интеграции, но зато он является более гибким в плане возможностей. Пример такого обработчика можно посмотреть в шаблоне платежной системы AuthorizeNet (/bitrix/modules/sale/payment/authorizenet/).

Результаты обработки

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


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

Общая методика работы с файлами-обработчиками такова:

  • скопируйте необходимые вам шаблоны файлов-обработчиков из папки /bitrix/modules/sale/payment в раздел по умолчанию /bitrix/php_interface/include/sale_payment. Путь к пользовательским файлам-обработчикам платежных систем устанавливается в настройках модуля Интернет-магазина;
  • измените файлы в папке /bitrix/php_interface/include/payment таким образом, чтобы они удовлетворяли вашим нуждам и соответствовали интерфейсу соответствующих платежных систем. Типичные изменения, которые необходимо произвести в этих файлах: изменение тестовых номеров и паролей к платежным системам на реальные номера и пароли, полученные при регистрации в соответствующей платежной системе; добавление изображения оттиска печати и подписей к счету; изменение внешнего вида формы в соответствии с дизайном сайта и т.п.;
  • добавьте файлы-обработчики с интерфейсами других платежных систем, если они нужны;
  • введите / измените пути к файлам-обработчикам соответствующих платежных систем в форме управления платежными системами.

Пример файла-обработчика

Типичный файл-обработчик имеет следующий вид (на примере http://www.secpay.com)

Merchant Id Transaction Id The Amount "> The Callback

Конкретный синтаксис (интерфейс общения) платежной системы необходимо уточнить в системе помощи (тех. поддержки) данной платежной системы.

Результаты обработки

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

  • если платежная система позволяет запросить статус обработки заказа, то возможно создание файла получения результата. Такую возможность предоставляет, например, платежная система assist.ru . В файле получения результата (обработки результата) необходимо с помощью скрипта запросить платежную систему о статусе и параметрах заданного заказа, а потом сохранить полученную информацию. Файл получения результата будет вызываться на команду "Обновить статус" формы "Заказы" административного раздела сайта. Примером файла получения результата может служить файл получения результата от платежной системы assist.ru : /bitrix/php_interface/include/payment/assist_res.php . Путь к файлу получения результата соответствующей платежной системы должен быть задан в форме управления платежными системами.
  • если платежная система возвращает результат сразу в ответ на запрос обработки заказа, то соответствующий код должен быть вставлен в файл-обработчик этой платежной системы.

Предустановленные шаблоны файлов

Шаблоны расположены в каталоге /bitrix/modules/sale/payment/ . Для изменения шаблонов под свои нужды скопируйте их в каталог /bitrix/php_interface/include/payment .

Файл Описание
assist.php assist.ru
assist_rapida.php Файл-обработчик оплат по кредитной карте для системы «Рапида» через assist.ru
assist_res.php Файл получения результата для системы assist.ru
betaling.php Файл-обработчик оплат по кредитной карте для системы http://betaling.viborgnet.dk (западная система)
paycash.php Файл-обработчик оплат для системы «Яндекс.Деньги»
paypal.php Файл-обработчик оплат по кредитной карте для системы paypal.com (западная система)
post.php Файл-обработчик оплат для почтового перевода.
sberbank.php Файл-обработчик оплат для Сбербанка (печать квитанции)
webmoney.php Файл-обработчик оплат для системы «Webmoney»

Многие интернет-магазины, независимо от их масштаба, конструируются на платформе «1С-Битрикс». Это одна из наиболее эффективных систем управления сайтами, позволяющая создавать ресурсы любой сложности. Она отличается расширенным функционалом, удобным интерфейсом, качественной поддержкой и возможностью интеграции с «1С: Предприятие», что значительно упрощает ведение бухгалтерии.

Чтобы интернет-магазин стал ещё более привлекательным в глазах клиентов, необходимо наладить удобную систему оплаты на сайте «1С-Битрикс». Это можно сделать при помощи платёжного модуля от Net Pay – универсальной платёжной системы для «1С-Битрикс» и других систем управления. Приём оплаты от покупателей начнётся сразу после внедрения модуля в структуру сайта, которое займёт не более одного дня. Интеграция модуля производится бесплатно, поэтому при запуске сайта не придётся закладывать дополнительную статью расходов. Кроме того, платёжный модуль Net Pay обладает другими полезными качествами:

  • Защита от мошенничества. Все платежи защищены от хищения конфиденциальных данных современной системой защиты. В модуле Net Pay используется протокол Secure Sockets Layer, который шифрует данные клиентов с помощью асимметричного алгоритма с открытым ключом. Злоумышленник не сможет получить их даже в том случае, если сможет завладеть этим ключом.
  • Тщательная проверка подлинности. Сайт может быть заблокирован, если через него проходят подозрительные транзакции. Поэтому модуль от Net Pay следит, чтобы платежи совершали только истинные владельцы карт. Для этого он применяет систему проверки подлинности, контролирующую совпадение кода подлинности, и технологию 3D-Secure, требующую подтверждения платежа через SMS-уведомление.
  • Удобный интерфейс. Весь процесс оплаты сосредоточен в одном окне. От покупателя потребуется минимальный набор действий: выбрать товары, ввести данные банковской карты и подтвердить платёж.