Введение

Поводом для написания настоящей статьи явилось обсуждение публикации Создаем сайт ресторана на 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.