Мастер-Web:Дополнительный модуль Сервис интеграции с платежной системой Oblako — различия между версиями

[непроверенная версия]

[досмотренная версия]

Текущая версия на 13:17, 15 мая 2018

Версия статьи от 15-05-2018.

Поддерживаемые версии ПК «Мастер-Web»:
Начиная с версии 2009.2.20.31

Содержание

1 Введение
2 Установка
- 2.1 Создание виртуального каталога
- 2.2 Подключение к базе данных ПК «Мастер-Тур»
3 Настройка
- 3.1 Настройки ПК «Мастер-Web»
- 3.2 Настройки приложения «Система онлайн платежей»
4 Подготовка данных
5 Работа в системе
- 5.1 Поиск путевки
- 5.2 Оплата путевки

Введение

Платежная система Oblako предоставляет доступ к различным способам оплаты через Сбербанк, упрощая ввод платежной информации до простого ввода кода оплаты. Плюс данной платежной системы в отсутствии комиссии за совершаемые платежи и широкое распространение Сбербанка. Сервис интеграции с платежной системой позволяет встроить взаимодействие с данной платежной системой в ПК «Мастер-Web». А именно, позволит распечатать квитанцию (предоставляемую платежной системой), с помощью которой можно оплатить путевку любым предоставляемым Сбербанком способом.

Установка

Для установки дополнительного модуля Сервис интеграции с платежной системой «Oblako» нужно создать директорию Payments в каталоге C:/inetpub/wwwroot (корневом каталоге IIS) и выложить туда распакованные файлы из архива
payments-oblako-9.2.20.XXXXX.zip.
Начиная с релиза 9222SP0, если используется дополнительный модуль Выбор платежной системы (оплата картой в личном кабинете), то необходимо скопировать файл Megatec.MasterWeb.PaymentSystem.Oblako.dll из /Payments/bin/ и разместить в папке /EntryPoint/bin/.
В управлении IIS необходимо создать виртуальный каталог для папки Payments.

Создание виртуального каталога

По умолчанию корневым каталогом IIS является C:/Inetpub/wwwroot. Для создания виртуального каталога для приложения находящегося в этом каталоге нужно выполнить следующие действия:
1 Зайти в Пуск (Start) → Настройки (Settings) → Панель управления (Control Panel) → Администрирование (Administrative Tools)

2 Диспетчер служб IIS

3 В открывшемся дереве каталогов выбрать Web Sites – Default Web Site. В открывшемся списке найти папку, для которой нужно создать виртуальный каталог, кликнуть по ней правой кнопкой мыши и выбрать Преобразовать в приложение

4 В открывшемся окне нужно нажать кнопку ОК

Подключение к базе данных ПК «Мастер-Тур»

В файле web.config, расположенном в папке Payments пропишите необходимые параметры подключения (красным цветом выделены значения, которые необходимо ввести). Строка подключения к базе данных ПК «Мастер-Тур»:

<add key = "connectionString" value = "Data Source=ip-адрес сервера базы данных ПК «Мастер-Тур»;Initial Catalog=название базы данных ПК «Мастер-Тур»;User ID=логин пользователя ПК «Мастер-Тур»;Password=пароль пользователя ПК «Мастер-Тур»"/>
<add key = "connectionStringShort" value = "Data Source=ip-адрес сервера базы данных ПК «Мастер-Тур»;Initial Catalog=название базы данных ПК «Мастер-Тур»"/>

Настройка

После установки надстройка Сервис интеграции с платежной системой Oblako доступна в экранах «Список заявок» и «Информация о заказе».

Настройки ПК «Мастер-Web»

Настройки задаются в секции <appSettings> файла web.config основного приложения ПК «Мастер-Web».

