Платежные web-сервисы: Сервис интеграции с платежной системой Uniteller (оплата картой в личном кабинете) — различия между версиями

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

@@ Строка 1: / Строка 1: @@
 Версия статьи от {{REVISIONDAY}}-{{REVISIONMONTH}}-{{REVISIONYEAR}}
+[[Файл: mb_030.png|left|Предупреждение]] <BR> Начиная с релиза 15.8 после 01.06.2023 работа с отдельными платежными шлюзами не поддерживается. Для работы необходимо использовать новую версию приложения [[Платежные web-сервисы:EntryPoint|EntryPoint (оплата картой в личном кабинете с выбором системы оплаты)]] с поддержкой Uniteller, Sberbank, Tinkoff, Alfabank, Assist, PayOnline, WebPay без установки сторонних библиотек и развертывания отдельных сервисов.<br />
+<br><br />
 ==Введение==
+[[Файл: mb_030.png|left|Предупреждение]] <BR> Перед началом работы с платежными системами необходимо удостовериться в соответствии оборудования и программного обеспечения [[Мастер-Тур(15):Системно-аппаратные требования|системно-аппаратным требованиям]]. Если версия операционной системы не соответствует рекомендуемой, то работа с платежными сервисами не гарантирована в связи с ограничениями протоколов безопасности операционной системы.<br />
+<br><br />
 Данный модуль реализует возможность '''оплаты путевок через систему электронных платежей «Uniteller»'''.<br />
 «Uniteller» - это мультибанковская система платежей по пластиковым и виртуальным картам через интернет, позволяющая в реальном времени производить авторизацию и обработку транзакций.
@@ Строка 7: / Строка 10: @@
 ==Установка==
 Для установки дополнительного модуля '''Сервис интеграции с платежной системой «Uniteller»''' нужно создать директорию '''Uniteller''' в каталоге <code>C:/inetpub/wwwroot</code> (корневом каталоге '''IIS''')  и выложить туда распакованные файлы из архива<br />
-<code>payments-uniteller-X.X.XX.XXXXX.zip</code>.<br />
+<code>payments-uniteller-X.X.XX.XXXXX.zip</code>.<br>Устанавливать дополнительный модуль необходимо в том же домене, где расположено основное приложение ПК «Мастер-Web».<br />Начиная с релиза '''9222SP0''', если используется [[Платежные web-сервисы: Выбор платежной системы (оплата картой в личном кабинете)|дополнительный модуль Выбор платежной системы (оплата картой в личном кабинете)]], то необходимо скопировать файл <code>Megatec.MasterWeb.PaymentSystem.Uniteller.dll</code> из '''<code>/Payments/bin/</code>''' и разместить в папке '''<code>/EntryPoint/bin/</code>'''.<br>
 В '''управлении IIS''' необходимо создать ''виртуальный каталог'' для папки '''Uniteller'''.
