» » Обработчики платежных систем. Обработчики платежных систем Тарифы и продление

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

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

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

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

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

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

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

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

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

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