Платежи через RoboKassa из web-приложения OneScript

Введение

Поводом для написания настоящей статьи явилось обсуждение публикации Создаем сайт ресторана на OneScript, в ходе которого, несколько пользователей попросили привести пример подключения платежного сервиса (интернет-эквайринга), для осуществления оплат из web-приложения.

Поскольку данный функционал является достаточно распространенным и присутствует практически в каждом интернет-магазине, я решил таки сделать такой пример.  О том, что получилось - читайте ниже. Протестировать библиотеку можно нажав кнопку "Показать демо". В качестве метода оплаты необходимо выбрать Quiwi.

Описание

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

Со страницы своего сайта Вы осуществляеете POST или GET запрос с переходом на страницу оплаты платежной системы, которая находится у владельца платежной системы (фактически производится переход на сайт платежной системы). При этом, в параметрах запроса передается сумма оплаты, валюта etc.

На странице оплаты, пользователь вводит необходимые для оплаты реквизиты (номер карты, CVC-код etc.) и осуществляет оплату.

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

Если оплата завершилась неудачей, пользователь перенаправляется на страницу, указанную как страница для неудачных оплат.

У некоторых платежных систем есть сервис, оповещающий об успешном завершении платежа, посредством отправки http-запроса на url, указанный в настройках.

Также, как правило имеется возможность получить информацию о состоянии оплаты по определенному заказу, либо за определенное время.

В качестве экспериментальной платежной системы была выбрана система Робокасса. Хотя она имеет достаточно высокие комиссии и возможно в чем-то более выгодным  будет использовать, скажем эквайринг от Сбера, данная система на этапе тестов не предъявляет каких-либо требований к проверке личности, организации юридического лица и т.п. Таким образом, для наших экспериментов она вполне подойдет.

Реализация

Создадим и настроим тестовое приложение, в соответствии с публикациями //infostart.ru/public/789679/ и //infostart.ru/public/841785/ .

Зарегистрируем аккаунт в платежной системе, создадим магазин и заполним необходимые параметры.

Библиотека для работы с платежной системой

Как и в большинстве платежных систем, оплата в нашей экспериментальной системе осуществляется посредством отправки POST или GET запросов на определенный url, с переходом пользователя на страницу оплаты. Данная система позволяет выполнять запросы двумя способами:

Выполнение javascript-скрипта, который отрисовывает необходимый элемент управления.

Создание пользовательской формы ввода, которая при нажатии на кнопку submit, осуществляет соответствующий http-запрос к платежной системе и осуществляет переход на страницу оплаты.

Для реализации библиотеки, создадим подсистему БиблиотекаРобокасса, в которую мы будем добавлять все объекты конфигурации, связанные с библиотекой, а также обработку ПлатежРобокасса, которая будет реализовывать необходимый функционал. Добавим обработку также в подсистему ОбъектыКонфигурацииWebПриложения т.к. мы будем использовать из OneScript. Аналогично следует поступать и с другими объектами, которые мы будем использовать в OneScript.

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

Ниже приведено описание реквизитов:

Пароль1 - содержит пароль, который используется для расчета контрольной суммы. Значение должно совпадать со значением в настройках платежной системы.

ТестовыйРежим - определяет, используется ли тестовый режим оплаты. Если имеет значение Истина – используется тестовый режим.

ИдентификаторМагазина – идентификатор, определяющий ваш магазин. Задается в настройках платежной системы.

СуммаКОплате – полная сумма платежа без комиссий.

РазрешитьИзменениеСуммы – определяет, может ли пользователь при выполнении оплаты изменять сумму.

Описание – текстовое описание платежа.

Идентификатор – уникальный идентификатор платежа. Целое число long int.

ЯзыкИнтерфейса – язык интерфейса страницы оплаты платежной системы.

Кодировка -  кодировка текстовых данных, передаваемых в платежную систему. По умолчанию – UTF-8.

АдресЭлПочты – адрес электронной почты клиента.

Валюта – Валюта выставления счета.

СпособОплаты – способ оплаты, который будет выбран в окне оплаты.

СрокДействияСчета – Дата и время до истечения которой должна быть проведена оплата.

СистемаНалогоОбложения – система налогообложения предприятия. Используется совместно с фискальными чеками.

ОписательВременнойЗоны – смещение временной зоны, относительно UTC. Используется совместно с СрокДействияСчета.

Перем Товары;
Перем ДополнительныеПараметры;
Перем ФункцияХеширования Экспорт; 

Переменная Товары, представляет собой массив элементов типа Структура, описывающих список приобретаемых товаров, суммы и налоги. Данный список передается в качестве параметра, если используются онлайн-кассы, для выполнения требований закона 54-ФЗ. Как и в других платежных системах, вы можете арендовать виртуальные онлайн-кассы либо использовать свои. К сожалению оплата в режиме генерации фискальных чеков не работает в тестовом режиме, так , что мы не сможем ее протестировать в полном объеме, однако заложим необходимый функционал.

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