@@ Строка 28: / Строка 31: @@
 В файле <code>web.config</code>, расположенном в папке '''Uniteller''' пропишите необходимые параметры подключения (<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><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><add key = "connectionStringShort" value = "Data Source=<span style="color:red">ip-адрес сервера базы данных ПК «Мастер-Тур»</span>;Initial Catalog=<span style="color:red">название базы данных ПК «Мастер-Тур»</span>"/></code>
 ==Настройка==
@@ Строка 50: / Строка 52: @@
 | 1
 | Включение дополнительного модуля '''Система онлайн платежей'''.
-Обязательная настройка.
+Обязательная настройка.<br>
-| - '''Путь к приложению «Система онлайн платежей»'''.
+<font style="color:red">'''Внимание!'''</font> Путь к приложению обязательно должен содержать ссылку на приложение из внешней сети. В противном случае, она не будет работать.
+| '''Путь к приложению «Система онлайн платежей»'''.
 |<syntaxhighlight lang="xml" enclose="div">
- <add key="paymentsLink" value="http://somesite/Uniteller" />
+<add key="paymentsLink" value="http://somesite/Uniteller" />
 </syntaxhighlight>
@@ Строка 61: / Строка 64: @@
 | Настройка, определяющая '''статусы путевок''', при которых '''доступна возможность оплаты''' через систему электронных платежей «Uniteller».
 Обязательная настройка.
-| - '''ключи статусов''' из таблицы <code>'''[Order_Status]'''</code>, при которых ''доступна оплата'' через «Uniteller».
+| '''Ключи статусов''' из таблицы <code>'''[Order_Status]'''</code>, при которых ''доступна оплата'' через «Uniteller».
 |<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" />
@@ Строка 80: / Строка 84: @@
 | 4
 | Настройка, включающая '''механизм хэширования пароля пользователя''', сохраняемого в файлах <code>cookie</code>, что позволяет усилить безопасность ПК «Мастер-Web».
-По умолчанию хэширование включено.
+По умолчанию хэширование включено.<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" />
 </syntaxhighlight>
+|- style="vertical-align:text-top"
+| 5
+|Настройка, определяющая партнеров в базе ПК «Мастер-Тур», которым разрешено осуществлять оплату путёвок онлайн. <br>
+<font style="color:red">''Внимание!''</font> Настройка обрабатывается, начиная с релиза '''9223SP0'''
+|
+*'''Ключи партнеров''' таблицы [tbl_Partners], которым разрешена онлайн-оплата путёвок;
+*'''пустое значение''' или '''отсутствие настройки''' –  онлайн-оплата путёвок доступна всем партнёрам.
+| <syntaxhighlight lang="xml" enclose="div">
+<add key="allowedPaymentPartnerKeys" value="10764"/>
+</syntaxhighlight>
+|- style="vertical-align:text-top"
+| 6
+| Настройка, позволяющая производить оплату в новой вкладке браузера.<br>
+<font style="color:red">Внимание! Настройка обрабатывается, начиная с релиза '''9222SP0'''.</font>
+<br><font style="color:red">'''Важно!'''</font><br />
+Если данная настройка прописана в файле <code>web.config</code> основного приложения, то она должна быть прописана и в платежном сервисе с тем же значением.
+|
+* '''false''' или '''отсутствие настройки''' - оплата производится в текущей вкладке браузера;
+* '''true''' - оплата производится в новой вкладке браузера.
+|<syntaxhighlight lang="xml" enclose="div">
+<add key="OpenPaymentInNewWindow" value="true" />
+</syntaxhighlight>
+|- style="vertical-align:text-top"
 |}
@@ Строка 104: / Строка 137: @@
 | 1
+| '''Точки продажи''' ('''shopIDP''')
+Обязательная настройка.
+| '''Uniteller Point ID''' из раздела Точки продажи ЛК «Uniteller».
+|<syntaxhighlight lang="xml" enclose="div">
+<add key="shopIDP" value="00005432"/>
+</syntaxhighlight>
+|- style="vertical-align:text-top"
+| 2
 | '''Логин'''
 Обязательная настройка.
-| - '''Login''' из раздела Параметры авторизации ЛК «Uniteller».
+| '''Login''' из раздела Параметры авторизации ЛК «Uniteller».
 |<syntaxhighlight lang="xml" enclose="div">
 <add key="login" value="2281" />
@@ Строка 113: / Строка 156: @@
 |- style="vertical-align:text-top"
-| 2
+| 3
 | '''Пароль'''
 Обязательная настройка.
-| - '''Password''' из раздела Параметры авторизации ЛК «Uniteller».
+| '''Password''' из раздела Параметры авторизации ЛК «Uniteller».
 |<syntaxhighlight lang="xml" enclose="div">
 <add key="password" value="XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX" />
@@ Строка 123: / Строка 166: @@
 |- style="vertical-align:text-top"
-| 3
+| 4
 | Настройка, определяющая '''валюту''', в которой будет '''совершаться платеж''' через систему «Uniteller».
 Обязательная настройка.
-| - '''Contract''' - оплата в ''валюте путевки'';
+|
-- '''Tour''' -  оплата в ''валюте тура'';<br />
+* '''Contract''' - оплата в ''валюте путевки'';
-- '''National''' – оплата в ''национальной валюте'';<br />
+* '''Tour''' -  оплата в ''валюте тура'';<br />
-- '''DefinedBySettings''' - оплата в ''валюте'', ''определенной настройкой'' '''Сurrency'''.
+* '''National''' – оплата в ''национальной валюте'';<br />
+* '''DefinedBySettings''' - оплата в ''валюте'', ''определенной настройкой'' '''Сurrency'''.
 |<syntaxhighlight lang="xml" enclose="div">
 <add key="currencyToPay" value="Contract" />