№	Описание	Значение	Настройка
1	Включение дополнительного модуля Система онлайн платежей. Обязательная настройка.	Путь к приложению «Система онлайн платежей».	<add key="paymentsLink" value="http://somesite/Payments" />
2	Настройка, определяющая статусы путевок, при которых доступна возможность оплаты через систему электронных платежей «Oblako». Обязательная настройка.	Ключи статусов из таблицы `[Order_Status]`, при которых доступна оплата через «Oblako».	<add key="paymentsStatuses" value="7,37" />
3	Настройка, позволяющая выводить предупреждающее сообщение о снятии комиссии при оплате.	true — сообщение отображается; false или отсутствие настройки — сообщение не отображается.	<add key="askUserBeforePayment" value="true" />
4	Настройка, включающая механизм хэширования пароля пользователя, сохраняемого в файлах `cookie`, что позволяет усилить безопасность ПК «Мастер-Web». По умолчанию хэширование включено. Важно! Если данная настройка прописана в файле `web.config` основного приложения, то она должна быть прописана и в платежном сервисе с тем же значением.	false - хэширование пароля в файлах `cookie` выключено; true или отсутствие настройки - хэширование пароля в файлах `cookie` включено.	<add key="HashPasswordForCookie" value="true" />

Настройки приложения «Система онлайн платежей»

Настройки задаются в секции <Oblako> файла web.config приложения Система онлайн платежей.

Секция <Oblako> должна начинаться с заглавной буквы.

№	Описание	Значение	Настройка
1	Идентификатор клиента, который выдается платежной системой Oblako при подключении ТО. Обязательная настройка.	Идентификатор клиента	<add key="providerId" value="ХХХХХХХХХХХХХХХХХХХХХХ" />

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

№	Описание	Значение	Настройка
1	Настройка, включающая механизм хэширования пароля пользователя, сохраняемого в файлах `cookie`, что позволяет усилить безопасность ПК «Мастер-Web». По умолчанию хэширование включено. Важно! Если данная настройка прописана в файле `web.config` платежного сервиса, то она должна быть прописана и в основном приложении с тем же значением.	false - хэширование пароля в файлах `cookie` выключено; true или отсутствие настройки - хэширование пароля в файлах `cookie` включено.	<add key="HashPasswordForCookie" value="true" />

Подготовка данных

Для работы с платежной системой Oblako необходимо установить Финансовый сервис и сообщить его адрес платежному сервису Oblako. Далее платежная система "Oblako" должна отправить идентификатор, который необходимо прописать в настройке providerId.
Оплату можно произвести по путевкам, статус которых указан в настройке paymentsStatuses.

Работа в системе

Поиск путевки

Список заявок, забронированных в базе данных туроператора, доступен в экране «Список заказов» по адресу: http://ip-адрес сервера Мастер-Веб/MasterWebStandard/OrderList.aspx.

Экран «Список заказов» доступен только для зарегистрированных и авторизованных в системе пользователей.

После ввода имени пользователя и пароля загрузится список заявок, оформленных на покупателя/агентство, указанного в поле «Партнер в БД МТ» при регистрации пользователя в Системе администрирования ПК «Мастер-Web», который сопоставлен имени текущего пользователя.

Для отбора путевок можно использовать фильтры:

Поиск по номеру заявки;
Поиск по фамилии туриста;
Поиск по статусу документов на визу;
Поиск по стране;
Поиск по дате заявки;
Дата тура с... и Дата тура по...;
Путевки с наличием услуги «Виза»;
Путевки с задолженностями.

Оплата путевки

Оплата доступна только для путевок имеющих статус, ключ которого указан в настройке paymentsStatuses.

Оплата путевок доступна в экранах «Список заявок» и «Информация о заказе».

Экран Список заказов доступен по адресу: http://ip-адрес сервера Мастер-Веб/MasterWebStandard/OrderList.aspx.

Экран Информация о заказе доступен по адресу: http://ip-адрес сервера Мастер-Веб/MasterWebStandard/OrderInfo.aspx.

Для оплаты путевки через систему электронных платежей «Oblako» необходимо нажать ссылку Оплатить для нужной путевки (или кнопку Оплатить on-line в экране Информация о заказе).

При успешном проведении платежа автоматически загружается файл квитанции.

@@ Строка 1: / Строка 1: @@
 Версия статьи от {{REVISIONDAY}}-{{REVISIONMONTH}}-{{REVISIONYEAR}}.
+<table style="background-color:#ffffcc;color:black" border="1" cellpadding="10" cellspacing="0"><tr><td>
+Поддерживаемые версии ПК «Мастер-Web»:<br>
+Начиная с версии 2009.2.20.31
+</td></tr></table><br>
 ==Введение==
