Просмотр исходного текста страницы Платежные web-сервисы: Сервис интеграции с платежной системой Sberbank ATM (оплата через терминалы, кассы банка, Сбербанк Онлайн)

Версия статьи от {{REVISIONDAY}}-{{REVISIONMONTH}}-{{REVISIONYEAR}}.
<table style="color:black; background-color:#ffffcc;" cellpadding="10" cellspacing="0" border="1">
<tr>
<td>
Поддерживаемые версии:<br />
Начиная с 2009.2.20.33<br />
</td>
</tr>
</table>
<br />
==Введение==
Данный модуль реализует возможность оплаты путёвок в ПК «Мастер-Web» через терминалы, банкоматы, кассы '''Сбербанка'''.<br> Широкое распространение Сбербанка позволяет предоставить возможность оплаты большому количеству пользователей. Особенно полезным данный модуль может быть туристическим компаниям, ориентированным на работу с частными клиентами.<br />
==Установка== 
Для установки дополнительного модуля '''Сервис интеграции с платежной системой Sberbank для оплаты через терминалы, кассы и банкоматы''' нужно создать директорию '''SberbankTerminals''' в каталоге <code>C:/inetpub/wwwroot</code> (корневом каталоге '''IIS''')  и выложить туда распакованные файлы из архива<br />
<code>mw-SberbankTerminals-9.2.20.ХХXXX.zip</code>.<br />
===Создание виртуального каталога===
По умолчанию корневым каталогом '''IIS''' является <code>C:/Inetpub/wwwroot</code>. Для создания виртуального каталога для приложения находящегося в этом каталоге нужно выполнить следующие действия:<br />
1 Зайти в '''Пуск''' ('''Start''') &rarr; '''Настройки''' ('''Settings''') &rarr; '''Панель управления''' ('''Control Panel''') &rarr; '''Администрирование''' ('''Administrative Tools''')<br />
[[Файл: am_745.png|x500px|Панель управления]]<br />
<br />
2 '''Диспетчер служб IIS'''<br />
[[Файл: am_746.png|x500px|Администрирование - Диспетчер служб IIS]]<br />
<br />
3 В открывшемся дереве каталогов выбрать '''Web Sites – Default Web Site'''. В открывшемся списке найти ''папку'', для которой нужно создать ''виртуальный каталог'', кликнуть по ней правой кнопкой мыши и выбрать '''Преобразовать в приложение'''<br />
[[Файл: am_747.png|x500px|Преобразовать в приложение]]<br />
<br />
4 В открывшемся окне нужно нажать кнопку '''ОК'''<br />
[[Файл: am_748.png|x500px|Добавить приложение]]<br />
<br />

===Подключение к базе данных ПК «Мастер-Тур»===
В файле <code>web.config</code>, расположенном в папке '''SberbankTerminals''' пропишите необходимые параметры подключения (<span style="color:red">красным цветом</span> выделены значения, которые необходимо ввести).
Строка подключения к базе данных ПК «Мастер-Тур»:<br />
<code><add key = "connectionString" value = "Data Source=<span style="color:red">ip-адрес сервера базы данных ПК «Мастер-Тур»</span>;Initial Catalog=<span style="color:red">название базы данных ПК «Мастер-Тур»</span>;User ID=<span style="color:red">логин пользователя ПК «Мастер-Тур»</span>;Password=<span style="color:red">пароль пользователя ПК «Мастер-Тур»</span>"/></code>

==Настройка==

Настройки задаются в секции <code><appSettings></code> файла <code>web.config</code> приложения SberbankTerminals.

{| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse"

|- style="background-color:#F2F2F2"

! width="2%" | №
! width="28%" | Описание
! width="35%" | Значение
! width="35%" | Настройка

|- style="vertical-align:text-top"

| 1
| ISO-код рубля.<br> Настройка является обязательной!
| '''ISO-код рубля''', используемый в ПК «Мастер-Тур».
|<syntaxhighlight lang="xml" enclose="div">
<add key="RubleCurrencyISOCode" value="RUB"/>
</syntaxhighlight>

|- style="vertical-align:text-top"

| 2
| Настройка, определяющая '''дату''', на которую должен '''подбираться курс валют''' для пересчета '''суммы к оплате'''.
| 
* '''FixationDate''' или '''отсутствие настройки''' - курс на дату последней фиксации путевки на момент совершения платежа, а если путевка не зафиксирована, то на дату совершения платежа;
* '''ConfirmDate''' — курс на дату последнего ''подтверждения заявки'' (если '''подтверждения''' путевки еще '''не было''', либо '''курс''' на дату подтверждения '''не заведен''', то будет отображаться курс на '''момент совершения платежа''');
* '''OrderDate''' — дата оформления заявки; 
* '''PaymentDate''' - курс на дату совершения платежа.
|<syntaxhighlight lang="xml" enclose="div">
<add key="courseExchangeDate" value="orderdate"/>
</syntaxhighlight>
|- style="vertical-align:text-top"
| 3
| Определяет '''тип платежной операции'''.<br /><br />Тип платежной операции так же может задаваться в настройке '''SYSPaymentOperationId''' в таблице ''SystemSettings''. В таком случае в настройке '''PaymentOperationId''' задается название настройки из таблицы ''SystemSettings''.
Обязательная настройка.
| '''Идентификатор типа операции''' - поле '''PO_Id''' из таблицы <code>'''[PaymentOperations]'''</code>.<br /><br />Либо '''название настройки SYSPaymentOperationId''' из таблицы <code>'''[SystemSettings]'''</code>.
|<syntaxhighlight lang="xml" enclose="div">
<add key="PaymentOperationId" value="1" />
</syntaxhighlight>

|- style="vertical-align:text-top"
|}

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