Переменная ФункцияХеширования определяет тип хеш-функции, которая будет использоваться для расчета контрольной суммы. По умолчанию, переменная имеет значение MD5.

Добавим и поместим в соответствующие подсистемы перечисления, необходимые для представления некоторой служебной информации.

В модуле объекта обработки, создадим интерфейсные функции:

ДобавитьТовар – используется в режиме онлайн-касс для добавления товаров в список.

ДобавитьДополнительныйПараметр – добавляет пользовательский параметр в список.

ПолучитьUrlСтандартнойКнопкиОплаты – возвращает url javascript-скрипта, для генерации стандартной кнопки оплаты.

ПолучитьФормуОплатыПоУмолчанию – получает html-код формы ввода с заполненными параметрами и кнопкой submit. При нажатии на кнопку производится POST-запрос к платежной системе.

ПолучитьUrlОплаты – возвращает url платежной системы для оплаты с использованием форм.

ПолучитьПоляВводаФормыОплаты – Возвращает html-код полей ввода с заполненными значениями параметров. Используется для генерации пользовательских форм ввода.

В качестве примера, ниже приведен текст функции ПолучитьUrlСтандартнойКнопкиОплаты.

// Возвращает Url на стандартную кнопку оплаты
//
Функция ПолучитьUrlСтандартнойКнопкиОплаты(ТипКнопки) Экспорт

	UrlКнопки = "https://auth.robokassa.ru/Merchant/PaymentForm/" 
		+ ПолучитьИмяСкриптаКнопки(ТипКнопки) 
		+ "?";
		
	СтрокаПараметры = "";
	
	//MerchantLogin
	СтрокаПараметры = СтрокаПараметры + "MerchantLogin=" + ИдентификаторМагазина;
	//OutSum
	Если РазрешитьИзменениеСуммы = Истина Тогда
		СтрокаПараметры = СтрокаПараметры + "&DefaultSum=" + ФорматЧисло(СуммаКОплате);	
	Иначе
		СтрокаПараметры = СтрокаПараметры + "&OutSum=" + ФорматЧисло(СуммаКОплате);
	КонецЕсли;
	//InvId
	СтрокаПараметры = СтрокаПараметры + "&InvId=" + ФорматЧисло(Идентификатор);
	//Description
	СтрокаПараметры = СтрокаПараметры + "&Description=" + Описание;	
	//Culture
	СтрокаПараметры = СтрокаПараметры + "&Culture=" + ПолучитьЯзыкИнтерфейса();
	//Encodig
	СтрокаПараметры = СтрокаПараметры + "&Encoding=" + Кодировка;
	// Receipt или OutSumCurrency
	Если Товары.Количество() > 0 Тогда
		ТекстЧек = ПолучитьЧекJSON();
		СтрокаПараметры = СтрокаПараметры + "&Receipt=" + ТекстЧек;
	Иначе
		Если Не Валюта = Перечисления.ВалютыСчетаРобокасса.RUR Тогда
			СтрокаПараметры = СтрокаПараметры + "&OutSumCurrency=" + ПолучитьВалютуСчета();
		КонецЕсли;
	КонецЕсли;
	// Email
	Если Не АдресЭлПочты = "" Тогда
		СтрокаПараметры = СтрокаПараметры + "&Email=" + АдресЭлПочты;
	КонецЕсли;
	// IncCurrLabel
	Если Не СпособОплаты = "" Тогда
		СтрокаПараметры = СтрокаПараметры + "&IncCurrLabel=" + СпособОплаты;
	КонецЕсли;
	// SignatureValue
	// Расчитываем контрольную сумму
	СтрокаПараметры = СтрокаПараметры + "&SignatureValue=" + ПолучитьКонтрольнуюСумму(ТекстЧек);
	// ExpirationDate
	Если Не СрокДействияСчета = Дата("00010101") Тогда
		СтрокаПараметры = СтрокаПараметры + "&ExpirationDate=" + Формат(СрокДействияСчета, "ДФ=""гггг-ММ-ддTмм:сс""") + "." + ОписательВременнойЗоны;		
	КонецЕсли;
	// Дополнительные параметры Shp_
	Для каждого ДопПараметр Из ДополнительныеПараметры Цикл
		СтрокаПараметры = СтрокаПараметры + "&" + ДопПараметр.Имя + "=" + ДопПараметр.Значение;
	КонецЦикла;
	// IsTest
	Если ТестовыйРежим = Истина Тогда
		СтрокаПараметры = СтрокаПараметры + "&IsTest=1";	
	КонецЕсли;
	
	Возврат UrlКнопки + СтрокаПараметры;
	
КонецФункции