-Данный модуль реализует возможность '''оплаты путевок через систему электронных платежей «Oblako»'''.<br />
+Платежная система [https://oblako.travel/ Oblako] предоставляет доступ к различным способам оплаты [https://oblako.travel/howto через Сбербанк], упрощая ввод платежной информации до простого ввода кода оплаты. Плюс данной платежной системы в отсутствии комиссии за совершаемые платежи и широкое распространение Сбербанка.
-Сервис интеграции с платежной системой «Oblako» - это мультибанковская система платежей по пластиковым и виртуальным картам через интернет, позволяющая в реальном времени производить авторизацию и обработку транзакций.
+Сервис интеграции с платежной системой позволяет встроить взаимодействие с данной платежной системой в ПК «Мастер-Web». А именно, позволит распечатать квитанцию (предоставляемую платежной системой), с помощью которой можно оплатить путевку любым предоставляемым Сбербанком способом.
 ==Установка==
 Для установки дополнительного модуля '''Сервис интеграции с платежной системой «Oblako»''' нужно создать директорию '''Payments''' в каталоге <code>C:/inetpub/wwwroot</code> (корневом каталоге '''IIS''')  и выложить туда распакованные файлы из архива<br />
-<code>payments-oblako-9.2.20.XXXXX.zip</code>.<br />
+<code>payments-oblako-9.2.20.XXXXX.zip</code>.<br />Начиная с релиза '''9222SP0''', если используется [[Платежные web-сервисы: Выбор платежной системы (оплата картой в личном кабинете)|дополнительный модуль Выбор платежной системы (оплата картой в личном кабинете)]], то необходимо скопировать файл <code>Megatec.MasterWeb.PaymentSystem.Oblako.dll</code> из '''<code>/Payments/bin/</code>''' и разместить в папке '''<code>/EntryPoint/bin/</code>'''.<br>
 В '''управлении IIS''' необходимо создать ''виртуальный каталог'' для папки '''Payments'''.
@@ Строка 51: / Строка 54: @@
 | Включение дополнительного модуля '''Система онлайн платежей'''.
 Обязательная настройка.
-| - '''Путь к приложению «Система онлайн платежей»'''.
+| '''Путь к приложению «Система онлайн платежей»'''.
 |<syntaxhighlight lang="xml" enclose="div">
- <add key="paymentsLink" value="http://somesite/Payments" />
+<add key="paymentsLink" value="http://somesite/Payments" />
 </syntaxhighlight>
@@ Строка 61: / Строка 64: @@
 | Настройка, определяющая '''статусы путевок''', при которых '''доступна возможность оплаты''' через систему электронных платежей «Oblako».
 Обязательная настройка.
-| - '''ключи статусов''' из таблицы <code>'''[Order_Status]'''</code>, при которых ''доступна оплата'' через «Oblako».
+| '''Ключи статусов''' из таблицы <code>'''[Order_Status]'''</code>, при которых ''доступна оплата'' через «Oblako».
 |<syntaxhighlight lang="xml" enclose="div">
 <add key="paymentsStatuses" value="7,37" />
@@ Строка 70: / Строка 73: @@
 | 3
 | Настройка, позволяющая '''выводить предупреждающее сообщение''' о ''снятии комиссии при оплате''.
-| – '''true''' — сообщение ''отображается'';
+|
-– '''false''' или '''отсутствие настройки''' — сообщение ''не отображается''.
+* '''true''' — сообщение ''отображается'';
+* '''false''' или '''отсутствие настройки''' — сообщение ''не отображается''.
 |<syntaxhighlight lang="xml" enclose="div">
 <add key="askUserBeforePayment" value="true" />
@@ Строка 79: / Строка 83: @@
 | 4
-| Настройка, включающая '''механизм хэширования пароля пользователя''', сохраняемого в файлах <code>cookie</code>, что позволяет усилить безопасность ПК «Мастер-Web».
+| Настройка, включающая '''механизм хэширования пароля пользователя''', сохраняемого в файлах <code>cookie</code>, что позволяет усилить безопасность ПК «Мастер-Web». <br />
-По умолчанию хэширование включено.
+По умолчанию хэширование включено.<br />
-| - '''false''' - хэширование пароля в файлах <code>cookie</code> ''выключено'';
+<font style="color:red">Важно!</font><br />
-- '''true''' или '''отсутствие настройки''' - хэширование пароля в файлах <code>cookie</code> ''включено''.
+Если данная настройка прописана в файле <code>web.config</code> основного приложения, то она должна быть прописана и в платежном сервисе с тем же значением.
+|
+* '''false''' - хэширование пароля в файлах <code>cookie</code> ''выключено'';
+* '''true''' или '''отсутствие настройки''' - хэширование пароля в файлах <code>cookie</code> ''включено''.
 |<syntaxhighlight lang="xml" enclose="div">
 <add key="HashPasswordForCookie" value="true" />
@@ Строка 93: / Строка 100: @@
   Секция '''<Oblako>''' должна начинаться с заглавной буквы.
-<br />
+<br /><br />
 {| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse"
@@ Строка 108: / Строка 115: @@
 | Идентификатор клиента, который выдается платежной системой Oblako при подключении ТО.
 Обязательная настройка.
-| - '''Идентификатор клиента'''
+| '''Идентификатор клиента'''
 |<syntaxhighlight lang="xml" enclose="div">
 <add key="providerId" value="ХХХХХХХХХХХХХХХХХХХХХХ" />
+</syntaxhighlight>
+|}
+<br />
+Настройки задаются в секции <code><appSettings></code> файла <code>web.config</code> приложения '''Система онлайн платежей'''
+<br /><br />
+{| 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
+| Настройка, включающая '''механизм хэширования пароля пользователя''', сохраняемого в файлах <code>cookie</code>, что позволяет усилить безопасность ПК «Мастер-Web».
+По умолчанию хэширование включено.<br />
+<font style="color:red">Важно!</font><br />
+Если данная настройка прописана в файле <code>web.config</code> платежного сервиса, то она должна быть прописана и в основном приложении с тем же значением.
+|
+* '''false''' - хэширование пароля в файлах <code>cookie</code> ''выключено'';
+* '''true''' или '''отсутствие настройки''' - хэширование пароля в файлах <code>cookie</code> ''включено''.
+|<syntaxhighlight lang="xml" enclose="div">
+<add key="HashPasswordForCookie" value="true" />
 </syntaxhighlight>
 |}
 ==Подготовка данных==
-Для работы с платежной системой '''Oblako''' необходимо установить '''Финансовый сервис''', сообщить адрес его шлюза туроператору. Далее туроператор должен отправить идентификатор, который необходимо прописать в настройке '''providerId'''. <br />
+Для работы с платежной системой '''Oblako''' необходимо установить [[Платежные web-сервисы: Сервис интеграции с платежной системой (оплата через терминалы)|'''Финансовый сервис''']] и сообщить его адрес платежному сервису Oblako. Далее платежная система "Oblako" должна отправить идентификатор, который необходимо прописать в настройке '''providerId'''. <br />
 Оплату можно произвести по путевкам, '''статус''' которых указан в настройке '''paymentsStatuses'''.<br />
-Для возможности оплаты через платёжную систему '''Oblako''' тип платёжной операции ('''PaymentOperation'''), ключ которой указан в настройке '''kindOfPay''', должен [[Мастер-Тур:Финансовый блок#Справочник типовых операций|иметь бланки]] и [[Мастер-Тур:Финансовый блок#Справочник типовых операций|иметь признак «Приходный»]] (PO_Type is null or PO_Type = 0).
 ==Работа в системе==
@@ Строка 164: / Строка 196: @@
 [[Файл: ep_137.png|x500px|Схема оплаты путевки]]<br />
-При '''успешном''' проведении платежа автоматически загружается файл квитанции и в базе '''автоматически создается проводка''' и у путевки '''прописывается сумма оплаты'''. Также в [[Мастер-Тур:Работа с группой путевок#История путевки|истории путевки]] добавляется запись об '''оплате через платежную систему «Oblako»'''.
+При '''успешном''' проведении платежа автоматически загружается файл квитанции.
-[[Category:Мастер-Web_Дополнительные_модули]]

Мастер-Web:Дополнительный модуль Сервис интеграции с платежной системой Oblako — различия между версиями

Текущая версия на 13:17, 15 мая 2018

Содержание

Введение

Установка

Создание виртуального каталога

Подключение к базе данных ПК «Мастер-Тур»

Настройка

Настройки ПК «Мастер-Web»

Настройки приложения «Система онлайн платежей»

Подготовка данных

Работа в системе

Поиск путевки

Оплата путевки

Навигация

Персональные инструменты

Пространства имён

Варианты

Просмотры

Ещё

Поиск

Навигация

Инструменты