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

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

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

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

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

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

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

<form name="secpay" 
		 action="https://www.secpay.com/java-bin/ValCard" 
		 method=POST>

<!-- Ваш код в системе -->
Merchant Id
<input type="hidden" name="merchant" value="secpay">

<!-- Уникальный номер транзакции -->
Transaction Id
<input type="hidden" name="trans_id" 
		  value="Invoice_<?echo $ORDER_ID ?>">

<!-- Сумма -->
The Amount
<input type="hidden" name="amount" 
		  value="<?echo $arOrder["PRICE"]?>">

<!-- Адреса для перехода в случае успешной 
	 и неуспешной оплаты соответственно -->
The Callback
<input type="hidden" name="callback" 
		  value="http://www.mysite.com/successcallback.html;http://www.mysite.com/failcallback.html">

<!-- Указание, что это тестовый запрос -->
<input type=hidden name="options" 
		  value="test_status=true,dups=false">

<!-- Дополнительные параметры -->
<input type=hidden name="font_face" value="Arial">
<input type=hidden name="bgcolor" value="white">
<input type="submit" value="Submit Order">

</form>

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

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

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

если платежная система позволяет запросить статус обработки заказа, то возможно создание файла получения результата. Такую возможность предоставляет, например, платежная система 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С-Битрикс: Управление сайтом