@@ Строка 136: / Строка 180: @@
 |- style="vertical-align:text-top"
-| 4
+| 5
 | Настройка, определяющая '''код валюты''', в которой будет '''совершаться платеж''' через платежную систему «Uniteller» при '''значении DefinedBySettings  настройки currencyToPay'''.
-| - '''Код валюты''' (Поле '''RA_CODE''' из таблицы <code>'''[Rates]'''</code>).
+| '''Код валюты''' (Поле '''RA_CODE''' из таблицы <code>'''[Rates]'''</code>).
 Код валюты из ПК «Мастер-Тур» должен быть сопоставлен с кодом валюты в системе «Uniteller». Данное сопоставление задается в секции <code>'''<currencyMap>'''</code>, в качестве параметра '''key''' указывается '''код валюты''' из ПК «Мастер-Тур», в качестве  параметра '''value''' задается '''код валюты''' в системе «Uniteller», например:<br />
 <syntaxhighlight lang="xml">
@@ Строка 153: / Строка 197: @@
 |- style="vertical-align:text-top"
-| 5
+| 6
 | Настройка, определяющая '''тип операции при проведении платежа'''.
 Обязательная настройка.
-| - '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).
+| '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).
+|<syntaxhighlight lang="xml" enclose="div">
+<add key="PaymentOperationId" value="1" />
+</syntaxhighlight>
+|- style="vertical-align:text-top"
+| 7
+| Настройка, определяющая '''тип операции при проведении платежа для комиссий'''.
+| '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).
 |<syntaxhighlight lang="xml" enclose="div">
-<add key="kindOfPay" value="6" />
+<add key="paymentOperationCommissionId" value="6" />
 </syntaxhighlight>
 |- style="vertical-align:text-top"
-| 6
+| 8
 | Настройка, определяющая '''пользователя''' ПК «Мастер-Тур», к которому будет '''привязываться оплата'''.
 Обязательная настройка.
-| - '''Ключ пользователя''', к которому ''привязывается оплата'' (Поле '''US_KEY''' из таблицы <code>'''[UserList]'''</code>).
+| '''Ключ пользователя''', к которому ''привязывается оплата'' (Поле '''US_KEY''' из таблицы <code>'''[UserList]'''</code>).
 |<syntaxhighlight lang="xml" enclose="div">
 <add key="masterTourUser" value="80" />
@@ Строка 173: / Строка 226: @@
 |- style="vertical-align:text-top"
-| 7
+| 9
 | Настройка, определяющая '''партнера''', к которому будет '''привязываться оплата'''.
 Обязательная настройка.
-| - '''Ключ филиала''', к которому ''привязывается оплата'' (Поле '''PR_KEY''' из таблицы <code>'''[Partners]'''</code>).
+| '''Ключ филиала''', к которому ''привязывается оплата'' (Поле '''PR_KEY''' из таблицы <code>'''[Partners]'''</code>).
 |<syntaxhighlight lang="xml" enclose="div">
 <add key="paymentFilialKey" value="1" />
@@ Строка 183: / Строка 236: @@
 |- style="vertical-align:text-top"
-| 8
+| 10
 | Настройка, определяющая '''отдел''', к которому будет '''привязываться оплата'''.
 Обязательная настройка.
-| - '''Ключ отдела''' ('''кассы'''), к которому ''привязывается оплата'' (Поле '''PDP_KEY''' из таблицы <code>'''[PrtDeps]'''</code>).
+| '''Ключ отдела''' ('''кассы'''), к которому ''привязывается оплата'' (Поле '''PDP_KEY''' из таблицы <code>'''[PrtDeps]'''</code>).
 |<syntaxhighlight lang="xml" enclose="div">
 <add key="departmentKey" value="2" />
@@ Строка 193: / Строка 246: @@
 |- style="vertical-align:text-top"