Как можно увидеть все достаточно просто, никаких rocket science.

Страница начала оплаты

Создадим подсистему ДемоРобокасса, куда будем помещать объекты конфигурации, не относящиеся к библиотекам. При создании данной страницы, все параметры оплаты, а также суммы известны. Также на этой странице как правило создается заказ, если он не был создан ранее. Для упрощения, заполним необходимые значения непосредственным присваиванием в коде обработчика.

Создадим общий макет типа ТекстовыйДокумент с именем ГлавнаяСтраница с нижеследующим содержимым:

<html>
<head>
<meta charset="UTF-8">
</head>
<body>
	<table class="shop">
		<tr>
			<td colspan="4" style="text-align: center; padding-bottom: 5pt;">
				<span class="tit1">
					Корзина покупок</span>
			</td>
		</tr>
		
		<tr style="font-weight: bold;">
			<td style="text-align: left;">
				</td>
			<td style="width: 1%; padding-left: 10pt;">
				Кол-во (шт.)</td>
			<td style="width: 1%; padding-left: 10pt;">
				Цена (руб.)</td>
			<td style="width: 1%; padding-left: 10pt;">
				Сумма (руб.)</td>
		</tr>
		<tr>
			<td colspan="4">
				<hr style="height: 1pt; margin: 1pt auto;" />
			</td>
		</tr>
	
		<tr>
			<td style="text-align: left;">
				Техническая документация по ROBOKASSA
			</td>
			<td>
				1
			</td>
			<td>
				6,38
			</td>
			<td>
				6,38
			</td>
		</tr>
	
		<tr>
			<td style="text-align: left;">
				Техническая документация по Robo.market
			</td>
			<td>
				1
			</td>
			<td>
				35,04
			</td>
			<td>
				35,04
			</td>
		</tr>
	
		<tr>
			<td colspan="4">
				<hr style="height: 1pt; margin: 1pt auto;" />
			</td>
		</tr>
		<tr style="font-weight: bold;">
			<td style="text-align: left;" colspan="3">
				</td>
			<td>41,42</td>
		</tr>
  		<tr>
			<td colspan="4" style="text-align: center; padding-top: 5pt;">
				
				Стандартная кнопка, предоставляемая Робокасса
			</td>
		</tr>

		<tr>
			<td colspan="4" style="text-align: center; padding-top: 5pt;">
				<script type="text/javascript" src="{{UrlСтандартнойКнопки}}"></script>
			</td>
		</tr>
   		<tr>
			<td colspan="4" style="text-align: center; padding-top: 5pt;">
				
				Форма с кнопкой по умолчанию
			</td>
		</tr>

   		<tr>
			<td colspan="4" style="text-align: center; padding-top: 5pt;">
				
				{{СтандартнаяФорма}}
			</td>
		</tr>
   		<tr>
			<td colspan="4" style="text-align: center; padding-top: 5pt;">
				
				Пользовательская кнопка
			</td>
		</tr>

   		<tr>
			<td colspan="4" style="text-align: center; padding-top: 5pt;">
				
				<form action='{{UrlОплаты}}' method=POST>
				  {{ПоляВводаФормы}}
				  <input type=submit value='Оплатить' style="background-color: #4CAF50;border: none;color: white; padding: 15px 32px; text-align: center; text-decoration: none; display: inline-block; font-size: 16px;">
				</form>
			</td>
		</tr>

	</table>
</body>
</html>

Создадим http-сервис index.os, который будет отображать содержимое этой страницы. Обработчик сервиса будет иметь нижеследующий вид:

Функция ОбработкаВызоваHTTPСервиса(Запрос) Экспорт
	
	// Создаем платеж и заполняем параметры
	Платеж = Обработки.ПлатежРобокасса.Создать();
	Платеж.СуммаКОплате = 41.42;
	Платеж.АдресЭлПочты = "yepresto@rambler.ru";
	Платеж.Пароль1 = "ВашПароль1";
	Платеж.ИдентификаторМагазина = "ВашИдентификаторМагазина";
	Платеж.Описание = "Тестовый платеж";
	Платеж.Идентификатор = 7;
	Платеж.ТестовыйРежим = Истина;
	Платеж.СрокДействияСчета = ТекущаяДата() + 3600*24;
	Платеж.ОписательВременнойЗоны = "+03:00";
	
	// Добавляем дополнительные параметры
	Платеж.ДобавитьДополнительныйПараметр("login", "vasya");
	Платеж.ДобавитьДополнительныйПараметр("opr", "vasya");
	
	ТекстТело = ПолучитьОбщийМакет("ГлавнаяСтраница").ПолучитьТекст();
	
	// Выводим стандартную кнопку, предоставляемую Робокасса
	UrlСтандартнойКнопки = Платеж.ПолучитьUrlСтандартнойКнопкиОплаты(Перечисления.ТипыКнопокРобокасса.Большая);	
	ТекстТело = СтрЗаменить(ТекстТело, "{{UrlСтандартнойКнопки}}", UrlСтандартнойКнопки);
	
	// Выводим пользовательскую кнопку по умолчанию
	ТекстФормы = Платеж.ПолучитьФормуОплатыПоУмолчанию();
	ТекстТело = СтрЗаменить(ТекстТело, "{{СтандартнаяФорма}}", ТекстФормы);
	
	// Выводим кастомизированную кнопку
	UrlОплаты = Платеж.ПолучитьUrlОплаты();
	ТекстТело = СтрЗаменить(ТекстТело, "{{UrlОплаты}}", UrlОплаты);
	ПоляВводаФормы = Платеж.ПолучитьПоляВводаФормыОплаты();
	ТекстТело = СтрЗаменить(ТекстТело, "{{ПоляВводаФормы}}", ПоляВводаФормы);
	
	// Формируем ответ
	Ответ = Новый HTTPСервисОтвет(200);
	Ответ.УстановитьТелоИзСтроки(ТекстТело);
	
	Возврат Ответ;
	