==Работа в системе==
Осуществляется 2 типа запросов:
*Pay - проведение платежа,
*Check - проверка состояния счёта Плательщика.

===Запрос на проверку состояния счёта плательщика===
Для проверки состояния Плательщика, система Банка генерирует запрос следующего вида:

<code>https://localhost/SberbankTerminals/api/Pay?command=check&txn_id=1234567&account=4957835959&sum=10.45</code>

Строка запроса содержит следующие обязательные переменные:

*'''command'''='''check''' – запрос на проверку состояния Плательщика<br>
*'''txn_id'''=1234567 – внутренний номер платежа в системе Банка<br>
*'''account'''=4957835959 – идентификатор Плательщика в информационной системе Клиента<br>
*'''sum'''=10.45 – сумма к зачислению на лицевой счет Плательщика. Представляет собой дробное число с точностью до сотых, в качестве разделителя используется «.» (точка). 

Ответ клиента выглядит следующим образом:

<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="100%"><TR><TD>
<syntaxhighlight lang="xml">
<response xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    '''<osmp_txn_id>1234567</osmp_txn_id>
    <result>0</result>
    <comment/>
    <sum>148139.25</sum>
    <inn/>
    <rs>111111111111111100000000000000</rs>
    <bik>044525593</bik>
    <ks>30101.810.2.00000000593</ks>
    <name>Фирма-владелец</name>
    <bank_name>Тестовый банк</bank_name>
</response>
</syntaxhighlight>
</TD></TR></TABLE>

Возвращаемые значения:
*'''<osmp_txn_id>''' - номер транзакции в системе Банка, который передается Клиенту в переменной txn_id
*'''<result>''' - код результата завершения запроса
*'''<comment>''' - необязательный элемент – комментарий завершения операции
*'''<sum>''' - сумма платежа. Представляет собой дробное число с точностью до сотых, в качестве разделителя используется «.» (точка).
*'''<inn>''' - ИНН Плательщика.
*'''<rs>''' - расчётный счёт Плательщика.
*'''<bik>''' - БИК Банка Плательщика.
*'''<ks>''' - кор. счёт Банка Плательщика
*'''<name>''' - наименование Плательщика.
*'''<bank_name>''' - наименование банка Плательщика.

Возврат <code><result>0</result></code> на запрос «check» свидетельствует о том, что лицевой счет Плательщика с соответствующим ему номером <code>osmp_txn_id</code> может быть пополнен на сумму, указанную в запросе.

===Запрос на пополнение лицевого счёта плательщика===

<code>https://localhost/SberbankTerminals/api/Pay?command=pay&txn_id=1234567&txn_date=20050815120133&account=4957835959&sum=10.45</code>

Строка запроса содержит следующие обязательные переменные:

*'''command'''='''pay''' – запрос на пополнение баланса Плательщика<br>
*'''txn_id'''=1234567 – внутренний номер платежа в системе Банка<br>
*'''txn_date'''=20050815120133 – дата учета платежа в системе Банка<br>
*'''account'''=4957835959 – идентификатор Плательщика в информационной системе Клиента<br>
*'''sum'''=10.45 – сумма к зачислению на лицевой счет Плательщика<br>

Ответ клиента выглядит следующим образом:

<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="100%"><TR><TD>
<syntaxhighlight lang="xml">
<response xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <osmp_txn_id>1234567</osmp_txn_id>
    <result>0</result>
    <comment/>
    <sum>10.45</sum>
    <prv_txn>56</prv_txn>
</response>
</syntaxhighlight>
</TD></TR></TABLE>

Возвращаемые значения:
*'''<osmp_txn_id>''' - номер транзакции в системе Банка, который передается Клиенту в переменной <code>txn_id</code>
*'''<result>''' - код результата завершения запроса
*'''<comment>''' - необязательный элемент – комментарий завершения операции
*'''<sum>''' - сумма платежа. Представляет собой дробное число с точностью до сотых, в качестве разделителя используется «.» (точка).
*'''<prv_txn>''' - уникальный номер операции пополнения баланса Плательщика. 

Возвращая <code><result>0</result></code> на запрос «pay», Клиент сообщает об успешном завершении операции пополнения баланса. Система полностью завершает обработку данной транзакции.

===Коды завершения обработки запросов===

При обработке запросов от системы Банка, сервис возвращает соответствующие коды в элементе <code><result></code>. 
{| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse" width="800px"

|- style="background-color:#F2F2F2"

! width="20%" | Код
! width="50%" | Комментарий
! width="30%" | Фатальность

|- style="vertical-align:text-top"
| 0
| ОК.
| -

|- style="vertical-align:text-top"
| 1
| Временная ошибка. Повторите запрос позже.
| -

|- style="vertical-align:text-top"
| 4
| Неверный формат идентификатора Плательщика
| +

|- style="vertical-align:text-top"
| 5
| Идентификатор Плательщика не найден (Ошиблись номером)
| +

|- style="vertical-align:text-top"
| 7
| Прием платежа запрещен провайдером
| +

|- style="vertical-align:text-top"
| 8
| Прием платежа запрещен по техническим причинам
| +

|- style="vertical-align:text-top"
| 79
| Счет Плательщика не активен
| +

|- style="vertical-align:text-top"
| 79
| Счет Плательщика не активен
| +

|- style="vertical-align:text-top"
| 90
| Проведение платежа не окончено
| +

|- style="vertical-align:text-top"
| 241
| Сумма слишком мала
| +

|- style="vertical-align:text-top"
| 242
| Сумма слишком велика
| +

|- style="vertical-align:text-top"
| 243
| Невозможно проверить состояние счёта
| +

|- style="vertical-align:text-top"
| 300
| Другая ошибка провайдера
| +

|- style="vertical-align:text-top"
|}

[[Category:Платежные web-сервисы]]