-| 9
+| 11
 | Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для агентств''').
-| - '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется запятой).
+| '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется запятой).
 Комиссия указывается '''в процентах'''.<br />
 Сумма оплаты вычисляется следующим образом:<br />
@@ Строка 210: / Строка 263: @@
 |- style="vertical-align:text-top"
-| 10
+| 12
 | Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для частных лиц''').
-| - '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется запятой).
+| '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется запятой).
 Комиссия указывается '''в процентах'''.<br />
 Сумма оплаты вычисляется следующим образом:<br />
@@ Строка 227: / Строка 280: @@
 |- style="vertical-align:text-top"
-| 11
+| 13
+| Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками ''NewDogovorServiceSvKey'' и ''NewDogovorServicePartnerKey''.
+<span style="color:red">Обрабатывается с релиза 15.4.</span>
+| Ключ услуги (Поле '''SL_KEY''' из таблицы <code>'''[ServiceList]'''</code>).
+|<syntaxhighlight lang="xml" enclose="div">
+<add key="NewDogovorServiceServiceListKey" value="450" />
+</syntaxhighlight>
+|- style="vertical-align:text-top"
+| 14
+| Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServicePartnerKey''.
+<span style="color:red">Обрабатывается с релиза 15.4.</span>
+| Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>).
+|<syntaxhighlight lang="xml" enclose="div">
+<add key="NewDogovorServiceSvKey" value="1055" />
+</syntaxhighlight>
+|- style="vertical-align:text-top"
+| 15
+| Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServiceSvKey''.
+<span style="color:red">Обрабатывается с релиза 15.4.</span>
+| Ключ класса услуги (Поле '''PR_KEY''' из таблицы <code>'''[Partners]'''</code>).
+|<syntaxhighlight lang="xml" enclose="div">
+<add key="NewDogovorServicePartnerKey" value="12921" />
+</syntaxhighlight>
+|- style="vertical-align:text-top"
+| 16
+| Настройка, задающая услугу страхования, добавляемую в фискальный чек. Применяется в случае если в путевке отсутствует скрытая услуга "Операторский тур".
+<span style="color:red">Обрабатывается с релиза 15.8.</span> Описание формирования чека с данными настройками находится в разделе [[Платежные web-сервисы: Сервис интеграции с платежной системой Uniteller (оплата картой в личном кабинете)#Формирование чека при использовании скрытой услуги "Операторский тур" в путевке|Формирование чека при использовании скрытой услуги "Операторский тур" в путевке]].
+| Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>).
+|<syntaxhighlight lang="xml" enclose="div">
+<add key="InsuranceServiceKey" value="6"/>
+</syntaxhighlight>
+|- style="vertical-align:text-top"
+| 17
+| Настройка задающая название услуги в фискальном чеке если в путевке имеется скрытая услуга "Операторский тур". <span style="color:red">Обрабатывается с релиза 15.8.</span> Описание формирования чека с данными настройками находится в разделе [[Платежные web-сервисы: Сервис интеграции с платежной системой Uniteller (оплата картой в личном кабинете)#Формирование чека при использовании скрытой услуги "Операторский тур" в путевке|Формирование чека при использовании скрытой услуги "Операторский тур" в путевке]].
+| Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>).
+|<syntaxhighlight lang="xml" enclose="div">
+<add key="OperatorTourServiceKey" value="1134"/>
+</syntaxhighlight>
+|- style="vertical-align:text-top"
+| 18
 |Платёжная система кредитной карты.
 |
@@ Строка 242: / Строка 345: @@
 |- style="vertical-align:text-top"
-| 12
+| 19
 |Тип электронной валюты.
 |
@@ Строка 269: / Строка 372: @@
 |- style="vertical-align:text-top"
-| 13
+| 20
+| Адреса конечных точек [[Мастер-Тур:Установка#Установка службы подписи путевок и платежей|сервиса]].<BR>
+''Только'' для релиза 2009.2.21 данные настройки являются обязательными.
+| В тегах endpoint указываются сервер и порт сервиса. По умолчанию указан локальный компьютер и стандартный порт. Если служба установлена на другом компьютере, то необходимо указать его ip-адрес и порт. Если на компьютере, где устанавливается сервис, стандартный порт 8080 занят, то необходимо указать другой свободный порт.
+|<syntaxhighlight lang="xml" enclose="div">
+<endpoint address="http://localhost:8080//PaymentSignatureServiceHost/SignService/"
+--/>
+<endpoint address="http://localhost:8080//PaymentSignatureServiceHost/PaymentService/"
+--/>
+</syntaxhighlight>
+[[Мастер-Тур:Установка#Настройка MW для работы с сервисом|подробное описание блока для подключения к службе подписи путевок и платежей]]
+|- style="vertical-align:text-top"
+| 21
+| Настройка, включающая '''механизм хэширования пароля пользователя''', сохраняемого в файлах <code>cookie</code>, что позволяет усилить безопасность ПК «Мастер-Web».
+По умолчанию хэширование включено.
+|
+* '''false''' или '''отсутствие настройки''' - хэширование пароля в файлах <code>cookie</code> ''выключено'';
+* '''true''' - хэширование пароля в файлах <code>cookie</code> ''включено''.
+|<syntaxhighlight lang="xml" enclose="div">
+<add key="HashPasswordForCookie" value="true" />
+</syntaxhighlight>
+|- style="vertical-align:text-top"
+| 22
+|<font style="color:red">Настройку необходимо указывать с релиза 9220SP16 по 9220SP30 включительно''</font><br />
+Определяет '''тип платежной системы''' при сохранении платежей.
+Информация о типе платежной системы записывается в [[Мастер-Тур:Работа с группой путевок#История путевки|историю по путевке]].<br />
+Для системы '''«Мастер-Финанс»''' информация записывается в столбец '''DP_PAYMENTSSYS''' таблицы <code>'''[FIN_DOGOVOR_PAID]'''</code>.<br />
+Обязательная настройка.
+| Название платежной системы
+|<syntaxhighlight lang="xml" enclose="div">
+<add key="PaymentSystem" value="Uniteller"/>
+</syntaxhighlight>
+|- style="vertical-align:text-top"
+| 23
+| Включение функционала фискализации платежей.<br />
+После включения необходимо заполнить настройки '''Код системы налогообложения''' ('''TaxMode''') и '''Код ставки налогообложения''' ('''TaxRateCode''').<br />
+<span style="color:red">Обрабатывается с релиза 9.2.23.0 и 15.2.</span>
+|
+* '''true''' – использовать фискализацию при оплате
+* '''false или отсутствие настройки''' – не использовать фискализацию при оплате
+|<syntaxhighlight lang="xml" enclose="div">
+<add key="UseFiscalization" value="true"/>
+</syntaxhighlight>
+|- style="vertical-align:text-top"
+| 24
+| Код системы налогообложения, его значение должно соответствовать режимам налогообложения, сконфигурированным в ККМ при регистрации. Данная настройка необходима для работы фискализации платежей.
+<span style="color:red">Обрабатывается с релиза 9.2.23.0 и 15.2.</span>
+|
+* '''0''' – общая система налогообложения
+* '''1''' – упрощенная система налогообложения (Доход)
+* '''2''' – упрощенная СН (Доход минус Расход)
+* '''3''' – единый налог на вмененный доход
+* '''4''' – единый сельскохозяйственный налог
+* '''5''' – патентная система налогообложения
+|<syntaxhighlight lang="xml" enclose="div">
+<add key="TaxMode" value=""/>
+</syntaxhighlight>
+|- style="vertical-align:text-top"
+| 25
+| Код ставки налогообложения. Данная настройка необходима для работы фискализации платежей.
+<span style="color:red">Обрабатывается с релиза 9.2.23.0 и 15.2.</span>
+|
+* '''-1''' – не облагается НДС
+* '''0''' – облагается НДС по ставке 0%
+* '''10''' – облагается НДС по ставке 10%
+* '''18''' – облагается НДС по ставке 18%
+* '''110''' – облагается НДС по ставке 10/110
+* '''118''' – облагается НДС по ставке 18/118
+|<syntaxhighlight lang="xml" enclose="div">
+<add key="TaxRateCode" value=""/>
+</syntaxhighlight>
+|- style="vertical-align:text-top"
+| 26