КонецФункции

Страница перехода при успешной оплате

Создадим общий макет типа ТекстовыйДокумент с именем УспешнаяОплата с нижеследующим содержимым:

<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
</head>
<body>

<h1>Успешная оплата</h1>

 <p>Ваша оплата успешно принята.</p>

</body>
</html>

Создадим http-сервис success.os, который будет вызываться при успешной оплате. Т.к. данная платежная система передает странице некоторые параметры платежа, а нам бы не хотелось видеть параметры url в адресной строке, определим для этого сервиса метод POST и внесем соответствующие настройки в платежную систему.

Страница перехода при ошибке оплаты

Создадим общий макет типа ТекстовыйДокумент с именем ОшибкаОплаты с нижеследующим содержимым:

<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
</head>
<body>

<h1>Ошибка оплаты</h1>

 <p>В процессе выполнения оплаты возникли ошибки.</p>

</body>
</html>

Создадим http-сервис failure.os, который будет вызываться при ошибке оплаты. Т.к. данная платежная система передает странице некоторые параметры платежа, а нам бы не хотелось видеть параметры url в адресной строке, определим для этого сервиса метод POST и внесем соответствующие настройки в платежную систему.

Сервис уведомления об оплате

Создадим http-сервис result.os, на который будут приходить уведомления о совершенных оплатах. Так как анализ результатов оплаты и разрешения отгрузки клиентов на сайте – менее безопасная операция, мы не будем задействовать функционал этой опции и оставим обработчик пустым, с целью тестирования. Более безопасным, будет решение, где учетная система, периодически запрашивает платежную систему, с целью проверки статуса оплаты по заказам, которые поступили с сайта.

Функция проверки статуса оплаты

Поскольку данная функция будет использоваться только в платформе 1С:Предприятие, создадим подсистему WebСервисБиблиотекаРобокасса и общий модуль WebСервисРобокасса. Поместим модуль в созданную подсистему.

В дереве конфигурации создадим WS-cсылку с именем WSСсылкаРобокасса и настроим ее на взаимодействие с web-сервисом платежной системы. Поместим ссылку в подсистему  WebСервисБиблиотекаРобокасса и создадим функцию ПолучитьИнформациюОПлатеже во вновь созданном общем модуле, которая будет вызывать соответствующий метод web-сервиса платежной системы и возвращать результат.

Описание библиотеки

Создадим общий макет с именем ИнформацияОКомпонентеРобокасса типа ТекстовыйДокумент, добавим краткое описание нашей библиотеки. Добавим созданный макет в подсистему ИнформацияОКомпонентахWebПриложения.

Тест и развертывание

Протестируем созданное нами web-приложение на платформе 1С:Предприятие, затем обновим приложение и протестируем его работоспособность в среде OneScript.

Использование библиотеки в своих конфигурациях

Для использования настоящей библиотеки в своем web-приложении ее необходимо внедрить в свою конфигурацию методом сравнения/объединения, отфильтровав объекты по подсистеме БиблиотекаРобокасса. Поскольку объекты этой подсистемы входят и в другие подсистемы (ОбъектыКонфигурацииWebПриложения), при сравнении/объединении необходимо также пометить членство в подсистемах.

Для использования функций работы с web-сервисом на стороне 1С:Предприятие, в исходную конфигурацию необходимо внедрить подсистему WebСервисБиблиотекаРобокасса.

Заключение

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

Протестировать работу библиотеки онлайн, можно нажав на кнопку “Показать демо”. При этом следует выбрать тип оплаты – кошелек Киви т.к. тестовых номеров карт мне найти не удалось.

В общем, пишите свои библиотеки, разрабатывайте web-приложения, пробуйте J.