Платежные web-сервисы:EntryPoint — различия между версиями

Материал из Megatec
Перейти к: навигация, поиск
[непроверенная версия][досмотренная версия]
(Uniteller)
(Tinkoff (Т-Банк))
 
(не показана 51 промежуточная версия 4 участников)
Строка 4: Строка 4:
 
Модуль '''EntryPoint''' предоставляет возможность покупателю/агентству выбрать способ оплаты путевок. Оплата путевок может осуществляться в экранах «Список заявок» (OrderList.aspx) и «Путевка» (OrderInfo.aspx). <br />
 
Модуль '''EntryPoint''' предоставляет возможность покупателю/агентству выбрать способ оплаты путевок. Оплата путевок может осуществляться в экранах «Список заявок» (OrderList.aspx) и «Путевка» (OrderInfo.aspx). <br />
 
В данный момент доступны следующие способы оплаты:
 
В данный момент доступны следующие способы оплаты:
* [[Платежные web-сервисы: Сервис интеграции с платежной системой Alfabank (оплата картой в личном кабинете)|Alfabank]]
+
* Alfabank
* [[Платежные web-сервисы: Сервис интеграции с платежной системой Sberbank (оплата картой в личном кабинете)|Sberbank]]
+
* Sberbank
* [[Платежные web-сервисы: Сервис интеграции с платежной системой Tinkoff (оплата картой в личном кабинете)|Tinkoff]]
+
* Tinkoff (Т-Банк)
* [[Платежные web-сервисы: Сервис интеграции с платежной системой Uniteller (оплата картой в личном кабинете)|Uniteller]]
+
* Uniteller
 +
* YandexPay
 +
* Assist
 +
* WebPay
 +
* PayOnline
  
 
==Установка==  
 
==Установка==  
Строка 27: Строка 31:
 
[[Файл: am_748.png|x500px|Добавить приложение]]<br />
 
[[Файл: am_748.png|x500px|Добавить приложение]]<br />
 
<br />
 
<br />
 +
==Настройка==
 
===Подключение к базе данных ПК «Мастер-Тур»===
 
===Подключение к базе данных ПК «Мастер-Тур»===
 
В файле <code>web.config</code>, расположенном в папке '''EntryPoint''' пропишите необходимые параметры подключения (<span style="color:red">красным цветом</span> выделены значения, которые необходимо ввести).
 
В файле <code>web.config</code>, расположенном в папке '''EntryPoint''' пропишите необходимые параметры подключения (<span style="color:red">красным цветом</span> выделены значения, которые необходимо ввести).
Строка 133: Строка 138:
 
|}
 
|}
  
 
+
===Настройки в секции appSettings модуля EntryPoint===  
===Формат настроек в файле web.config модуля '''EntryPoint'''===  
 
 
Настройки секции <code><appSettings></code> файла <code>web.config</code> модуля EntryPoint.
 
Настройки секции <code><appSettings></code> файла <code>web.config</code> модуля EntryPoint.
 
{| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse"
 
{| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse"
Строка 165: Строка 169:
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
 +
| 3
 +
| Настройка, включающая механизм хэширования пароля пользователя, сохраняемого в файлах cookie, что позволяет усилить безопасность ПК "Мастер-Web". По умолчанию хэширование включено. '''Значение настройки должно совпадать со значением в файле web.config ПК "Мастер-Web"'''.
 +
|'''false''' - хэширование пароля в файлах cookie выключено;
 +
'''true''' или '''отсутствие настройки''' - хэширование пароля в файлах cookie включено.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="HashPasswordForCookie" value="true" />
 +
</syntaxhighlight>
  
| 3
+
|- style="vertical-align:text-top"
 +
 
 +
| 4
 
|Настройка интервала опроса платежной системы для проверки статуса незавершенных платежей. <br>
 
|Настройка интервала опроса платежной системы для проверки статуса незавершенных платежей. <br>
 
|
 
|
Строка 177: Строка 190:
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
| 4
+
| 5
 
| Настройка задержки проверки статуса платежа на платежной системе.
 
| Настройка задержки проверки статуса платежа на платежной системе.
 
|
 
|
Строка 186: Строка 199:
 
<add key ="TimeInMinuteForCheckStatePayments" value="10"/>
 
<add key ="TimeInMinuteForCheckStatePayments" value="10"/>
 
</syntaxhighlight>  
 
</syntaxhighlight>  
 +
 +
|- style="vertical-align:text-top"
 +
| 6
 +
|Текст правил оплаты <br>
 +
|
 +
Правила оплаты берутся из файла AgreementText.htm
 +
Если данный файл отсутствует, то описание правил оплаты берется из стандартного файла AgreementText_Standard.htm
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="agreementText" value="templates/AgreementText.htm" />
 +
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
 
|}
 
|}
  
Секция описания способов оплаты в платежных системах: <br />
+
===Настройки в секции paymentMethods модуля EntryPoint===
 +
В данной секции происходит настройка описания способов оплаты в платежных системах.
 +
Настройки секции <code><paymentMethods></code> файла <code>web.config</code> модуля EntryPoint.
 
  <paymentMethods>
 
  <paymentMethods>
 
     <add code="1" name="Tinkoff" logoLink="~/Content/logos/logoTinkoff.png" maximumAmount="1000000" skipDescriptionPage="false" paymentSystem="Tinkoff" link="https://securepay.tinkoff.ru/v2/Init/" />
 
     <add code="1" name="Tinkoff" logoLink="~/Content/logos/logoTinkoff.png" maximumAmount="1000000" skipDescriptionPage="false" paymentSystem="Tinkoff" link="https://securepay.tinkoff.ru/v2/Init/" />
Строка 198: Строка 223:
 
* '''name'''="Tinkoff" - название платежной системы (если не задана ссылка на логотип, то отображается кнопка с наименованием данного поля);
 
* '''name'''="Tinkoff" - название платежной системы (если не задана ссылка на логотип, то отображается кнопка с наименованием данного поля);
 
* '''paymentSystem'''="Tinkoff" - название платежной системы. Одно из предопределенных значений:
 
* '''paymentSystem'''="Tinkoff" - название платежной системы. Одно из предопределенных значений:
** [[Платежные web-сервисы: Сервис интеграции с платежной системой Alfabank (оплата картой в личном кабинете)|Alfabank]]
+
** Alfabank
** [[Платежные web-сервисы: Сервис интеграции с платежной системой Sberbank (оплата картой в личном кабинете)|Sberbank]] и Сбербанк-Мир, Сбербанк МИР Дети
+
** Sberbank и SberbankMir, SberbankChildren
** [[Платежные web-сервисы: Сервис интеграции с платежной системой Tinkoff (оплата картой в личном кабинете)|Tinkoff]]
+
** Tinkoff
** [[Платежные web-сервисы: Сервис интеграции с платежной системой Uniteller (оплата картой в личном кабинете)|Uniteller]]
+
** Uniteller и UnitellerMir, UnitellerChildren
 +
** Assist
 +
** WebPay
 +
** PayOnline
 
* '''LogoLink''' - расположение логотипа способа оплаты;
 
* '''LogoLink''' - расположение логотипа способа оплаты;
 
* '''maximumAmount''' - максимальный размер платежа;
 
* '''maximumAmount''' - максимальный размер платежа;
Строка 207: Строка 235:
 
Если значение skipDescriptionPage=true, то сразу происходит переход к оплате.<br />
 
Если значение skipDescriptionPage=true, то сразу происходит переход к оплате.<br />
 
Если значение skipDescriptionPage=false, то происходит переход на страницу редактирования суммы к оплате, а уже из нее переход к оплате на платежный шлюз.<br />
 
Если значение skipDescriptionPage=false, то происходит переход на страницу редактирования суммы к оплате, а уже из нее переход к оплате на платежный шлюз.<br />
* '''link''' - ссылка на платежную систему, по которой доступен данный способ оплаты;
+
* '''link''' - ссылка на платежную систему, по которой доступен данный способ оплаты.
  
Секция описания доступных способов оплаты, заданных в секции paymentMethods, текущему пользователю:
+
===Настройки в секции paymentAvailabilities модуля EntryPoint===
 +
В данной секции происходит настройка описания доступных способов оплаты, заданных в секции paymentMethods, текущему пользователю.
 
  <paymentAvailabilities>
 
  <paymentAvailabilities>
  <add code="1" paymentMethodCode="1" countryCode="7" filialCode="1" consumerCode="Person" isAvailable="false" priority="100"  paymentConditionCode="2" tourTypes="2"/>
+
  <add code="1" paymentMethodCode="1" countryCode="7" filialCode="1" consumerCode="Person" isAvailable="false" priority="100" tourTypes="2"/>
 
  </paymentAvailabilities>
 
  </paymentAvailabilities>
  
Строка 217: Строка 246:
 
* '''paymentMethodCode''' - идентификатор способа оплаты (''code'') из секции '''paymentMethod''';
 
* '''paymentMethodCode''' - идентификатор способа оплаты (''code'') из секции '''paymentMethod''';
 
* '''countryCode''' - ограничение доступности метода оплаты по ключу страны (''cn_key'' из таблицы ''tbl_country''). Может быть пустым - доступен для всех стран;
 
* '''countryCode''' - ограничение доступности метода оплаты по ключу страны (''cn_key'' из таблицы ''tbl_country''). Может быть пустым - доступен для всех стран;
* '''filialCode''' - ограничение доступности метода оплаты по коду партнера-филиала из его карточки. Может быть пустым - доступен для всех филиалов;
+
* '''filialCode''' - ограничение доступности метода оплаты по коду партнера-филиала из его карточки (поле ''PR_COD''). Может быть пустым - доступен для всех филиалов;
 
* '''consumerCode''' - ограничение по типу забронировавшего: турист или агентство. ''Person'' - для частных лиц, ''Agency'' - для турагентств;
 
* '''consumerCode''' - ограничение по типу забронировавшего: турист или агентство. ''Person'' - для частных лиц, ''Agency'' - для турагентств;
 
* '''isAvailable''' - включено или выключено это ограничение. Значение ''false'' равносильно отсутствию строки в секции;
 
* '''isAvailable''' - включено или выключено это ограничение. Значение ''false'' равносильно отсутствию строки в секции;
 
* '''priority''' - приоритет при выборе нескольких доступных вариантов оплаты;
 
* '''priority''' - приоритет при выборе нескольких доступных вариантов оплаты;
* '''paymentConditionCode''' - идентификатор (''code'') из секции ''paymentConditions'';
 
 
* '''tourTypes''' - ограничение доступности метода оплаты по ключу типа тура (''tp_key'' из таблицы ''TipTur''). Отсутствие параметра или пустой параметр - оплата доступна для всех типов туров.
 
* '''tourTypes''' - ограничение доступности метода оплаты по ключу типа тура (''tp_key'' из таблицы ''TipTur''). Отсутствие параметра или пустой параметр - оплата доступна для всех типов туров.
  
==Настройка секций платежных систем==
+
===Настройки подключения и параметров используемых платежных систем модуля EntryPoint===
Перед началом работы с платежными системами необходимо настроить секции используемых платежных систем.
+
Настройка подключения и параметров используемых платежных систем производится в конкретной секции платежной системы.
  
==Alfabank==
+
====Alfabank====
 
Настройки задаются в секции <code><Alfabank></code> файла <code>web.config</code> приложения '''EntryPoint'''.<br />
 
Настройки задаются в секции <code><Alfabank></code> файла <code>web.config</code> приложения '''EntryPoint'''.<br />
  
Строка 284: Строка 312:
  
 
| 5
 
| 5
 +
|Ссылка на платежный шлюз <br>
 +
|
 +
Ссылка на платежный шлюз
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="paymentSystemLoginURL" value="https://ws.egopay.ru/order/v2/" />
 +
</syntaxhighlight>
 +
 +
|- style="vertical-align:text-top"
 +
 +
| 6
 
|Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для агентств) <br>
 
|Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для агентств) <br>
 
|  
 
|  
Строка 294: Строка 332:
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 6
+
| 7
 
|Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для частных лиц) <br>
 
|Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для частных лиц) <br>
 
|  
 
|  
Строка 305: Строка 343:
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 7
+
| 8
 
| Настройка, определяющая '''пользователя''' ПК «Мастер-Тур», к которому будет '''привязываться оплата'''.
 
| Настройка, определяющая '''пользователя''' ПК «Мастер-Тур», к которому будет '''привязываться оплата'''.
 
Обязательная настройка.
 
Обязательная настройка.
Строка 315: Строка 353:
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 8
+
| 9
 
| Настройка, определяющая '''отдел''', к которому будет '''привязываться оплата'''.
 
| Настройка, определяющая '''отдел''', к которому будет '''привязываться оплата'''.
 
Обязательная настройка.
 
Обязательная настройка.
Строка 325: Строка 363:
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 9
+
| 10
 
| Настройка, включающая расчет через Мастер финанс.
 
| Настройка, включающая расчет через Мастер финанс.
 
|
 
|
Строка 336: Строка 374:
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 10
+
| 11
 
| Настройка, определяющая '''тип операции при проведении платежа'''.
 
| Настройка, определяющая '''тип операции при проведении платежа'''.
 
Обязательная настройка.
 
Обязательная настройка.
Строка 346: Строка 384:
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 11
+
| 12
 
| Настройка, определяющая '''тип операции при проведении платежа для комиссий'''.
 
| Настройка, определяющая '''тип операции при проведении платежа для комиссий'''.
 
| '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).
 
| '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).
Строка 355: Строка 393:
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 12
+
| 13
 
| Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками ''NewDogovorServiceSvKey'' и ''NewDogovorServicePartnerKey''.
 
| Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками ''NewDogovorServiceSvKey'' и ''NewDogovorServicePartnerKey''.
<span style="color:red">Обрабатывается с релиза 15.8.</span>
 
 
| Ключ услуги (Поле '''SL_KEY''' из таблицы <code>'''[ServiceList]'''</code>).
 
| Ключ услуги (Поле '''SL_KEY''' из таблицы <code>'''[ServiceList]'''</code>).
 
Название услуги комиссии в путевке берется из этого параметра
 
Название услуги комиссии в путевке берется из этого параметра
Строка 366: Строка 403:
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 13
+
| 14
 
| Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServicePartnerKey''.
 
| Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServicePartnerKey''.
<span style="color:red">Обрабатывается с релиза 15.8.</span>
 
 
| Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>).
 
| Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>).
 
Название услуги комиссии в путевке берется из этого параметра
 
Название услуги комиссии в путевке берется из этого параметра
Строка 377: Строка 413:
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 14
+
| 15
 
| Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServiceSvKey''.
 
| Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServiceSvKey''.
<span style="color:red">Обрабатывается с релиза 15.8.</span>
 
 
| Ключ класса услуги (Поле '''PR_KEY''' из таблицы <code>'''[Partners]'''</code>).
 
| Ключ класса услуги (Поле '''PR_KEY''' из таблицы <code>'''[Partners]'''</code>).
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
Строка 387: Строка 422:
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 15
+
| 16
 
| Настройка, определяющая '''адрес электронной почты по умолчанию'''.  
 
| Настройка, определяющая '''адрес электронной почты по умолчанию'''.  
 
|Используется в том случае, если не указан адрес электронной почты главного туриста.
 
|Используется в том случае, если не указан адрес электронной почты главного туриста.
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
 
<add key="defaultEmail" value="" />
 
<add key="defaultEmail" value="" />
 
 
</syntaxhighlight>
 
</syntaxhighlight>
 
 
|}<br />
 
|}<br />
 
+
=====Формирование чеков Alfabank=====
==Sberbank==
+
Настройки для формирования чека задаются в секции <code><Alfabank></code> файла <code>web.config</code> приложения '''EntryPoint'''.<br />
 
+
Обратите внимание, настройки являются обязательными.
==Tinkoff==
 
Настройки задаются в секции <code><Tinkoff></code> файла <code>web.config</code> приложения '''EntryPoint'''.<br />
 
 
{| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse"
 
{| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse"
  
Строка 413: Строка 444:
  
 
| 1
 
| 1
| '''Адрес платежной службы'''
+
| '''Система налогообложения'''  
Обязательная настройка.
+
| Значения:
| Адрес сервиса оплаты через карту банка «Tinkoff».
+
  general — общая
 +
  simple_income — упрощенная (доходы)
 +
  simple_profit — упрощенная (доходы минус расходы)
 +
  patent — патентная
 +
  unified_agricultural — единый сельскохозяйственный налог
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="LoginUrl" value="https://securepay.tinkoff.ru/v2/Init"/>
+
<add key="TaxationCode" value="general" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 1
+
| 2
| '''Адрес платежной службы'''
+
| '''Ставка НДС'''
Обязательная настройка.
+
| Значения:
| Адрес сервиса оплаты через карту банка «Tinkoff».
+
  no — без НДС
 +
  0 — 0%
 +
  10 — 10%
 +
  20 — 20%
 +
  10/110 — 10/110
 +
  20/120 — 20/120
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="LoginUrl" value="https://securepay.tinkoff.ru/v2/Init"/>
+
<add key="Tax" value="no" />
 
</syntaxhighlight>
 
</syntaxhighlight>
 +
|}<br />
 +
Обратите внимание, что для каждой услуги отправляется на уровне кода:</br>
 +
* typename - ServiceType согласно ключу SvKey, нигде в чеке не фигурирует;</br>
 +
* number - ключ услуги в БД;</br>
 +
* quantity - 1(услуга);</br>
 +
* name - "Туристическая услуга по путевке {код договора}";</br>
 +
* amount - сумма оплаты по услуге и валюта;</br>
 +
* taxation_item_settlement_method - "full_prepayment";</br>
 +
* taxation_item_type - "service";</br>
 +
* taxation_system - "general" по умолчанию, если не указано иное в конфиге;</br>
 +
* taxes - налог, где</br>
 +
** amount - вычисляется согласно выбранной системе расчета налога и валюта;</br>
 +
** percentage - "no" по умолчанию, иначе - из конфига "20/120" и т.д.;</br>
 +
** type - "vat";</br>
 +
** source - "shop"</br>
 +
 +
[[Файл: mb_030.png|left|Предупреждение]] <BR> Обратите внимание, что для корректной записи платежей в Мастер Тур, необходимо настроить автоматическое подтверждение платежа. Для этого необходимо обратиться в техподдержку Альфа-Банка.
 +
Существует возможность также подтверждать платежи вручную. Подробнее можно ознакомиться тут https://ecom.alfabank.ru/assets/instructions/merchantManual/pages/index/general_description.html#koordinati_podkljuchenija  или запросить информацию в технической поддержке Альфа-Банка
 +
 +
====Sberbank====
 +
Настройки задаются в секции <code><Sberbank></code> файла <code>web.config</code> приложения '''EntryPoint'''. При использовании SberbankMir или SberbankMir необходимо заполнить соответствующие секции в файле <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"
 
|- style="vertical-align:text-top"
  
| 2
+
| 1
| '''Адрес для оплаты по QR коду'''
+
| Идентификатор клиента, который выдается платежной системой Sberbank.
 
Обязательная настройка.
 
Обязательная настройка.
| Адрес сервиса оплаты через карту банка «Tinkoff» по QR коду.
+
| '''Идентификатор клиента'''
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="QRCodeUrl" value="https://securepay.tinkoff.ru/v2/GetQr"/>
+
<add key="userName" value="логин sberbank-api" />
 
</syntaxhighlight>
 
</syntaxhighlight>
 
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
 
+
| 2
| 3
+
| Пароль клиента, который выдается платежной системой Sberbank.
| '''Адрес метода для получения статуса платежа'''
 
 
Обязательная настройка.
 
Обязательная настройка.
| Адрес метода для получения статуса платежа.
+
| '''Пароль клиента'''
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="GetStateUrl" value="https://securepay.tinkoff.ru/v2/GetState"/>
+
<add key="password" value="пароль sberbank-api" />
 +
</syntaxhighlight>
 +
|- style="vertical-align:text-top"
 +
| 3
 +
| Ссылка на платежный шлюз Sberbank
 +
|Аналогично настройке link в секции Sberbank в разделе<paymentMethods>
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="sberbankPaymentApplicationUrl" value="https://securepayments.sberbank.ru/payment/rest/" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
 
 
| 4
 
| 4
| '''Адрес метода возвращающего статус заказа'''
+
| Настройка, определяющая '''пользователя''' ПК «Мастер-Тур», к которому будет '''привязываться оплата'''.
 
Обязательная настройка.
 
Обязательная настройка.
| Адрес метода возвращающего статус заказа.
+
| '''Ключ пользователя''', к которому ''привязывается оплата'' (Поле '''US_KEY''' из таблицы <code>'''[UserList]'''</code>).
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="CheckOrderUrl" value="https://securepay.tinkoff.ru/v2/CheckOrder"/>
+
<add key="masterTourUser" value="95" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
 
 
| 5
 
| 5
| '''Идентификатор терминала'''
+
| Настройка, позволяющая создавать объект '''orderBundle''' (товарная корзина), в котором передаются все необходимые данные о товаре/услуге.
Обязательная настройка.
+
|  
| Параметр '''Терминал''' из раздела Терминалы в л/к сервиса «Tinkoff».
+
* '''true''' - включено создание объекта '''orderBundle'''
 +
* '''false''' или отсутствие настройки -  объект '''orderBundle''' не создается <br />
 +
По умолчанию настройка имеет значение false.
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="TerminalKey" value="1587990738"/>
+
<add key="useFiscalization" value="false"/>
 
</syntaxhighlight>
 
</syntaxhighlight>
 
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
 
| 6
 
| 6
| '''Пароль терминала'''
+
| Настройка, определяющая '''тип операции при проведении платежа'''.
 
Обязательная настройка.
 
Обязательная настройка.
| Параметр '''Пароль''' из раздела Терминалы в л/к сервиса «Tinkoff».
+
| '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="TerminalPassword" value="cn5du3jxcfbmwtyuii"/>
+
<add key="PaymentOperationId" value="1" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
Строка 483: Строка 557:
  
 
| 7
 
| 7
| Настройка, определяющая '''язык''' окна платежной формы «Tinkoff».
+
| Настройка, определяющая '''тип операции при проведении платежа для комиссий'''.
Обязательная настройка.
+
| '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).</br>
|
+
<br /><font style="color:red">''Внимание!''</font><br />
* '''ru''' - русский язык
+
Если данная настройка не заполнена, то значения настроек '''NewDogovorServiceServiceListKey''', '''NewDogovorServiceSvKey''', '''NewDogovorServicePartnerKey''' обязательно оставить незаполненными.
* '''en''' - английский язык
 
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="LanguageFormCode" value="ru"/>
+
<add key="paymentOperationCommissionId" value="6" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
Строка 495: Строка 568:
  
 
| 8
 
| 8
| Код системы налогообложения, его значение должно соответствовать режимам налогообложения, сконфигурированным в ККМ при регистрации. Данная настройка необходима для работы фискализации платежей.
+
| Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для агентств''').<br>
|
+
| '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется либо запятой, либо точкой).
* '''osn''' – общая система налогообложения
+
Комиссия указывается '''в процентах'''.<br />
* '''usn_income''' – упрощенная система налогообложения (Доход)
+
По умолчанию комиссия для агентств равна нулю.
* '''usn_income_outcome''' – упрощенная СН (Доход минус Расход)
 
* '''patent''' – патентная система налогообложения
 
* '''envd''' – единый налог на вмененный доход
 
* '''esn''' – единый сельскохозяйственный налог
 
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="TaxationCode" value="osn"/>
+
<add key="addAgencyComission" value="3.627" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
Строка 510: Строка 579:
  
 
| 9
 
| 9
| Код ставки налогообложения. Данная настройка необходима для работы фискализации платежей.
+
| Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для частных лиц''').<br>
|
+
| '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется либо запятой, либо точкой).
* '''none''' – не облагается НДС
+
Комиссия указывается '''в процентах'''.<br />
* '''vat0''' – облагается НДС по ставке 0%
+
По умолчанию комиссия для частных лиц равна нулю.
* '''vat10''' – облагается НДС по ставке 10%
 
* '''vat20''' – облагается НДС по ставке 20%
 
* '''vat110''' – облагается НДС по ставке 10/110
 
* '''vat120''' – облагается НДС по ставке 18/120
 
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="Tax" value="none"/>
+
<add key="addPersonalComission" value="5.0" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
|- style="vertical-align:text-top"
 
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
 
| 10
 
| 10
| Настройка, определяющая '''тип операции при проведении платежа'''.
+
| Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками ''NewDogovorServiceSvKey'' и ''NewDogovorServicePartnerKey''.
Обязательная настройка.
+
| Ключ услуги (Поле '''SL_KEY''' из таблицы <code>'''[ServiceList]'''</code>).
| '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).
 
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="PaymentOperationId" value="6" />
+
<add key="NewDogovorServiceServiceListKey" value="450" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
Строка 536: Строка 599:
  
 
| 11
 
| 11
| Настройка, определяющая '''тип операции при проведении платежа для комиссий'''.
+
| Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServicePartnerKey''.
| '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).
+
| Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>).
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="paymentOperationCommissionId" value="" />
+
<add key="NewDogovorServiceSvKey" value="1055" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
Строка 545: Строка 608:
  
 
| 12
 
| 12
| Настройка, определяющая '''пользователя''' ПК «Мастер-Тур», к которому будет '''привязываться оплата'''.
+
| Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServiceSvKey''.
Обязательная настройка.
+
| Ключ класса услуги (Поле '''PR_KEY''' из таблицы <code>'''[Partners]'''</code>).
| '''Ключ пользователя''', к которому ''привязывается оплата'' (Поле '''US_KEY''' из таблицы <code>'''[UserList]'''</code>).
 
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="masterTourUser" value="80" />
+
<add key="NewDogovorServicePartnerKey" value="12921" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
Строка 555: Строка 617:
  
 
| 13
 
| 13
| Настройка, определяющая '''партнера''', к которому будет '''привязываться оплата'''.
+
| Настройка, включающая расчет через Мастер финанс.
Обязательная настройка.
+
|
| '''Ключ филиала''', к которому ''привязывается оплата'' (Поле '''PR_KEY''' из таблицы <code>'''[Partners]'''</code>).
+
* '''false''' - расчет через мастер финанс не включен;
 +
* '''true''' - расчет через мастер финанс включен.
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="paymentFilialKey" value="1" />
+
<add key="AddPaymentsToMasterFinance" value="false"/>
 
</syntaxhighlight>
 
</syntaxhighlight>
 +
 +
|}
 +
<br />
 +
 +
====Tinkoff (Т-Банк)====
 +
Настройки задаются в секции <code><paymentMethods></code> файла <code>web.config</code> приложения '''EntryPoint'''.<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"
 
|- style="vertical-align:text-top"
  
| 14
+
| 1
| Настройка, определяющая '''отдел''', к которому будет '''привязываться оплата'''.
+
| '''Платежный метод'''
 
Обязательная настройка.
 
Обязательная настройка.
| '''Ключ отдела''' ('''кассы'''), к которому ''привязывается оплата'' (Поле '''PDP_KEY''' из таблицы <code>'''[PrtDeps]'''</code>).
+
| способ оплаты в платежной системе «Tinkoff (Т-Банк)».
 +
*'''code="1"''' – идентификатор платежного метода, должен быть уникальным. Используется в других секциях, для ссылки на данный метод оплаты;
 +
*'''name="Tinkoff"''' – название платежной системы (если не задана ссылка на логотип, то отображается кнопка с наименованием данного поля);
 +
*'''paymentSystem="Tinkoff"''' – название платежной системы.
 +
*'''LogoLink''' – расположение логотипа способа оплаты;
 +
*'''maximumAmount''' – максимальный размер платежа;
 +
*'''skipDescriptionPage''' – отображать экран редактирования оплаты или сразу выполнять платеж с текущими значениями.
 +
**Если значение '''skipDescriptionPage=true''', то сразу происходит переход к оплате.
 +
**Если значение '''skipDescriptionPage=false''', то происходит переход на страницу редактирования суммы к оплате, а уже из нее переход к оплате на платежный шлюз.
 +
*'''displayWindowWithEditingRequestData''' – настройка включающая проверку e-mail и телефона плательщика, при отсутствии выводит модальное окно с просьбой ввести e-mail и телефон плательщика. после ввода данных отправлять на оплату.
 +
**'''false''' – проверка не проводится
 +
**'''true''' – проверка проводится
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="departmentKey" value="2" />
+
<add code="12" name="Платформа Tinkoff" logoLink="~/Content/logos/logoTinkoff.png"
 +
    maximumAmount="1000000"
 +
    skipDescriptionPage="false" displayWindowWithEditingRequestData="true" paymentSystem="Tinkoff" />
 
</syntaxhighlight>
 
</syntaxhighlight>
 +
|}
 +
<br />
  
|- style="vertical-align:text-top"
+
Настройки задаются в секции <code><Tinkoff></code> файла <code>web.config</code> приложения '''EntryPoint'''.<br />
 +
{| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse"
 +
 
 +
|- style="background-color:#F2F2F2"
  
| 15
+
! width="2%" | №
|Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для агентств) <br>
+
! width="28%" | Описание
|
+
! width="35%" | Значение
Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется  запятой).
+
! width="35%" | Настройка
Комиссия указывается в процентах.
 
| <syntaxhighlight lang="xml" enclose="div">
 
<add key="addAgencyComission" value="15,8" />
 
</syntaxhighlight>
 
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 16
+
| 1
|Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для частных лиц) <br>
+
| '''Адрес платежной службы'''
|  
+
Обязательная настройка.
Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется  запятой).
+
| Адрес сервиса оплаты через карту банка «Tinkoff (Т-Банк)».
Комиссия указывается в процентах.
+
|<syntaxhighlight lang="xml" enclose="div">
| <syntaxhighlight lang="xml" enclose="div">
+
<add key="LoginUrl" value="https://securepay.tinkoff.ru/v2/Init"/>
<add key="addPersonalComission" value="17,4" />  
 
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 17
+
| 2
| Настройка, включающая расчет через Мастер финанс.
+
| '''Адрес для оплаты по QR коду'''
|
+
Обязательная настройка.
* '''false''' - расчет через мастер финанс не включен;
+
| Адрес сервиса оплаты через карту банка «Tinkoff (Т-Банк)» по QR коду.
* '''true''' - расчет через мастер финанс включен.
 
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="AddPaymentsToMasterFinance" value="false"/>
+
<add key="QRCodeUrl" value="https://securepay.tinkoff.ru/v2/GetQr"/>
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 18
+
| 3
| Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками ''NewDogovorServiceSvKey'' и ''NewDogovorServicePartnerKey''.
+
| '''Адрес метода для получения статуса платежа'''
<span style="color:red">Обрабатывается с релиза 15.8.</span>
+
Обязательная настройка.
| Ключ услуги (Поле '''SL_KEY''' из таблицы <code>'''[ServiceList]'''</code>).
+
| Адрес метода для получения статуса платежа.
Название услуги комиссии в путевке берется из этого параметра
 
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="NewDogovorServiceServiceListKey" value="450" />
+
<add key="GetStateUrl" value="https://securepay.tinkoff.ru/v2/GetState"/>
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 19
+
| 4
| Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServicePartnerKey''.
+
| '''Адрес метода возвращающего статус заказа'''
<span style="color:red">Обрабатывается с релиза 15.8.</span>
+
Обязательная настройка.
Название услуги комиссии в путевке берется из этого параметра
+
| Адрес метода возвращающего статус заказа.
| Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>).
 
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="NewDogovorServiceSvKey" value="1055" />
+
<add key="CheckOrderUrl" value="https://securepay.tinkoff.ru/v2/CheckOrder"/>
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 20
+
| 5
| Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServiceSvKey''.
+
| '''Идентификатор терминала'''
<span style="color:red">Обрабатывается с релиза 15.8.</span>
+
Обязательная настройка.
| Ключ класса услуги (Поле '''PR_KEY''' из таблицы <code>'''[Partners]'''</code>).
+
| Параметр '''Терминал''' из раздела Терминалы в л/к сервиса «Tinkoff (Т-Банк)».
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="NewDogovorServicePartnerKey" value="12921" />
+
<add key="TerminalKey" value="1587990738"/>
 
</syntaxhighlight>
 
</syntaxhighlight>
|}
 
<br />
 
  
==Uniteller==
+
|- style="vertical-align:text-top"
Настройки задаются в секции <code><Uniteller></code> файла <code>web.config</code> приложения '''EntryPoint'''. При использовании UnitellerMir или UnitellerChildren необходимо заполнить соответствующие секции в файле <code>web.config</code>.
 
  
{| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse"
+
| 6
 +
| '''Пароль терминала'''
 +
Обязательная настройка.
 +
| Параметр '''Пароль''' из раздела Терминалы в л/к сервиса «Tinkoff (Т-Банк)».
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="TerminalPassword" value="cn5du3jxcfbmwtyuii"/>
 +
</syntaxhighlight>
  
|- style="background-color:#F2F2F2"
+
|- style="vertical-align:text-top"
  
! width="2%" | №
+
| 7
! width="28%" | Описание
+
| Настройка, определяющая '''язык''' окна платежной формы «Tinkoff (Т-Банк)».
! width="35%" | Значение
+
Обязательная настройка.
! width="35%" | Настройка
+
|
 +
* '''ru''' - русский язык
 +
* '''en''' - английский язык
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="LanguageFormCode" value="ru"/>
 +
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 1
+
| 8
| '''Точки продажи''' ('''shopIDP''')
+
| Код системы налогообложения, его значение должно соответствовать режимам налогообложения, сконфигурированным в ККМ при регистрации. Данная настройка необходима для работы фискализации платежей.
Обязательная настройка.
+
|
| '''Uniteller Point ID''' из раздела Точки продажи ЛК «Uniteller».
+
* '''osn''' – общая система налогообложения
 +
* '''usn_income''' – упрощенная система налогообложения (Доход)
 +
* '''usn_income_outcome''' – упрощенная СН (Доход минус Расход)
 +
* '''patent''' – патентная система налогообложения
 +
* '''envd''' – единый налог на вмененный доход
 +
* '''esn''' – единый сельскохозяйственный налог
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="shopIDP" value="00005432"/>
+
<add key="TaxationCode" value="osn"/>
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 2
+
| 9
| '''Логин'''
+
| Код ставки налогообложения. Данная настройка необходима для работы фискализации платежей.
Обязательная настройка.
+
|
| '''Login''' из раздела Параметры авторизации ЛК «Uniteller».
+
* '''none''' – не облагается НДС
 +
* '''vat0''' – облагается НДС по ставке 0%
 +
* '''vat10''' – облагается НДС по ставке 10%
 +
* '''vat20''' – облагается НДС по ставке 20%
 +
* '''vat110''' – облагается НДС по ставке 10/110
 +
* '''vat120''' – облагается НДС по ставке 18/120
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="login" value="2281" />
+
<add key="Tax" value="none"/>
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 +
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 3
+
| 10
| '''Пароль'''
+
| Настройка, определяющая '''тип операции при проведении платежа'''.
 
Обязательная настройка.
 
Обязательная настройка.
| '''Password''' из раздела Параметры авторизации ЛК «Uniteller».
+
| '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="password" value="XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX" />
+
<add key="PaymentOperationId" value="6" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 4
+
| 11
|Платёжная система кредитной карты.
+
| Настройка, определяющая '''тип операции при проведении платежа для комиссий'''.
|
+
| '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).
* '''0''' или '''отсутствует значение''' - любая
 
* '''1''' - VISA
 
* '''2''' - MasterCard
 
* '''3''' - Diners Club
 
* '''4''' - JCB
 
* '''5''' - American Express
 
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="meanType" value="" />
+
<add key="paymentOperationCommissionId" value="" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 5
+
| 12
|Тип электронной валюты.
+
| Настройка, определяющая '''пользователя''' ПК «Мастер-Тур», к которому будет '''привязываться оплата'''.
|
+
Обязательная настройка.
* '''0''' или '''отсутствует значение''' - любая система электронных платежей
+
| '''Ключ пользователя''', к которому ''привязывается оплата'' (Поле '''US_KEY''' из таблицы <code>'''[UserList]'''</code>).
* '''1''' - Яндекс.Деньги
+
|<syntaxhighlight lang="xml" enclose="div">
* '''2''' - RBK Money
+
<add key="masterTourUser" value="80" />
* '''3''' - MoneyMail
+
</syntaxhighlight>
* '''4''' - WebCreds
+
 
* '''6''' - Platezh.ru
+
|- style="vertical-align:text-top"
* '''7''' - Деньги@Mail.Ru
+
 
* '''8''' - Мобильный платёж Мегафон
+
| 13
* '''9''' - Мобильный платёж МТС
+
| Настройка, определяющая '''партнера''', к которому будет '''привязываться оплата'''.
* '''10''' - Мобильный платёж Билайн
+
Обязательная настройка.
* '''11''' - PayPal
+
| '''Ключ филиала''', к которому ''привязывается оплата'' (Поле '''PR_KEY''' из таблицы <code>'''[Partners]'''</code>).
* '''12''' - ВКонтакте
 
* '''13''' - Евросеть
 
* '''14''' - Yota.money
 
* '''15''' - QIWI Кошелек
 
* '''16''' - ПлатФон
 
* '''17''' - Moneybookers
 
* '''29''' - WebMoney WMR
 
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="eMoneyType" value="" />
+
<add key="paymentFilialKey" value="1" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 6
+
| 14
| Таймаут между попытками запроса результата
+
| Настройка, определяющая '''отдел''', к которому будет '''привязываться оплата'''.
|  
+
Обязательная настройка.
По умолчанию 100.
+
| '''Ключ отдела''' ('''кассы'''), к которому ''привязывается оплата'' (Поле '''PDP_KEY''' из таблицы <code>'''[PrtDeps]'''</code>).
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="requestTimeout" value="100" />
+
<add key="departmentKey" value="2" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 7
+
| 15
| Количество попыток запроса результата
+
|Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для агентств) <br>
 
|  
 
|  
По умолчанию 5.
+
Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется  запятой).
|<syntaxhighlight lang="xml" enclose="div">
+
Комиссия указывается в процентах.
<add key="requestAttempts" value="5" />
+
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="addAgencyComission" value="15,8" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 8
+
| 16
| Настройка, определяющая '''пользователя''' ПК «Мастер-Тур», к которому будет '''привязываться оплата'''.
+
|Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для частных лиц) <br>
Обязательная настройка.
+
|
| '''Ключ пользователя''', к которому ''привязывается оплата'' (Поле '''US_KEY''' из таблицы <code>'''[UserList]'''</code>).
+
Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется  запятой).
|<syntaxhighlight lang="xml" enclose="div">
+
Комиссия указывается в процентах.
<add key="masterTourUser" value="80" />
+
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="addPersonalComission" value="17,4" />  
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 9
+
| 17
| Настройка, определяющая '''партнера''', к которому будет '''привязываться оплата'''.
+
| Настройка, включающая расчет через Мастер финанс.
Обязательная настройка.
+
|
| '''Ключ филиала''', к которому ''привязывается оплата'' (Поле '''PR_KEY''' из таблицы <code>'''[Partners]'''</code>).
+
* '''false''' - расчет через мастер финанс не включен;
 +
* '''true''' - расчет через мастер финанс включен.
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="paymentFilialKey" value="1" />
+
<add key="AddPaymentsToMasterFinance" value="false"/>
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 10
+
| 18
| Настройка, определяющая '''отдел''', к которому будет '''привязываться оплата'''.
+
| Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками ''NewDogovorServiceSvKey'' и ''NewDogovorServicePartnerKey''.
Обязательная настройка.
+
| Ключ услуги (Поле '''SL_KEY''' из таблицы <code>'''[ServiceList]'''</code>).
| '''Ключ отдела''' ('''кассы'''), к которому ''привязывается оплата'' (Поле '''PDP_KEY''' из таблицы <code>'''[PrtDeps]'''</code>).
+
Название услуги комиссии в путевке берется из этого параметра
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="departmentKey" value="2" />
+
<add key="NewDogovorServiceServiceListKey" value="450" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
|- style="vertical-align:text-top"
+
| 19
| 11
+
| Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServicePartnerKey''.
| Настройка, определяющая '''валюту''', в которой будет '''совершаться платеж''' через систему «Uniteller».
+
Название услуги комиссии в путевке берется из этого параметра
Обязательная настройка.
+
| Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>).
|  
 
* '''Contract''' - оплата в ''валюте путевки'';
 
* '''Tour''' -  оплата в ''валюте тура'';<br />
 
* '''National''' – оплата в ''национальной валюте'';<br />
 
* '''DefinedBySettings''' - оплата в ''валюте'', ''определенной настройкой'' '''Сurrency'''.
 
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="currencyToPay" value="Contract" />
+
<add key="NewDogovorServiceSvKey" value="1055" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 12
+
| 20
| Настройка, определяющая '''код валюты''', в которой будет '''совершаться платеж''' через платежную систему «Uniteller» при '''значении DefinedBySettings  настройки currencyToPay'''.
+
| Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServiceSvKey''.
| '''Код валюты''' (Поле '''RA_CODE''' из таблицы <code>'''[Rates]'''</code>).
+
| Ключ класса услуги (Поле '''PR_KEY''' из таблицы <code>'''[Partners]'''</code>).
Код валюты из ПК «Мастер-Тур» должен быть сопоставлен с кодом валюты в системе «Uniteller». Данное сопоставление задается в секции <code>'''<currencyMap>'''</code>, в качестве параметра '''key''' указывается '''код валюты''' из ПК «Мастер-Тур», в качестве  параметра '''value''' задается '''код валюты''' в системе «Uniteller», например:<br />
 
<syntaxhighlight lang="xml">
 
<currencyMap>
 
      <add key="рб" value="RUB"/>
 
      <add key="грн" value="UAH"/>
 
      <add key="azn" value="AZN"/>
 
      <add key="тг" value="KZT"/>
 
</currencyMap></syntaxhighlight>.
 
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="currency" value="рб" />
+
<add key="NewDogovorServicePartnerKey" value="12921" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 13
+
|21
| Включение функционала фискализации платежей.<br />
+
| Настройки, определяющие способ расчета. Если значение не передано, по умолчанию будет передаваться ''full_payment'' – полный расчет.
После включения необходимо заполнить настройки '''Код системы налогообложения''' ('''TaxMode''') и '''Код ставки налогообложения''' ('''TaxRateCode''').<br />
+
* Если сумма, которую мы оплачиваем меньше суммы, которую нужно оплатить, способ расчета определяется следующим образом:
|  
+
** Если ''PaymentMethodPrepayment'' имеет значение, то берем его. Если он пуст, то берем ''PaymentMethodMain'', если и он пуст, то передаем пустое значение (а на стороне Тинькофф это будет ''full_payment'')
* '''true''' – использовать фискализацию при оплате
+
* Если по договору уже есть какая-то ранее оплаченная сумма, то способ расчета считается следующим образом:
* '''false или отсутствие настройки''' – не использовать фискализацию при оплате
+
** Если сумма, которую мы оплачиваем равна сумме, которую нужно оплатить, берем ''PaymentMethodFull''. Если он пуст, то берем ''PaymentMethodMain'', если и он пуст, то передаем пустое значение (а на стороне Тинькофф это будет ''full_payment'')
 +
* Если у нас нет ранее оплаченной суммы, то способ расчета считается следующим образом:
 +
** Если сумма, которую мы оплачиваем равна сумме, которую нужно оплатить, берем ''PaymentMethodMain''. Если он пуст, то передаем пустое значение (а на стороне Тинькофф это будет ''full_payment'')
 +
| Возможные значения:
 +
* '''full_prepayment''' – предоплата 100%
 +
* '''prepayment''' – предоплата
 +
* '''advance''' – аванс
 +
* '''full_payment''' – полный расчет
 +
* '''partial_payment''' – частичный расчет и кредит
 +
* '''credit''' – передача в кредит
 +
* '''credit_payment''' – оплата кредита
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="UseFiscalization" value="true"/>
+
<add key="PaymentMethodMain" value="prepayment" />
 +
<add key="PaymentMethodPrepayment" value="full_prepayment" />
 +
<add key="PaymentMethodFull" value="" />
 
</syntaxhighlight>
 
</syntaxhighlight>
 +
|}
 +
<br />
 +
 +
====Uniteller====
 +
Настройки задаются в секции <code><Uniteller></code> файла <code>web.config</code> приложения '''EntryPoint'''. При использовании UnitellerMir или UnitellerChildren необходимо заполнить соответствующие секции в файле <code>web.config</code>.
 +
 +
{| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse"
  
|- style="vertical-align:text-top"
+
|- style="background-color:#F2F2F2"
  
| 14
+
! width="2%" | №
| Код системы налогообложения, его значение должно соответствовать режимам налогообложения, сконфигурированным в ККМ при регистрации. Данная настройка необходима для работы фискализации платежей.
+
! width="28%" | Описание
 
+
! width="35%" | Значение
|
+
! width="35%" | Настройка
* '''0''' – общая система налогообложения
 
* '''1''' – упрощенная система налогообложения (Доход)
 
* '''2''' – упрощенная СН (Доход минус Расход)
 
* '''3''' – единый налог на вмененный доход
 
* '''4''' – единый сельскохозяйственный налог
 
* '''5''' – патентная система налогообложения
 
|<syntaxhighlight lang="xml" enclose="div">
 
<add key="TaxMode" value=""/>
 
</syntaxhighlight>
 
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 15
+
| 1
| Код ставки налогообложения. Данная настройка необходима для работы фискализации платежей.
+
| '''Точки продажи''' ('''shopIDP''')
 
+
Обязательная настройка.
|
+
| '''Uniteller Point ID''' из раздела Точки продажи ЛК «Uniteller».
* '''-1''' – не облагается НДС
 
* '''0''' – облагается НДС по ставке 0%
 
* '''10''' – облагается НДС по ставке 10%
 
* '''18''' – облагается НДС по ставке 18%
 
* '''110''' – облагается НДС по ставке 10/110
 
* '''118''' – облагается НДС по ставке 18/118
 
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="TaxRateCode" value=""/>
+
<add key="shopIDP" value="00005432"/>
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 16
+
| 2
| Настройка, задающая услугу страхования, добавляемую в фискальный чек. Применяется в случае если в путевке отсутствует скрытая услуга "Операторский тур".
+
| '''Логин'''
Описание формирования чека с данными настройками находится в разделе [[Платежные web-сервисы: Сервис интеграции с платежной системой Uniteller (оплата картой в личном кабинете)#Формирование чека при использовании скрытой услуги "Операторский тур" в путевке|Формирование чека при использовании скрытой услуги "Операторский тур" в путевке]].
+
Обязательная настройка.
| Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>).
+
| '''Login''' из раздела Параметры авторизации ЛК «Uniteller».
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="InsuranceServiceKey" value="6"/>
+
<add key="login" value="2281" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 17
+
| 3
| Настройка задающая название услуги в фискальном чеке если в путевке имеется скрытая услуга "Операторский тур". Описание формирования чека с данными настройками находится в разделе [[Платежные web-сервисы: Сервис интеграции с платежной системой Uniteller (оплата картой в личном кабинете)#Формирование чека при использовании скрытой услуги "Операторский тур" в путевке|Формирование чека при использовании скрытой услуги "Операторский тур" в путевке]].
+
| '''Пароль'''
 
 
| Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>).
 
|<syntaxhighlight lang="xml" enclose="div">
 
<add key="OperatorTourServiceKey" value="1134"/>
 
</syntaxhighlight>
 
 
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
 
| 18
 
| Настройка, определяющая '''тип операции при проведении платежа'''.
 
 
Обязательная настройка.
 
Обязательная настройка.
| '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).
+
| '''Password''' из раздела Параметры авторизации ЛК «Uniteller».
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="PaymentOperationId" value="1" />
+
<add key="password" value="XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 19
+
| 4
| Настройка, определяющая '''тип операции при проведении платежа для комиссий'''.
+
|Платёжная система кредитной карты.
| '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).
+
|
 +
* '''0''' или '''отсутствует значение''' - любая
 +
* '''1''' - VISA
 +
* '''2''' - MasterCard
 +
* '''3''' - Diners Club
 +
* '''4''' - JCB
 +
* '''5''' - American Express
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="paymentOperationCommissionId" value="6" />
+
<add key="meanType" value="" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 20
+
| 5
| Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для агентств''').
+
|Тип электронной валюты.
| '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется запятой).
+
|
Комиссия указывается '''в процентах'''.<br />
+
* '''0''' или '''отсутствует значение''' - любая система электронных платежей
Сумма оплаты вычисляется следующим образом:<br />
+
* '''1''' - Яндекс.Деньги
Если из ''конечной суммы'' платежа в системе «Uniteller» ''вычесть'' указанный процент - получится ''стоимость путевки''.<br />
+
* '''2''' - RBK Money
Пример:<br />
+
* '''3''' - MoneyMail
Стоимость путевки - '''100 у.е.''' <br />
+
* '''4''' - WebCreds
В настройке указана комиссия - '''50%'''.<br />
+
* '''6''' - Platezh.ru
Итоговая сумма платежа в системе «Uniteller» - '''200 у.е.'''<br />
+
* '''7''' - Деньги@Mail.Ru
<code>'''200 у.е.''' - '''50% * 200 у.е.''' = '''100 у.е.'''</code> (''стоимость путевки'').
+
* '''8''' - Мобильный платёж Мегафон
 +
* '''9''' - Мобильный платёж МТС
 +
* '''10''' - Мобильный платёж Билайн
 +
* '''11''' - PayPal
 +
* '''12''' - ВКонтакте
 +
* '''13''' - Евросеть
 +
* '''14''' - Yota.money
 +
* '''15''' - QIWI Кошелек
 +
* '''16''' - ПлатФон
 +
* '''17''' - Moneybookers
 +
* '''29''' - WebMoney WMR
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="addAgencyComission" value="3,627" />
+
<add key="eMoneyType" value="" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 21
+
| 6
| Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для частных лиц''').
+
| Таймаут между попытками запроса результата
| '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется запятой).
+
|  
Комиссия указывается '''в процентах'''.<br />
+
По умолчанию 100.
Сумма оплаты вычисляется следующим образом:<br />
 
Если из ''конечной суммы'' платежа в системе «Uniteller» ''вычесть'' указанный процент - получится ''стоимость путевки''.<br />
 
Пример:<br />
 
Стоимость путевки - '''100 у.е.''' <br />
 
В настройке указана комиссия - '''50%'''.<br />
 
Итоговая сумма платежа в системе «Uniteller» - '''200 у.е.'''<br />
 
<code>'''200 у.е.''' - '''50% * 200 у.е.''' = '''100 у.е.'''</code> (''стоимость путевки'').
 
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="addPersonalComission" value="5" />
+
<add key="requestTimeout" value="100" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 22
+
| 7
| Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками ''NewDogovorServiceSvKey'' и ''NewDogovorServicePartnerKey''.
+
| Количество попыток запроса результата
| Ключ услуги (Поле '''SL_KEY''' из таблицы <code>'''[ServiceList]'''</code>).
+
|  
 +
По умолчанию 5.
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="NewDogovorServiceServiceListKey" value="450" />
+
<add key="requestAttempts" value="5" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 23
+
| 8
| Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServicePartnerKey''.
+
| Настройка, определяющая '''пользователя''' ПК «Мастер-Тур», к которому будет '''привязываться оплата'''.
| Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>).
+
Обязательная настройка.
 +
| '''Ключ пользователя''', к которому ''привязывается оплата'' (Поле '''US_KEY''' из таблицы <code>'''[UserList]'''</code>).
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="NewDogovorServiceSvKey" value="1055" />
+
<add key="masterTourUser" value="80" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 24
+
| 9
| Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServiceSvKey''.
+
| Настройка, определяющая '''партнера''', к которому будет '''привязываться оплата'''.
| Ключ класса услуги (Поле '''PR_KEY''' из таблицы <code>'''[Partners]'''</code>).
+
Обязательная настройка.
 +
| '''Ключ филиала''', к которому ''привязывается оплата'' (Поле '''PR_KEY''' из таблицы <code>'''[Partners]'''</code>).
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="NewDogovorServicePartnerKey" value="12921" />
+
<add key="paymentFilialKey" value="1" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 24
+
| 10
| Настройка, задающая форму оплаты на шлюзе Unitellere
+
| Настройка, определяющая '''отдел''', к которому будет '''привязываться оплата'''.
| "All" - и карта и СБП, "Card" - только карта, "SBP" - только СБП
+
Обязательная настройка.
Если параметр не указан, или пустой или любой набор символов, то по умолчанию All
+
| '''Ключ отдела''' ('''кассы'''), к которому ''привязывается оплата'' (Поле '''PDP_KEY''' из таблицы <code>'''[PrtDeps]'''</code>).
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="PaymentFormType" value="Card" />
+
<add key="departmentKey" value="2" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 25
+
|- style="vertical-align:text-top"
| Тип отображения комиссии платежной системы в фискальном чеке.<br>
+
| 11
+
| Настройка, определяющая '''валюту''', в которой будет '''совершаться платеж''' через систему «Uniteller».
|0 - увеличивает стоимость позиций по чеку на размер (%) комиссию<br>
+
Обязательная настройка.
1 - добавляет в чек комиссию отдельной строкой<br>
+
|  
 
+
* '''Contract''' - оплата в ''валюте путевки'';
 +
* '''Tour''' -  оплата в ''валюте тура'';<br />
 +
* '''National''' – оплата в ''национальной валюте'';<br />
 +
* '''DefinedBySettings''' - оплата в ''валюте'', ''определенной настройкой'' '''Сurrency'''.
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="ComissionShowModeInVoucher" value ="0"/>
+
<add key="currencyToPay" value="Contract" />
 
</syntaxhighlight>
 
</syntaxhighlight>
|- style="vertical-align:text-top"
 
  
| 26
 
| Наименование позиции в чеке для комиссии для <add key="ComissionShowModeInVoucher" value ="1"/>.<br>
 
 
|По умолчанию - "Комиссия платежной системы"
 
 
|<syntaxhighlight lang="xml" enclose="div">
 
<add key="ComissionTextInVoucher" value ="Юнителлер комиcсия"/>
 
</syntaxhighlight>
 
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 27
+
| 12
| Вид формирования чека <br>
+
| Настройка, определяющая '''код валюты''', в которой будет '''совершаться платеж''' через платежную систему «Uniteller» при '''значении DefinedBySettings  настройки currencyToPay'''.
+
| '''Код валюты''' (Поле '''RA_CODE''' из таблицы <code>'''[Rates]'''</code>).
|true - разбить по услугам отдельно, </br>
+
Код валюты из ПК «Мастер-Тур» должен быть сопоставлен с кодом валюты в системе «Uniteller». Данное сопоставление задается в секции <code>'''<currencyMap>'''</code>, в качестве параметра '''key''' указывается '''код валюты''' из ПК «Мастер-Тур», в качестве  параметра '''value''' задается '''код валюты''' в системе «Uniteller», например:<br />
false - одной строкой из ключа VoucherServiceText</br>
+
<syntaxhighlight lang="xml">
По умолчанию настройка в состоянии false.</br>
+
<currencyMap>
 
+
      <add key="рб" value="RUB"/>
 +
      <add key="грн" value="UAH"/>
 +
      <add key="azn" value="AZN"/>
 +
      <add key="тг" value="KZT"/>
 +
</currencyMap></syntaxhighlight>.
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="VoucherShowDetails" value="false"/>
+
<add key="currency" value="рб" />
 
</syntaxhighlight>
 
</syntaxhighlight>
|- style="vertical-align:text-top"
 
  
| 28
 
| Наименование услуги в чеке <br>
 
 
|%dogovor% (не обязательно) - для вставки номера договора.</br>
 
 
|<syntaxhighlight lang="xml" enclose="div">
 
<add key="VoucherServiceText" value="Туристическая услуга по договору %dogovor%"/>
 
</syntaxhighlight>
 
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
|}
+
| 13
<br />
+
| Включение функционала фискализации платежей.<br />
===Фискализация в Uniteller===
+
После включения необходимо заполнить настройки '''Код системы налогообложения''' ('''TaxMode''') и '''Код ставки налогообложения''' ('''TaxRateCode''').<br />
Настройки задаются в секции <code><<paymentMethods>></code> файла <code>web.config</code> приложения '''EntryPoint'''.</br>
+
|
В зависимости от типа используемой фискализации прописывается соответствующая настройка.
+
* '''true''' – использовать фискализацию при оплате
{| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse"
+
* '''false или отсутствие настройки''' – не использовать фискализацию при оплате
 
+
|<syntaxhighlight lang="xml" enclose="div">
|- style="background-color:#F2F2F2"
+
<add key="UseFiscalization" value="true"/>
 
+
</syntaxhighlight>
! width="2%" | №
 
! width="28%" | Описание
 
! width="35%" | Значение
 
! width="35%" | Настройка
 
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 1
+
| 14
| Настройка, '''определяющая адрес шлюза оплаты с включенной фискализацией v.1.0'''.<br>
+
| Код системы налогообложения, его значение должно соответствовать режимам налогообложения, сконфигурированным в ККМ при регистрации. Данная настройка необходима для работы фискализации платежей.
  
 
|  
 
|  
 
+
* '''0''' – общая система налогообложения
 +
* '''1''' – упрощенная система налогообложения (Доход)
 +
* '''2''' – упрощенная СН (Доход минус Расход)
 +
* '''3''' – единый налог на вмененный доход
 +
* '''4''' – единый сельскохозяйственный налог
 +
* '''5''' – патентная система налогообложения
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="unitellerLoginWithFiscalizationUrl" value="https://fpay.uniteller.ru/v1/pay"/>
+
<add key="TaxMode" value=""/>
 
</syntaxhighlight>
 
</syntaxhighlight>
 +
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
 
+
| 15
| 2
+
| Код ставки налогообложения. Данная настройка необходима для работы фискализации платежей.
| Настройка, '''определяющая адрес шлюза оплаты с включенной фискализацией v.2.0'''.<br>
 
  
 
|  
 
|  
 
+
* '''-1''' – не облагается НДС
 +
* '''0''' – облагается НДС по ставке 0%
 +
* '''10''' – облагается НДС по ставке 10%
 +
* '''18''' – облагается НДС по ставке 18%
 +
* '''110''' – облагается НДС по ставке 10/110
 +
* '''118''' – облагается НДС по ставке 18/118
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
<add key="unitellerLoginWithFiscalizationUrl" value="https://fpay.uniteller.ru/v2/pay"/>
+
<add key="TaxRateCode" value=""/>
 
</syntaxhighlight>
 
</syntaxhighlight>
 +
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
|}
 
  
Добавлены следующие возможности в версии 2.0 от версии 1.0:</br>
+
| 16
* Продажа подарочных карт, начисления бонусов-авансов, фискализация авансов.</br>
+
| Настройка, задающая услугу страхования, добавляемую в фискальный чек. Применяется в случае если в путевке отсутствует скрытая услуга "Операторский тур".  
* Частичная либо полная оплаты заказа подарочными картами, бонусами либо другими авансами.</br>
+
Описание формирования чека с данными настройками находится в разделе [[Платежные web-сервисы: Сервис интеграции с платежной системой Uniteller (оплата картой в личном кабинете)#Формирование чека при использовании скрытой услуги "Операторский тур" в путевке|Формирование чека при использовании скрытой услуги "Операторский тур" в путевке]].
* Возврат авансов и покупок, оплаченых частично либо полностью авансами.</br>
+
| Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>).
* Отнесение авансов в доход.</br>
+
|<syntaxhighlight lang="xml" enclose="div">
* Осуществления агентских продаж.</br>
+
<add key="InsuranceServiceKey" value="6"/>
* Настройка механизма «Защита от штрафов» для интерфейсов версии 2.0.</br>
+
</syntaxhighlight>
Добавлены следующие сценарии:</br>
 
* Операция оплаты с использованием платежной формы (версия 2.0).</br>
 
* Операция оплаты с использованием API (версия 2.0).</br>
 
* Операция оплаты через ApplePay с использованием API (версия 2.0).</br>
 
* Операция подтверждения преавторизации (версия 2.0).</br>
 
* Операция отнесения авансов в доход с помощью API.</br>
 
* Операция отнесения авансов в доход с помощью ЛК.</br>
 
* Частичная или полная отмена платежа с фискализацией, выполненного через Uniteller (версия 2.0).</br>
 
* Частичная или полная отмена платежа с фискализацией, выполненного через Uniteller через ЛК (версия 2.0).</br>
 
* В сценарии регистрации заказа добавлена возможность регистрации для интерфейса 2.0.</br>
 
* Добавлены программные интерфейсы для новых сценариев.</br>
 
* Для интерфейсов версии 2.0 изменен формат фискального чека.</br>
 
  
===Настройка индивидуальных подписей и ссылок для кнопки оплаты===
+
|- style="vertical-align:text-top"
Начиная с релиза 15.8 появилась возможность добавить индивидуальную подпись и ссылку к баннеру платежной системы.
 
Необходимо добавить новые параметры в секции '''paymentMethods''' соответствующего способа оплаты:
 
<syntaxhighlight lang="xml" enclose="div">
 
<add code="17" name="Оплатить с кешбек" logoLink="~/Content/themes/base/images/payCashback.jpg"
 
header="Оплата тура для участников программы «Кешбэк по карте МИР»"
 
returnMoneyText = "В последствии можно будет вернуть часть средств"
 
paymentTermsText = "Условия оплаты туров по программе «Кешбэк по карте МИР»"
 
paymentTermsLink = "https://payment.webpay.by/"
 
pair = "1"
 
maximumAmount="1000000"
 
skipDescriptionPage="true" paymentSystem="Uniteller" link="https://fpay.uniteller.ru/v2/pay"/>
 
</syntaxhighlight>
 
<br>[[Файл: Ea_105.png|Описание]]<br />
 
* '''header''' - шапка с основным описанием способа оплаты<br />
 
* '''returnMoneyText''' -  дополнительное описание способа оплаты<br />
 
* '''paymentTermsText''' -  текст гиперссылки<br />
 
* '''paymentTermsLink''' - ссылка на которую происходит переход при нажатии на текст гиперссылки<br />
 
* '''pair''' -  параметр позволяющий связать 2 баннера в пару<br />
 
В случае, если имеется необходимость в отображении нескольких баннеров с подписями, для корректного отображения на странице рекомендуется их связывать в пары.<br />
 
Для того, чтобы баннеры отображались рядом необходимо одному присвоить параметр pair = "1", другому - pair = "2" и указать коды данных способов оплат в разделе '''paymentAvailabilities''' друг за другом.<br />
 
<br>[[Файл: Ea_106.png|Способы оплаты]]<br/>
 
  
===Настройка стилей===
+
| 17
В папке приложения '''EntryPoint''' есть файл ''Views\Shared\'' '''_Layout.cshtml'''.
+
| Настройка задающая название услуги в фискальном чеке если в путевке имеется скрытая услуга "Операторский тур". Описание формирования чека с данными настройками находится в разделе [[Платежные web-сервисы: Сервис интеграции с платежной системой Uniteller (оплата картой в личном кабинете)#Формирование чека при использовании скрытой услуги "Операторский тур" в путевке|Формирование чека при использовании скрытой услуги "Операторский тур" в путевке]].
В тегах <nowiki><div></nowiki> можно разместить информацию в '''Нeader''' и '''Footer'''. Если Header и Footer не нужны, можно в этом же файле их убрать, удалив теги <nowiki><div></nowiki>.
 
  
<nowiki><div id="header">
+
| Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>).
    Header
+
|<syntaxhighlight lang="xml" enclose="div">
  </div>
+
<add key="OperatorTourServiceKey" value="1134"/>
  . . .
+
</syntaxhighlight>
  <div id="footer">
 
    Footer
 
  </div></nowiki>
 
  
==Подготовка данных==
+
|- style="vertical-align:text-top"
Оплату можно произвести по путевкам, '''статус''' которых указан в настройке '''paymentsStatuses'''.<br />
+
|- style="vertical-align:text-top"
Перед использованием приложения '''EntryPoint''' необходимо в таблице tbl_Country в поле CN_RateKey проставить ключи национальных валют для стран, в которых зарегистрированы филиалы продающие путевки.
+
| 18
 +
| Настройка, определяющая '''тип операции при проведении платежа'''.
 +
Обязательная настройка.
 +
| '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="PaymentOperationId" value="1" />
 +
</syntaxhighlight>
  
==Работа в системе==
+
|- style="vertical-align:text-top"
===Поиск путевки===
 
Список заявок, забронированных в базе данных туроператора, доступен в экране [[Мастер-Web:Руководство пользователя. Работа в системе online бронирования#Просмотр списка забронированных туров («OrderList.aspx»)|«Список заказов»]] по адресу: <code><nowiki>http://ip-адрес сервера Мастер-Веб/MasterWebStandard/OrderList.aspx</nowiki></code>.
 
  
[[Файл: am_063.png|left|Предупреждение]]<br />
+
| 19
Экран [[Мастер-Web:Руководство пользователя. Работа в системе online бронирования#Просмотр списка забронированных туров («OrderList.aspx»)|«Список заказов»]] доступен только для '''зарегистрированных''' и '''авторизованных в системе''' пользователей.
+
| Настройка, определяющая '''тип операции при проведении платежа для комиссий'''.
<br />
+
| '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="paymentOperationCommissionId" value="6" />
 +
</syntaxhighlight>
  
После ввода имени пользователя и пароля загрузится '''список заявок''', оформленных на '''покупателя'''/'''агентство''', указанного в [[Мастер-Web:Руководство пользователя. Администрирование ПК Мастер-Web#Регистрация нового пользователя|поле «Партнер в БД МТ»]] при регистрации пользователя в [[Мастер-Web:Руководство пользователя. Администрирование ПК Мастер-Web|Системе администрирования ПК «Мастер-Web»]], который сопоставлен имени текущего пользователя.
+
|- style="vertical-align:text-top"
  
[[Файл: am_1061.png|x500px|Экран «Список заказов»]]<br />
+
| 20
<br />
+
| Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для агентств''').
 +
| '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется запятой).
 +
Комиссия указывается '''в процентах'''.<br />
 +
Сумма оплаты вычисляется следующим образом:<br />
 +
Если из ''конечной суммы'' платежа в системе «Uniteller» ''вычесть'' указанный процент - получится ''стоимость путевки''.<br />
 +
Пример:<br />
 +
Стоимость путевки - '''100 у.е.''' <br />
 +
В настройке указана комиссия - '''50%'''.<br />
 +
Итоговая сумма платежа в системе «Uniteller» - '''200 у.е.'''<br />
 +
<code>'''200 у.е.''' - '''50% * 200 у.е.''' = '''100 у.е.'''</code> (''стоимость путевки'').
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="addAgencyComission" value="3,627" />
 +
</syntaxhighlight>
  
Для отбора путевок можно использовать фильтры:
+
|- style="vertical-align:text-top"
* '''Поиск по номеру заявки''';
+
 
* '''Поиск по фамилии туриста''';
+
| 21
* '''Поиск по статусу документов на визу''';
+
| Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для частных лиц''').
* '''Поиск по стране''';
+
| '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется запятой).
* '''Поиск по дате заявки''';
+
Комиссия указывается '''в процентах'''.<br />
* '''Дата тура с...''' и '''Дата тура по...''';
+
Сумма оплаты вычисляется следующим образом:<br />
* '''Путевки с наличием услуги «Виза»''';
+
Если из ''конечной суммы'' платежа в системе «Uniteller» ''вычесть'' указанный процент - получится ''стоимость путевки''.<br />
* '''Путевки с задолженностями'''.
+
Пример:<br />
 +
Стоимость путевки - '''100 у.е.''' <br />
 +
В настройке указана комиссия - '''50%'''.<br />
 +
Итоговая сумма платежа в системе «Uniteller» - '''200 у.е.'''<br />
 +
<code>'''200 у.е.''' - '''50% * 200 у.е.''' = '''100 у.е.'''</code> (''стоимость путевки'').
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="addPersonalComission" value="5" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 22
 +
| Настройка, включающая расчет через Мастер финанс.
 +
|
 +
* '''false''' - расчет через мастер финанс не включен;
 +
* '''true''' - расчет через мастер финанс включен.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="AddPaymentsToMasterFinance" value="false"/>
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 23
 +
| Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками ''NewDogovorServiceSvKey'' и ''NewDogovorServicePartnerKey''.
 +
| Ключ услуги (Поле '''SL_KEY''' из таблицы <code>'''[ServiceList]'''</code>).
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="NewDogovorServiceServiceListKey" value="450" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 24
 +
| Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServicePartnerKey''.
 +
| Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>).
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="NewDogovorServiceSvKey" value="1055" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 25
 +
| Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServiceSvKey''.
 +
| Ключ класса услуги (Поле '''PR_KEY''' из таблицы <code>'''[Partners]'''</code>).
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="NewDogovorServicePartnerKey" value="12921" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 26
 +
| Настройка, задающая форму оплаты на шлюзе Uniteller
 +
| "All" - и карта и СБП, "Card" - только карта, "SBP" - только СБП
 +
Если параметр не указан, или пустой или любой набор символов, то по умолчанию All
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="PaymentFormType" value="Card" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 27
 +
| Тип отображения комиссии платежной системы в фискальном чеке.<br>
 +
 +
|0 - увеличивает стоимость позиций по чеку на размер (%) комиссию<br>
 +
1 - добавляет в чек комиссию отдельной строкой<br>
 +
 
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="ComissionShowModeInVoucher" value ="0"/>
 +
</syntaxhighlight>
 +
|- style="vertical-align:text-top"
 +
 
 +
| 28
 +
| Наименование позиции в чеке для комиссии для <add key="ComissionShowModeInVoucher" value ="1"/>.<br>
 +
 +
|По умолчанию - "Комиссия платежной системы"
 +
 
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="ComissionTextInVoucher" value ="Юнителлер комиcсия"/>
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 29
 +
| Вид формирования чека <br>
 +
 +
|true - разбить по услугам отдельно, </br>
 +
false - одной строкой из ключа VoucherServiceText</br>
 +
По умолчанию настройка в состоянии false.</br>
 +
 
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="VoucherShowDetails" value="false"/>
 +
</syntaxhighlight>
 +
|- style="vertical-align:text-top"
 +
 
 +
| 30
 +
| Наименование услуги в чеке <br>
 +
 +
|%dogovor% (не обязательно) - для вставки номера договора.</br>
 +
 
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="VoucherServiceText" value="Туристическая услуга по договору %dogovor%"/>
 +
</syntaxhighlight>
 +
|- style="vertical-align:text-top"
 +
 
 +
|}
 +
<br />
 +
=====Фискализация в Uniteller=====
 +
Настройки задаются в секции <code><<paymentMethods>></code> файла <code>web.config</code> приложения '''EntryPoint'''.</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
 +
| Настройка, '''определяющая адрес шлюза оплаты с включенной фискализацией v.1.0'''.<br>
 +
 
 +
|
 +
 
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="unitellerLoginWithFiscalizationUrl" value="https://fpay.uniteller.ru/v1/pay"/>
 +
</syntaxhighlight>
 +
|- style="vertical-align:text-top"
 +
 
 +
 
 +
| 2
 +
| Настройка, '''определяющая адрес шлюза оплаты с включенной фискализацией v.2.0'''.<br>
 +
 
 +
|
 +
 
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="unitellerLoginWithFiscalizationUrl" value="https://fpay.uniteller.ru/v2/pay"/>
 +
</syntaxhighlight>
 +
|- style="vertical-align:text-top"
 +
|}
 +
 
 +
Добавлены следующие возможности в версии 2.0 от версии 1.0:</br>
 +
* Продажа подарочных карт, начисления бонусов-авансов, фискализация авансов.</br>
 +
* Частичная либо полная оплаты заказа подарочными картами, бонусами либо другими авансами.</br>
 +
* Возврат авансов и покупок, оплаченых частично либо полностью авансами.</br>
 +
* Отнесение авансов в доход.</br>
 +
* Осуществления агентских продаж.</br>
 +
* Настройка механизма «Защита от штрафов» для интерфейсов версии 2.0.</br>
 +
Добавлены следующие сценарии:</br>
 +
* Операция оплаты с использованием платежной формы (версия 2.0).</br>
 +
* Операция оплаты с использованием API (версия 2.0).</br>
 +
* Операция оплаты через ApplePay с использованием API (версия 2.0).</br>
 +
* Операция подтверждения преавторизации (версия 2.0).</br>
 +
* Операция отнесения авансов в доход с помощью API.</br>
 +
* Операция отнесения авансов в доход с помощью ЛК.</br>
 +
* Частичная или полная отмена платежа с фискализацией, выполненного через Uniteller (версия 2.0).</br>
 +
* Частичная или полная отмена платежа с фискализацией, выполненного через Uniteller через ЛК (версия 2.0).</br>
 +
* В сценарии регистрации заказа добавлена возможность регистрации для интерфейса 2.0.</br>
 +
* Добавлены программные интерфейсы для новых сценариев.</br>
 +
* Для интерфейсов версии 2.0 изменен формат фискального чека.</br>
 +
====YandexPay====
 +
Настройки задаются в секции <code><YandexPay></code> файла <code>web.config</code> приложения '''EntryPoint'''.<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
 +
| '''Таймаут запроса'''
 +
Обязательная настройка.
 +
| Время ожидания ответа от сервера в миллисекундах.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="RequestTimeout" value="10" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align
 +
 
 +
 
 +
| 2
 +
| '''API-ключ'''
 +
Обязательная настройка.
 +
| Уникальный ключ API для доступа к сервисам Yandex Pay.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="ApiKey" value="a8412f07-5583-4b3e-abe1-06ad6733ea1d" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align
 +
 
 +
 
 +
| 3
 +
| '''URL создания заказа'''
 +
Обязательная настройка.
 +
| URL для запроса на создание ссылки на оплату заказа.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="CreateOrderUrl" value="https://sandbox.pay.yandex.ru/api/merchant/v1/orders" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align
 +
 
 +
 
 +
| 4
 +
| '''URL получения деталей заказа'''
 +
Обязательная настройка.
 +
| URL для запроса на получение деталей заказа.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="GetOrderDetailsUrl" value="https://sandbox.pay.yandex.ru/api/merchant/v1/orders" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align
 +
 
 +
 
 +
| 5
 +
| '''Ставка НДС'''
 +
Обязательная настройка.
 +
| Значение ставки НДС:
 +
 
 +
* '''1''' - НДС по ставке 20%
 +
* '''2''' - НДС по ставке 10%
 +
* '''3''' - НДС по расчетной ставке 20/120
 +
* '''4''' - НДС по расчетной ставке 10/110
 +
* '''5''' - НДС по ставке 0%
 +
* '''6''' - Без НДС
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="Tax" value="1" />
 +
</syntaxhighlight>
 +
|- style="vertical-align
 +
 
 +
 
 +
| 6
 +
| '''Доступные методы оплаты'''
 +
Опциональная настройка.
 +
| Методы оплаты, доступные на платежной форме Yandex Pay:
 +
 
 +
* '''0''' - CARD
 +
* '''1''' - SPLIT
 +
* '''2''' - CARD, SPLIT
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="AvailablePaymentMethods" value="2" />
 +
</syntaxhighlight>
 +
|- style="vertical-align
 +
 
 +
 
 +
| 7
 +
| '''Сплит при наличии комиссии'''
 +
Опциональная настройка.
 +
| Указывает, доступен ли сплит, когда есть комиссия:
 +
 
 +
* '''true''' - доступен
 +
* '''false''' - не доступен
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="AvailableSplitMethodWhenCommission" value="false" />
 +
</syntaxhighlight>
 +
|- style="vertical-align
 +
 
 +
 
 +
| 8
 +
| '''Ключ пользователя'''
 +
Обязательная настройка.
 +
| Ключ пользователя, к которому привязывается оплата.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="masterTourUser" value="106" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align
 +
 
 +
 
 +
| 9
 +
| '''Ключ филиала'''
 +
Обязательная настройка.
 +
| Ключ филиала, к которому привязывается оплата.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="paymentFilialKey" value="7" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align
 +
 
 +
 
 +
| 10
 +
| '''Ключ отдела'''
 +
Обязательная настройка.
 +
| Ключ отдела (кассы), к которому привязывается оплата.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="departmentKey" value="7" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align
 +
 
 +
 
 +
| 11
 +
| '''Тип операции при проведении платежа'''
 +
Обязательная настройка.
 +
| Ключ операции из таблицы PaymentOperations, определяющий тип операции при проведении платежа.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="PaymentOperationId" value="36" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align
 +
 
 +
 
 +
| 12
 +
| '''Тип операции для комиссий'''
 +
Опциональная настройка.
 +
| Ключ операции из таблицы PaymentOperations для комиссий.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="paymentOperationCommissionId" value="7" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align
 +
 
 +
 
 +
| 13
 +
| '''Размер комиссии для агентств'''
 +
Опциональная настройка.
 +
| Размер комиссии для агентств в процентах.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="addAgencyComission" value="10" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align
 +
 
 +
 
 +
| 14
 +
| '''Размер комиссии для частных лиц'''
 +
Опциональная настройка.
 +
| Размер комиссии для частных лиц в процентах.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="addPersonalComission" value="" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align
 +
 
 +
 
 +
| 15
 +
| '''Класс услуги для комиссии'''
 +
Опциональная настройка.
 +
| Класс услуги, добавляемой в путевку при наличии комиссии.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="NewDogovorServiceSvKey" value="1055" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align
 +
 
 +
 
 +
| 16
 +
| '''Услуга для комиссии'''
 +
Опциональная настройка.
 +
| Услуга, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="NewDogovorServiceServiceListKey" value="982" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align
 +
 
 +
 
 +
| 17
 +
| '''Партнер для комиссии'''
 +
Опциональная настройка.
 +
| Партнер, являющийся поставщиком для услуги, добавляемой в путевку при наличии комиссии.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="NewDogovorServicePartnerKey" value="10760" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align
 +
 
 +
 
 +
| 18
 +
| '''Расчеты через MasterFinance'''
 +
Опциональная настройка.
 +
| Указывает, проводятся ли платежи через MasterFinance:
 +
 
 +
* '''true''' - проводятся
 +
* '''false''' - не проводятся
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="AddPaymentsToMasterFinance" value="false" />
 +
</syntaxhighlight>
 +
|- style="vertical-align
 +
 
 +
 
 +
| 19
 +
| '''Система налогообложения'''
 +
Обязательная настройка.
 +
| Указывает, какая система налогообложения будет использоваться при платежах:
 +
 
 +
* '''osn'''  — общая СН
 +
* '''usn_income''' — упрощенная СН (доходы)
 +
* '''usn_income_outcome''' – упрощенная СН (доходы минус расходы)
 +
* '''esn''' – единый сельскохозяйственный налог
 +
* '''patent''' – патентная СН
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="TaxationCode" value="osn" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align
 +
 
 +
 
 +
| 20
 +
| '''Идентификатор группы ККТ'''
 +
Обязательная настройка.
 +
| Идентификатор группы контрольно-кассовой техники.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="ReceiptGroupCode" value="2ca8430a-ff34-421a-b2aa-2071d79eb782" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align
 +
 
 +
 
 +
| 21
 +
| '''Логин для авторизации в сервисе формирования чеков'''
 +
Обязательная настройка.
 +
| Логин для авторизации в сервисе формирования чеков.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="ReceiptLogin" value="7709624788" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align
 +
 
 +
 
 +
| 22
 +
| '''Пароль для авторизации в сервисе формирования чеков'''
 +
Обязательная настройка.
 +
| Пароль для авторизации в сервисе формирования чеков.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="ReceiptPassword" value="79161128982" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align
 +
 
 +
 
 +
| 23
 +
| '''URL для авторизации в сервисе формирования чеков'''
 +
Обязательная настройка.
 +
| URL для авторизации в сервисе формирования чеков.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="ReceiptAuthUrl" value="https://fiscalization.evotor.ru/possystem/v5/getToken" />
 +
</syntaxhighlight>
 +
|- style="vertical-align
 +
| 24
 +
| '''Почта для отправки чеков по умолчанию'''
 +
Опциональная настройка.
 +
| Указывается почта, на которую будут приходить чеки, в случае отсутствия их в партнере или представителе партнера
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="ReceiptClientDefaultEmail" value="peligrim@mail.ru" />
 +
</syntaxhighlight>
 +
|}
 +
 
 +
====Assist====
 +
Настройки задаются в секции <code><Assist></code> файла <code>web.config</code> приложения '''EntryPoint'''.
 +
<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
 +
| Ключ интернет-магазина
 +
| '''Ключ магазина''', который предоставляет Assist
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="shopID" value="326055"/>
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 2
 +
| Логин для авторизации в системе Assist
 +
| '''Логин''' для авторизации, который предоставляет Assist. Необходимо добавить обе настройки.
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="shopLogin" value="login"/>
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 3
 +
| Пароль для авторизации в системе Assist
 +
| '''Пароль''' для авторизации, который предоставляет Assist
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="shopPassword" value="password"/>
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 4
 +
| Логин для авторизации
 +
| '''Логин''' веб-сервиса, который предоставляет Assist
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="webServiceLogin" value=" login "/>
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 5
 +
| Настройка, определяющая пользователя, к которому будет привязываться оплата
 +
| '''Ключ пользователя''' из таблицы '''[UserList]''', к которому привязывается оплата
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="masterTourUser" value="100006"/>
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 6
 +
| Настройка, определяющая партнера, к которому будет привязываться оплата
 +
| '''Ключ партнера''' из таблицы '''[tbl_Partners]''', к которому привязывается оплата
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="paymentFilialKey" value="1"/>
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 7
 +
| Настройка, определяющая отдел, к которому будет привязываться оплата
 +
| '''Ключ отдела (кассы)''' из таблицы '''[PrtDeps]''', к которому привязывается оплата
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="departmentKey" value="2"/>
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 8
 +
| Боевой/тестовый адрес. Откуда получать ответ.
 +
| '''Боевой адрес''', который предоставляет Assist
 +
либо белорусский тестовый сервис:<br />
 +
''https://test.paysec.by/orderstate/orderstate.cfm''<br />
 +
либо питерский тестовый сервис:<br />
 +
''https://payments.demo.paysecure.ru/orderstate/orderstate.cfm<br />''
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="assistGetTransaction" value="" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 9
 +
| Секретное слово из личного кабинета
 +
| '''Секретное слово''', которое указывается в личном кабинете в Assist 
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="salt" value="" />
 +
</syntaxhighlight>
 +
|- style="vertical-align:text-top"
 +
 
 +
|- style="vertical-align:text-top"
 +
| 10
 +
| Настройка, определяющая код валюты, в которой будет совершаться платеж через платежную систему Assist
 +
| '''Код валюты''' из таблицы '''[Rates]''', в которой будет совершаться платеж
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="assistPaymentsRate" value="рб" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 11
 +
| Настройка, определяющая тип операции при проведении платежа
 +
| '''Ключ операции''' из таблицы '''[PaymentOperations]'''
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="paymentOperationId" value="1"/>
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 12
 +
| Настройка, определяющая '''тип операции при проведении платежа для комиссий'''.
 +
| '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="paymentOperationCommissionId" value="6" />
 +
</syntaxhighlight>
 +
 
 +
 
 +
|- style="vertical-align:text-top"
 +
| 13
 +
| Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для агентств''').
 +
| '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется запятой).
 +
Комиссия указывается '''в процентах'''.<br />
 +
Сумма оплаты вычисляется следующим образом:<br />
 +
Если из ''конечной суммы'' платежа в системе «PayOnline» ''вычесть'' указанный процент - получится ''стоимость путевки''.<br />
 +
Пример:<br />
 +
Стоимость путевки - '''100 у.е.''' <br />
 +
В настройке указана комиссия - '''50%'''.<br />
 +
Итоговая сумма платежа в системе «Assist» - '''200 у.е.'''<br />
 +
<code>'''200 у.е.''' - '''50% * 200 у.е.''' = '''100 у.е.'''</code> (''стоимость путевки'').
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="addAgencyComission" value="3,627" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 14
 +
| Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для частных лиц''').
 +
| '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется запятой).
 +
Комиссия указывается '''в процентах'''.<br />
 +
Сумма оплаты вычисляется следующим образом:<br />
 +
Если из ''конечной суммы'' платежа в системе «Assist» ''вычесть'' указанный процент - получится ''стоимость путевки''.<br />
 +
Пример:<br />
 +
Стоимость путевки - '''100 у.е.''' <br />
 +
В настройке указана комиссия - '''50%'''.<br />
 +
Итоговая сумма платежа в системе «PayOnline» - '''200 у.е.'''<br />
 +
<code>'''200 у.е.''' - '''50% * 200 у.е.''' = '''100 у.е.'''</code> (''стоимость путевки'').
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="addPersonalComission" value="5" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 15
 +
| Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками ''NewDogovorServiceSvKey'' и ''NewDogovorServicePartnerKey''.
 +
| Ключ услуги (Поле '''SL_KEY''' из таблицы <code>'''[ServiceList]'''</code>).
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="NewDogovorServiceServiceListKey" value="450" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 16
 +
| Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServicePartnerKey''.
 +
| Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>).
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="NewDogovorServiceSvKey" value="1055" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 17
 +
| Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServiceSvKey''.
 +
| Ключ класса услуги (Поле '''PR_KEY''' из таблицы <code>'''[Partners]'''</code>).
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="NewDogovorServicePartnerKey" value="12921" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 18
 +
| Настройка, включающая расчет через Мастер Финанс.
 +
|
 +
* '''false''' - расчет через Мастер Финанс не включен;
 +
* '''true''' - расчет через Мастер Финанс включен.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="AddPaymentsToMasterFinance" value="false"/>
 +
</syntaxhighlight>
 +
 
 +
|}
 +
 
 +
====Webpay====
 +
Настройки задаются в секции <code><Webpay></code> файла <code>web.config</code> приложения '''EntryPoint'''.
 +
<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
 +
| Идентификатор клиента в платежной системе
 +
| предоставляется Webpay
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="storeID" value="344612596"/>
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 2
 +
| Пароль клиента в платежной системе
 +
| предоставляется Webpay
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="privateKey" value="37kfffkvjj"
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 3
 +
| Код платежного агента
 +
| предоставляется Webpay
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="customerID" value="megatec-2" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 4
 +
| Настройка, определяющая пользователя, к которому будет привязываться оплата
 +
| '''Ключ пользователя''' из таблицы '''[UserList]''', к которому привязывается оплата
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="masterTourUser" value="100006"/>
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 5
 +
| Настройка, определяющая партнера, к которому будет привязываться оплата
 +
| '''Ключ партнера''' из таблицы '''[tbl_Partners]''', к которому привязывается оплата
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="paymentFilialKey" value="1"/>
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 6
 +
| Настройка, определяющая отдел, к которому будет привязываться оплата
 +
| '''Ключ отдела (кассы)''' из таблицы '''[PrtDeps]''', к которому привязывается оплата
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="departmentKey" value="2"/>
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 7
 +
| Откуда получать ответ. Тестовый адрес: https://sandbox.webpay.by
 +
| адрес платежного сервиса
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="webPayGetTransaction" value="https://securesandbox.webpay.by" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 8
 +
| Режим тестирования
 +
| Режим тестирования - 1, боевой режим - 0
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="isTest" value="1" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 9
 +
| Настройка, определяющая тип операции при проведении платежа
 +
| '''Ключ операции''' из таблицы '''[PaymentOperations]'''
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="paymentOperationId" value="1"/>
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 10
 +
| Настройка, определяющая '''тип операции при проведении платежа для комиссий'''.
 +
| '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="paymentOperationCommissionId" value="6" />
 +
</syntaxhighlight>
 +
 
 +
 
 +
|- style="vertical-align:text-top"
 +
| 11
 +
| Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для агентств''').
 +
| '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется запятой).
 +
Комиссия указывается '''в процентах'''.<br />
 +
Сумма оплаты вычисляется следующим образом:<br />
 +
Если из ''конечной суммы'' платежа в системе «PayOnline» ''вычесть'' указанный процент - получится ''стоимость путевки''.<br />
 +
Пример:<br />
 +
Стоимость путевки - '''100 у.е.''' <br />
 +
В настройке указана комиссия - '''50%'''.<br />
 +
Итоговая сумма платежа в системе «Assist» - '''200 у.е.'''<br />
 +
<code>'''200 у.е.''' - '''50% * 200 у.е.''' = '''100 у.е.'''</code> (''стоимость путевки'').
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="addAgencyComission" value="3,627" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 12
 +
| Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для частных лиц''').
 +
| '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется запятой).
 +
Комиссия указывается '''в процентах'''.<br />
 +
Сумма оплаты вычисляется следующим образом:<br />
 +
Если из ''конечной суммы'' платежа в системе «Assist» ''вычесть'' указанный процент - получится ''стоимость путевки''.<br />
 +
Пример:<br />
 +
Стоимость путевки - '''100 у.е.''' <br />
 +
В настройке указана комиссия - '''50%'''.<br />
 +
Итоговая сумма платежа в системе «PayOnline» - '''200 у.е.'''<br />
 +
<code>'''200 у.е.''' - '''50% * 200 у.е.''' = '''100 у.е.'''</code> (''стоимость путевки'').
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="addPersonalComission" value="5" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 13
 +
| Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками ''NewDogovorServiceSvKey'' и ''NewDogovorServicePartnerKey''.
 +
| Ключ услуги (Поле '''SL_KEY''' из таблицы <code>'''[ServiceList]'''</code>).
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="NewDogovorServiceServiceListKey" value="450" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 14
 +
| Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServicePartnerKey''.
 +
| Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>).
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="NewDogovorServiceSvKey" value="1055" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 15
 +
| Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServiceSvKey''.
 +
| Ключ класса услуги (Поле '''PR_KEY''' из таблицы <code>'''[Partners]'''</code>).
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="NewDogovorServicePartnerKey" value="12921" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 16
 +
| Настройка, включающая расчет через Мастер Финанс.
 +
|
 +
* '''false''' - расчет через Мастер Финанс не включен;
 +
* '''true''' - расчет через Мастер Финанс включен.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="AddPaymentsToMasterFinance" value="false"/>
 +
</syntaxhighlight>
 +
 
 +
|}
 +
<br />
 +
 
 +
====PayOnline====
 +
Настройки задаются в секции <code><PayOnline></code> файла <code>web.config</code> приложения '''EntryPoint'''.
 +
<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
 +
| '''Ключ сайта'''.
 +
Обязательная настройка.
 +
| '''Merchant ID''' сайта в системе «PayOnline».
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="merchantId" value="2898" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 2
 +
| '''Ключ'''.
 +
Обязательная настройка.
 +
| '''Security key''' в ''Параметрах интеграции'' сайта в системе «PayOnline».
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="privateSecurityKey" value="XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 3
 +
| Сопоставление кодов валют из ПК «Мастер-Тур» с кодом валюты в системе «PayOnline».
 +
| В качестве параметра '''key''' указывается '''код валюты''' из ПК «Мастер-Тур», в качестве  параметра '''value''' задается '''код валюты''' в системе «PayOnline», например:<br />
 +
|<syntaxhighlight lang="xml">
 +
  <add key="рб" value="RUB"/>
 +
  <add key="$" value="USD"/>
 +
  <add key="EU" value="EUR"/>
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 4
 +
| Настройка, определяющая '''код валюты''', в которой будет '''совершаться платеж''' через платежную систему «PayOnline» при '''значении DefinedBySettings  настройки currencyToPay'''.
 +
| '''Код валюты''' (Поле '''RA_CODE''' из таблицы <code>'''[Rates]'''</code>).
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="currency" value="рб" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 5
 +
| Настройка, определяющая '''валюту''', в которой будет '''совершаться платеж''' через систему «PayOnline».
 +
Обязательная настройка.
 +
|
 +
* '''Contract''' - оплата в ''валюте путевки'';
 +
* '''Tour''' -  оплата в ''валюте тура'';<br />
 +
* '''National''' – оплата в ''национальной валюте'';<br />
 +
* '''DefinedBySettings''' - оплата в ''валюте'', ''определенной настройкой'' '''Сurrency'''.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="currencyToPay" value="Contract" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 6
 +
| Настройка, определяющая '''тип операции при проведении платежа'''.
 +
Обязательная настройка.
 +
| '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="kindOfPay" value="6" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 7
 +
| Настройка, определяющая '''пользователя''' ПК «Мастер-Тур», к которому будет '''привязываться оплата'''.
 +
Обязательная настройка.
 +
| '''Ключ пользователя''', к которому ''привязывается оплата'' (Поле '''US_KEY''' из таблицы <code>'''[UserList]'''</code>).
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="masterTourUser" value="80" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 8
 +
| Настройка, определяющая '''партнера''', к которому будет '''привязываться оплата'''.
 +
Обязательная настройка.
 +
| '''Ключ филиала''', к которому ''привязывается оплата'' (Поле '''PR_KEY''' из таблицы <code>'''[Partners]'''</code>).
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="paymentFilialKey" value="1" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 9
 +
| Настройка, определяющая '''отдел''', к которому будет '''привязываться оплата'''.
 +
Обязательная настройка.
 +
| '''Ключ отдела''' ('''кассы'''), к которому ''привязывается оплата'' (Поле '''PDP_KEY''' из таблицы <code>'''[PrtDeps]'''</code>).
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="departmentKey" value="2" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 10
 +
| Настройка, определяющая тип операции при проведении платежа
 +
| '''Ключ операции''' из таблицы '''[PaymentOperations]'''
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="paymentOperationId" value="1"/>
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 11
 +
| Настройка, определяющая '''тип операции при проведении платежа для комиссий'''.
 +
| '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="paymentOperationCommissionId" value="6" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 12
 +
| Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для агентств''').
 +
Обязательная настройка.
 +
| '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется запятой).
 +
Комиссия указывается '''в процентах'''.<br />
 +
Сумма оплаты вычисляется следующим образом:<br />
 +
Если из ''конечной суммы'' платежа в системе «PayOnline» ''вычесть'' указанный процент - получится ''стоимость путевки''.<br />
 +
Пример:<br />
 +
Стоимость путевки - '''100 у.е.''' <br />
 +
В настройке указана комиссия - '''50%'''.<br />
 +
Итоговая сумма платежа в системе «PayOnline» - '''200 у.е.'''<br />
 +
<code>'''200 у.е.''' - '''50% * 200 у.е.''' = '''100 у.е.'''</code> (''стоимость путевки'').
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="addAgencyComission" value="3,627" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 13
 +
| Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для частных лиц''').
 +
Обязательная настройка.
 +
| '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется запятой).
 +
Комиссия указывается '''в процентах'''.<br />
 +
Сумма оплаты вычисляется следующим образом:<br />
 +
Если из ''конечной суммы'' платежа в системе «PayOnline» ''вычесть'' указанный процент - получится ''стоимость путевки''.<br />
 +
Пример:<br />
 +
Стоимость путевки - '''100 у.е.''' <br />
 +
В настройке указана комиссия - '''50%'''.<br />
 +
Итоговая сумма платежа в системе «PayOnline» - '''200 у.е.'''<br />
 +
<code>'''200 у.е.''' - '''50% * 200 у.е.''' = '''100 у.е.'''</code> (''стоимость путевки'').
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="addPersonalComission" value="5" />
 +
</syntaxhighlight>
 +
|- style="vertical-align:text-top"
 +
 
 +
|- style="vertical-align:text-top"
 +
| 14
 +
| Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками ''NewDogovorServiceSvKey'' и ''NewDogovorServicePartnerKey''.
 +
| Ключ услуги (Поле '''SL_KEY''' из таблицы <code>'''[ServiceList]'''</code>).
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="NewDogovorServiceServiceListKey" value="450" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 15
 +
| Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServicePartnerKey''.
 +
| Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>).
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="NewDogovorServiceSvKey" value="1055" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 16
 +
| Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServiceSvKey''.
 +
| Ключ класса услуги (Поле '''PR_KEY''' из таблицы <code>'''[Partners]'''</code>).
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="NewDogovorServicePartnerKey" value="12921" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 17
 +
| Настройка, включающая расчет через Мастер Финанс.
 +
|
 +
* '''false''' - расчет через Мастер Финанс не включен;
 +
* '''true''' - расчет через Мастер Финанс включен.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="AddPaymentsToMasterFinance" value="false"/>
 +
</syntaxhighlight>
 +
 
 +
|}
 +
<br />
 +
 
 +
 
 +
 
 +
==Сценарии работы==
 +
Предполагаются 3 сценария работы:<br />
 +
1. Заданы размеры комиссий и параметры '''paymentOperationId''', '''paymentOperationComissionId''', '''NewDogovorServiceSvKey''', '''NewDogovorServiceServiceListKey''', '''NewDogovorServicePartnerKey'''. В этом случае при оплате в базе данных формируется 1 ПКО (сумма за путевку + сумма комиссии), в путевке создается услуга "Комиссия при оплате через платежный шлюз" и сумма путевки увеличивается на размер стоимости созданной услуги.<br />
 +
2. Заданы размеры комиссий и параметры '''paymentOperationId''', '''paymentOperationComissionId'''. Параметры '''NewDogovorServiceSvKey''', '''NewDogovorServiceServiceListKey''', '''NewDogovorServicePartnerKey''' не заданы. В этом случае при оплате в базе данных формируются 2 ПКО (отдельно за путевку и за комиссию). Услуга в путевке не создается и сумма путевки не меняется.<br />
 +
3. Заданы размеры комиссий и параметр '''paymentOperationId'''. Значение параметра '''paymentOperationComissionId=0''' или параметр отсутствует. Оплата за комиссию уходит сразу в банк. В этом случае при оплате в базе данных формируется 1 ПКО за путевку.<br />
 +
<span style="color:red">Внимание!</span> Данные настройки не работают при включенной настройке <add key="AddPaymentsToMasterFinance" value="true"/>.
 +
 
 +
==Настройка индивидуальных подписей и ссылок для кнопки оплаты==
 +
Имеется возможность добавить индивидуальную подпись и ссылку к баннеру платежной системы.
 +
Необходимо добавить новые параметры в секции '''paymentMethods''' соответствующего способа оплаты:
 +
<syntaxhighlight lang="xml" enclose="div">
 +
<add code="17" name="Оплатить с кешбек" logoLink="~/Content/themes/base/images/payCashback.jpg"
 +
header="Оплата тура для участников программы «Кешбэк по карте МИР»"
 +
returnMoneyText = "В последствии можно будет вернуть часть средств"
 +
paymentTermsText = "Условия оплаты туров по программе «Кешбэк по карте МИР»"
 +
paymentTermsLink = "https://payment.webpay.by/"
 +
pair = "1"
 +
maximumAmount="1000000"
 +
skipDescriptionPage="true" paymentSystem="Uniteller" link="https://fpay.uniteller.ru/v2/pay"/>
 +
</syntaxhighlight>
 +
<br>[[Файл: Ea_105.png|Описание]]<br />
 +
* '''header''' - шапка с основным описанием способа оплаты<br />
 +
* '''returnMoneyText''' -  дополнительное описание способа оплаты<br />
 +
* '''paymentTermsText''' -  текст гиперссылки<br />
 +
* '''paymentTermsLink''' -  ссылка на которую происходит переход при нажатии на текст гиперссылки<br />
 +
* '''pair''' -  параметр позволяющий связать 2 баннера в пару<br />
 +
В случае, если имеется необходимость в отображении нескольких баннеров с подписями, для корректного отображения на странице рекомендуется их связывать в пары.<br />
 +
Для того, чтобы баннеры отображались рядом необходимо одному присвоить параметр pair = "1", другому - pair = "2" и указать коды данных способов оплат в разделе '''paymentAvailabilities''' друг за другом.<br />
 +
 
 +
==Настройка стилей==
 +
В папке приложения '''EntryPoint''' есть файл ''Views\Shared\'' '''_Layout.cshtml'''.
 +
В тегах <nowiki><div></nowiki> можно разместить информацию в '''Нeader''' и '''Footer'''. Если Header и Footer не нужны, можно в этом же файле их убрать, удалив теги <nowiki><div></nowiki>.
 +
 
 +
<nowiki><div id="header">
 +
    Header
 +
  </div>
 +
  . . .
 +
  <div id="footer">
 +
    Footer
 +
  </div></nowiki>
 +
 
 +
==Подготовка данных==
 +
Оплату можно произвести по путевкам, '''статус''' которых указан в настройке '''paymentsStatuses'''.<br />
 +
Перед использованием приложения '''EntryPoint''' необходимо в таблице tbl_Country в поле CN_RateKey проставить ключи национальных валют для стран, в которых зарегистрированы филиалы продающие путевки.
 +
 
 +
==Работа в системе==
 +
===Поиск путевки===
 +
Список заявок, забронированных в базе данных туроператора, доступен в экране [[Мастер-Web:Руководство пользователя. Работа в системе online бронирования#Просмотр списка забронированных туров («OrderList.aspx»)|«Список заказов»]] по адресу: <code><nowiki>http://ip-адрес сервера Мастер-Веб/MasterWebStandard/OrderList.aspx</nowiki></code>.
 +
 
 +
[[Файл: am_063.png|left|Предупреждение]]<br />
 +
Экран [[Мастер-Web:Руководство пользователя. Работа в системе online бронирования#Просмотр списка забронированных туров («OrderList.aspx»)|«Список заказов»]] доступен только для '''зарегистрированных''' и '''авторизованных в системе''' пользователей.
 +
<br />
 +
 
 +
После ввода имени пользователя и пароля загрузится '''список заявок''', оформленных на '''покупателя'''/'''агентство''', указанного в [[Мастер-Web:Руководство пользователя. Администрирование ПК Мастер-Web#Регистрация нового пользователя|поле «Партнер в БД МТ»]] при регистрации пользователя в [[Мастер-Web:Руководство пользователя. Администрирование ПК Мастер-Web|Системе администрирования ПК «Мастер-Web»]], который сопоставлен имени текущего пользователя.
 +
 
 +
[[Файл: am_1061.png|x500px|Экран «Список заказов»]]<br />
 +
<br />
 +
 
 +
Для отбора путевок можно использовать фильтры:
 +
* '''Поиск по номеру заявки''';
 +
* '''Поиск по фамилии туриста''';
 +
* '''Поиск по статусу документов на визу''';
 +
* '''Поиск по стране''';
 +
* '''Поиск по дате заявки''';
 +
* '''Дата тура с...''' и '''Дата тура по...''';
 +
* '''Путевки с наличием услуги «Виза»''';
 +
* '''Путевки с задолженностями'''.
  
 
===Способ оплаты===
 
===Способ оплаты===
  
[[Файл: am_063.png|left|Предупреждение]]<br />
+
[[Файл: am_063.png|left|Предупреждение]]<br />
  Модуль "Выбор платежной системы" доступен '''только''' для путевок '''имеющих статус''', '''ключ''' которого [[#Настройки ПК «Мастер-Web»|указан в настройке paymentsStatuses]].
+
  Модуль "Выбор платежной системы" доступен '''только''' для путевок '''имеющих статус''', '''ключ''' которого [[#Настройки ПК «Мастер-Web»|указан в настройке paymentsStatuses]].
<br />
+
<br />
 
+
 
Способ оплаты доступен из в экранов [[Мастер-Web:Руководство пользователя. Работа в системе online бронирования#Просмотр списка забронированных туров («OrderList.aspx»)|«Список заявок»]] и [[Мастер-Web:Руководство пользователя. Работа в системе online бронирования#Просмотр подробной информации о заказе («OrderInfo.aspx»)|«Информация о заказе»]].
+
Способ оплаты доступен из в экранов [[Мастер-Web:Руководство пользователя. Работа в системе online бронирования#Просмотр списка забронированных туров («OrderList.aspx»)|«Список заявок»]] и [[Мастер-Web:Руководство пользователя. Работа в системе online бронирования#Просмотр подробной информации о заказе («OrderInfo.aspx»)|«Информация о заказе»]].
 
+
 
Экран '''Список заказов''' доступен по адресу: <code><nowiki>http://ip-адрес сервера Мастер-Веб/MasterWebStandard/OrderList.aspx</nowiki></code>.
+
Экран '''Список заказов''' доступен по адресу: <code><nowiki>http://ip-адрес сервера Мастер-Веб/MasterWebStandard/OrderList.aspx</nowiki></code>.
 
+
 
[[Файл: am_1062.png|x500px|Оплата путевок в экране «Список заказов»]]<br />
+
[[Файл: am_1062.png|x500px|Оплата путевок в экране «Список заказов»]]<br />
<br />
+
<br />
 
+
 
Экран '''Информация о заказе''' доступен по адресу: <code><nowiki>http://ip-адрес сервера Мастер-Веб/MasterWebStandard/OrderInfo.aspx</nowiki></code>.
+
Экран '''Информация о заказе''' доступен по адресу: <code><nowiki>http://ip-адрес сервера Мастер-Веб/MasterWebStandard/OrderInfo.aspx</nowiki></code>.
 
+
 
[[Файл: am_1063.png|x500px|Оплата путевок в экране «Информация о заказе»]]<br />
+
[[Файл: am_1063.png|x500px|Оплата путевок в экране «Информация о заказе»]]<br />
<br />
+
<br />
 +
 
 +
Для выбора способа оплаты необходимо нажать ссылку '''Оплатить''' для нужной путевки (или кнопку '''Оплатить on-line''' в экране '''Информация о заказе'''), после чего пользователь попадает в экран, в котором указывается '''номер заказа''' и  '''доступные способы оплаты'''.<br />
 +
[[Файл: ea_257.png|x500px]]<br />
 +
<br />
 +
Выбрав способ оплаты, открывается экран оплаты, в котором указывается способ оплаты, ссылка на изменение способа (если их несколько), номер путевки, стоимость путевки к оплате, оплаченная сумма, курс валюты, сумма к оплате с учетом комиссии:
 +
 
 +
[[Файл: ep_026.png|x500px|Оплата «Параметры платежа»]]<br />
 +
<br />
 +
 
 +
Сумму к оплате можно изменить, при этом необходимо учитывать правила оплаты, которые выводятся из файла, путь к которому указан в настройке:
 +
<add key="agreementText" value="templates/AgreementText.htm"/>
 +
 
 +
При изменении суммы к оплате автоматически высчитывается комиссия.
 +
 
 +
После нажатия кнопки «Оплатить» определяются параметры для выбранной платежной системы (из соответствующей секции описанной в web.config) и формируется ссылка для передачи параметров платежа платежной системе. Затем осуществляется переход по сформированной ссылке.<br />
 +
[[Файл:Ag 111.png|x1000px|Оплата]]<br />
 +
 
 +
===Возможные ошибки и методы их устранения===
 +
====Ошибка SecureChannelFailure====
 +
Появление такой ошибки может быть вызвано невозможностью установить TLS соединение, которое используется для передачи данных от платежной системы. Вызвано некорректными настройками брандмауэра/firewall или некорректными настройками сервера. В случае обнаружения закрытого канала TLS необходимо обратиться к администратору вашей интернет-сети.
 +
On error occurred during signing in. Contact our manager System.Exception: Some error occured: SecureChannelFailure at Megatec.MasterWeb.PaymentSystem.Tinkoff.TinkoffGateway.Authorization(TinkoffParameters parameters, String token) in C:\Users\vmizh\Work\MasterTour\Source\MW\Megatec.MasterWeb.PaymentSystem.Tinkoff\TinkoffGateway.cs:line 430 at Megatec.MasterWeb.PaymentSystem.Tinkoff.TinkoffGateway.Login(IPaymentParameters parameters) in C:\Users\vmizh\Work\MasterTour\Source\MW\Megatec.MasterWeb.PaymentSystem.Tinkoff\TinkoffGateway.cs:line 106 at MasterWebStandard2.Payment.ParseRequest(String action, String orderCode)
  
Для выбора способа оплаты необходимо нажать ссылку '''Оплатить''' для нужной путевки (или кнопку '''Оплатить on-line''' в экране '''Информация о заказе'''), после чего пользователь попадает в экран, в котором указывается '''номер заказа''' и  '''способы оплаты'''.
+
<font style="color:red">''Для проверки доступности TLS соединения необходимо выполнить следующую команду в командной строке или в оболочке Powershell, заменив ссылку на ссылку для необходимой системы оплаты:''</font><br />
 +
'''Invoke-WebRequest -Uri https://securepay.tinkoff.ru'''<br />
  
[[Файл: ep_025.png|x500px|Оплата «Способ оплаты»]]<br />
+
Вариант успешного ответа при доступном соединении<br />
<br />
+
Invoke-WebRequest : Удаленный сервер возвратил ошибку: (404) Не найден.
 +
строка:1 знак:1
 +
+ Invoke-WebRequest -Uri https://securepay.tinkoff.ru
  
Выбрав способ оплаты, открывается экран оплаты, в котором указывается способ оплаты, ссылка на изменение способа (если их несколько), номер путевки, стоимость путевки к оплате, оплаченная сумма, курс валюты, сумма к оплате с учетом комиссии:
+
Вариант некорректного ответа при закрытом соединении<br />
 +
Invoke-WebRequest : The request was aborted: Could not create SSL/TLS secure channel.
 +
At line:1 char:2
 +
+  Invoke-WebRequest -Uri https://securepay.tinkoff.ru
  
[[Файл: ep_026.png|x500px|Оплата «Параметры платежа»]]<br />
+
====Ошибка конфигурации====
<br />
+
[[Файл: ea_297.png]]<br />
 +
<font style="color:red">''Проверить наличие символов на строке 67 и в строках ниже файла web.config.''</font><br />
  
Сумму к оплате можно изменить, при этом необходимо учитывать правила оплаты, которые выводятся из файла, путь к которому указан в настройке:
+
====500 Внутренняя ошибка сервера====
 
+
[[Файл: ea_298.png]]<br />
<add key="agreementText" value="templates/AgreementText.htm"/>
+
<font style="color:red">''Проверить, что не пропущен символ кавычки " в параметрах файла web.config.''</font><br />
 
 
При изменении суммы к оплате автоматически высчитывается комиссия.
 
 
 
После нажатия кнопки «Оплатить» определяются параметры для выбранной платежной системы (из соответствующей секции описанной в web.config) и формируется ссылка для передачи параметров платежа платежной системе. Затем осуществляется переход по сформированной ссылке.<br />
 
Параметры и способ формирования ссылки к платежной системе определены в отдельном классе для каждой платежной системы, при необходимости можно добавить новые платежные системы.<br />
 
Путевки, оплаченные с использованием модуля '''Выбор платежной системы''', в системе Мастер-Тур как оплаченные не помечаются. Данный функционал находится в разработке.<br />
 
  
 +
====Извините, при обработке запроса произошла ошибка.====
 +
[[Файл: ea_299.png]]<br />
 +
<font style="color:red">''Проверить, что не допущено ошибок в параметрах секции конкретной платежной системы, по которой происходит оплата, в файле web.config.''</font><br />
 
[[Category:Платежные_web-сервисы]]
 
[[Category:Платежные_web-сервисы]]

Текущая версия на 19:35, 2 октября 2024

Содержание

Введение

Предупреждение


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



Модуль EntryPoint предоставляет возможность покупателю/агентству выбрать способ оплаты путевок. Оплата путевок может осуществляться в экранах «Список заявок» (OrderList.aspx) и «Путевка» (OrderInfo.aspx).
В данный момент доступны следующие способы оплаты:

  • Alfabank
  • Sberbank
  • Tinkoff (Т-Банк)
  • Uniteller
  • YandexPay
  • Assist
  • WebPay
  • PayOnline

Установка

Для установки дополнительного модуля EntryPoint нужно создать директорию EntryPoint в каталоге C:/inetpub/wwwroot (корневом каталоге IIS) и выложить туда распакованные файлы из архива
mw-paymentSystem-entryPoin-15.8.0.xxxxxx.zip.
В управлении IIS необходимо создать виртуальный каталог для папки EntryPoint.

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

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

2 Диспетчер служб IIS
Администрирование - Диспетчер служб IIS

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

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

Настройка

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

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

Настройки в файле web.config ПК «Мастер-Web»

Для включения возможности работы EntryPoint необходимо настроить файл конфигурации ПК «Мастер-Web». Настройки задаются в секции <appSettings> файла web.config основного приложения ПК «Мастер-Web».

Описание Значение Настройка
1 Включение дополнительного модуля EntryPoint.

Обязательная настройка.

- true - модуль EntryPoint включен

- false или отсутствие настройки - модуль EntryPoint выключен

<add key="usePaymentEntryPoint" value="true"/>
2 Включение дополнительного модуля EntryPoint.

Обязательная настройка.

- Путь к приложению «EntryPoint».
 <add key="paymentsLink" value="http://somesite/EntryPoint" />
3 Настройка, определяющая статусы путевок, при которых доступна возможность оплаты через систему электронных платежей.

Обязательная настройка.

- ключи статусов из таблицы [Order_Status], при которых доступна оплата через систему электронных платежей.
<add key="paymentsStatuses" value="7,37" />
4 Настройка, позволяющая выводить предупреждающее сообщение о снятии комиссии при оплате. true — сообщение отображается;

false или отсутствие настройки — сообщение не отображается.

<add key="askUserBeforePayment" value="true" />
5 Настройка, определяющая дату, на которую будет подбираться курс валют для пересчета суммы к оплате.
  • FixationDate или отсутствие настройки - курс на дату последней фиксации путевки на момент совершения платежа, а если путевка не зафиксирована, то на дату совершения платежа;
  • ConfirmDate — курс на дату последнего подтверждения заявки (если подтверждения путевки еще не было, либо курс на дату подтверждения не заведен, то будет отображаться курс на момент совершения платежа);
  • OrderDate — дата оформления заявки;
  • PaymentDate - курс на дату совершения платежа.
 <add key="courseExchangeDate" value="OrderDate" />
6 Настройка, определяющая партнеров в базе ПК «Мастер-Тур», которым разрешено осуществлять оплату путёвок онлайн.
  • Ключи партнеров таблицы [tbl_Partners], которым разрешена онлайн-оплата путёвок;
  • пустое значение или отсутствие настройки – онлайн-оплата путёвок доступна всем партнёрам.
<add key="allowedPaymentPartnerKeys" value="10764"/>
7 Включение режима записи нового платежа в систему «Мастер-Финанс». При этом в ПК «Мастер-Тур» платежи не сохраняются.
  • true - включена запись платежей в «Мастер-Финанс»;
  • false или отсутствие настройки - выключает запись платежей в «Мастер-Финанс».
<add key="AddPaymentsToMasterFinance" value="true" />
8 Настройка, позволяющая производить оплату в новой вкладке браузера.
  • false или отсутствие настройки - оплата производится в текущей вкладке браузера;
  • true - оплата производится в новой вкладке браузера.
<add key="OpenPaymentInNewWindow" value="true" />

Настройки в секции appSettings модуля EntryPoint

Настройки секции <appSettings> файла web.config модуля EntryPoint.

Описание Значение Настройка
1 Строка подключения к базе данных ПК «Мастер-Тур»
 <add key="connectionString" value="Data Source=SERVER;Initial Catalog=DATABASE;User Id=AllServices;Password=1"/>
2 Строка подключения к сервису MTS
<add key="acceptableServices" value="MTS"/>
3 Настройка, включающая механизм хэширования пароля пользователя, сохраняемого в файлах cookie, что позволяет усилить безопасность ПК "Мастер-Web". По умолчанию хэширование включено. Значение настройки должно совпадать со значением в файле web.config ПК "Мастер-Web". false - хэширование пароля в файлах cookie выключено;

true или отсутствие настройки - хэширование пароля в файлах cookie включено.

<add key="HashPasswordForCookie" value="true" />
4 Настройка интервала опроса платежной системы для проверки статуса незавершенных платежей.

Интервал опроса платежной системы в минутах для проверки статуса незавершенных платежей. При отсутствии настройки или указании значения меньше 3 опрос осуществляется раз в 3 минуты. Опрос осуществляется через указанное количество минут до времени указанного в настройке "TimeInMinuteForCheckStatePayments"

<add key ="TimeoutInMinuteForPollPaymentSystem" value="3"/>
5 Настройка задержки проверки статуса платежа на платежной системе.

Отсрочка проверки статуса платежа с момента перехода на платежный шлюз, если платеж сразу не прошел в системе банка. Если по истечении этого времени статус платежа на стороне банка не станет оплаченным, то платеж в ПК "Мастер-Тур" не отобразится. При отсутствии настройки или указании значения меньше 10 отсрочка составляет 10 минут.

<add key ="TimeInMinuteForCheckStatePayments" value="10"/>
6 Текст правил оплаты

Правила оплаты берутся из файла AgreementText.htm Если данный файл отсутствует, то описание правил оплаты берется из стандартного файла AgreementText_Standard.htm

<add key="agreementText" value="templates/AgreementText.htm" />

Настройки в секции paymentMethods модуля EntryPoint

В данной секции происходит настройка описания способов оплаты в платежных системах. Настройки секции <paymentMethods> файла web.config модуля EntryPoint.

<paymentMethods>
    <add code="1" name="Tinkoff" logoLink="~/Content/logos/logoTinkoff.png" maximumAmount="1000000" skipDescriptionPage="false" paymentSystem="Tinkoff" link="https://securepay.tinkoff.ru/v2/Init/" />	
</paymentMethods>
  • code="1" - идентификатор платежного метода, должен быть уникальным. Используется в других секциях, для ссылки на данный метод оплаты;
  • name="Tinkoff" - название платежной системы (если не задана ссылка на логотип, то отображается кнопка с наименованием данного поля);
  • paymentSystem="Tinkoff" - название платежной системы. Одно из предопределенных значений:
    • Alfabank
    • Sberbank и SberbankMir, SberbankChildren
    • Tinkoff
    • Uniteller и UnitellerMir, UnitellerChildren
    • Assist
    • WebPay
    • PayOnline
  • LogoLink - расположение логотипа способа оплаты;
  • maximumAmount - максимальный размер платежа;
  • skipDescriptionPage - отображать экран редактирования оплаты или сразу выполнять платеж с текущими значениями.

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

  • link - ссылка на платежную систему, по которой доступен данный способ оплаты.

Настройки в секции paymentAvailabilities модуля EntryPoint

В данной секции происходит настройка описания доступных способов оплаты, заданных в секции paymentMethods, текущему пользователю.

<paymentAvailabilities>
<add code="1" paymentMethodCode="1" countryCode="7" filialCode="1" consumerCode="Person" isAvailable="false" priority="100" tourTypes="2"/>
</paymentAvailabilities>
  • code - идентификатор доступности способа оплаты, должен быть уникальным;
  • paymentMethodCode - идентификатор способа оплаты (code) из секции paymentMethod;
  • countryCode - ограничение доступности метода оплаты по ключу страны (cn_key из таблицы tbl_country). Может быть пустым - доступен для всех стран;
  • filialCode - ограничение доступности метода оплаты по коду партнера-филиала из его карточки (поле PR_COD). Может быть пустым - доступен для всех филиалов;
  • consumerCode - ограничение по типу забронировавшего: турист или агентство. Person - для частных лиц, Agency - для турагентств;
  • isAvailable - включено или выключено это ограничение. Значение false равносильно отсутствию строки в секции;
  • priority - приоритет при выборе нескольких доступных вариантов оплаты;
  • tourTypes - ограничение доступности метода оплаты по ключу типа тура (tp_key из таблицы TipTur). Отсутствие параметра или пустой параметр - оплата доступна для всех типов туров.

Настройки подключения и параметров используемых платежных систем модуля EntryPoint

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

Alfabank

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

Описание Значение Настройка
1 Точки продажи (shop_ID)

Обязательная настройка.

Shop_ID из раздела Точки продажи ЛК «Alfabank».
<add key="shop_id" value="32565" />
2 Логин

Обязательная настройка.

Login из раздела Параметры авторизации ЛК «Alfabank».
<add key="login" value="megatec" />
3 Пароль

Обязательная настройка.

Password из раздела Параметры авторизации ЛК «Alfabank».
<add key="password" value="ХХХХХХХХХХ" />
4 Настройка, определяющая язык окна платежной формы «Alfabank».

Обязательная настройка.

  • ru - русский язык
  • en - английский язык
<add key="language" value="ru" />
5 Ссылка на платежный шлюз

Ссылка на платежный шлюз

<add key="paymentSystemLoginURL" value="https://ws.egopay.ru/order/v2/" />
6 Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для агентств)

Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется запятой). Комиссия указывается в процентах.

<add key="addAgencyComission" value="15,8" />
7 Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для частных лиц)

Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется запятой). Комиссия указывается в процентах.

<add key="addPersonalComission" value="17,4" />
8 Настройка, определяющая пользователя ПК «Мастер-Тур», к которому будет привязываться оплата.

Обязательная настройка.

Ключ пользователя, к которому привязывается оплата (Поле US_KEY из таблицы [UserList]).
<add key="masterTourUser" value="0" />
9 Настройка, определяющая отдел, к которому будет привязываться оплата.

Обязательная настройка.

Ключ отдела (кассы), к которому привязывается оплата (Поле PDP_KEY из таблицы [PrtDeps]).
<add key="departmentKey" value="0" />
10 Настройка, включающая расчет через Мастер финанс.
  • false - расчет через мастер финанс не включен;
  • true - расчет через мастер финанс включен.
<add key="AddPaymentsToMasterFinance" value="false"/>
11 Настройка, определяющая тип операции при проведении платежа.

Обязательная настройка.

Ключ операции (Поле PO_ID из таблицы [PaymentOperations]).
<add key="PaymentOperationId" value="6" />
12 Настройка, определяющая тип операции при проведении платежа для комиссий. Ключ операции (Поле PO_ID из таблицы [PaymentOperations]).
<add key="paymentOperationCommissionId" value="" />
13 Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками NewDogovorServiceSvKey и NewDogovorServicePartnerKey. Ключ услуги (Поле SL_KEY из таблицы [ServiceList]).

Название услуги комиссии в путевке берется из этого параметра

<add key="NewDogovorServiceServiceListKey" value="450" />
14 Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками NewDogovorServiceServiceListKey и NewDogovorServicePartnerKey. Ключ класса услуги (Поле SV_KEY из таблицы [Service]).

Название услуги комиссии в путевке берется из этого параметра

<add key="NewDogovorServiceSvKey" value="1055" />
15 Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками NewDogovorServiceServiceListKey и NewDogovorServiceSvKey. Ключ класса услуги (Поле PR_KEY из таблицы [Partners]).
<add key="NewDogovorServicePartnerKey" value="12921" />
16 Настройка, определяющая адрес электронной почты по умолчанию. Используется в том случае, если не указан адрес электронной почты главного туриста.
<add key="defaultEmail" value="" />


Формирование чеков Alfabank

Настройки для формирования чека задаются в секции <Alfabank> файла web.config приложения EntryPoint.
Обратите внимание, настройки являются обязательными.

Описание Значение Настройка
1 Система налогообложения Значения:
 general — общая
 simple_income — упрощенная (доходы)
 simple_profit — упрощенная (доходы минус расходы)
 patent — патентная
 unified_agricultural — единый сельскохозяйственный налог
<add key="TaxationCode" value="general" />
2 Ставка НДС Значения:
 no — без НДС
 0 — 0%
 10 — 10%
 20 — 20%
 10/110 — 10/110
 20/120 — 20/120
<add key="Tax" value="no" />


Обратите внимание, что для каждой услуги отправляется на уровне кода:

  • typename - ServiceType согласно ключу SvKey, нигде в чеке не фигурирует;
  • number - ключ услуги в БД;
  • quantity - 1(услуга);
  • name - "Туристическая услуга по путевке {код договора}";
  • amount - сумма оплаты по услуге и валюта;
  • taxation_item_settlement_method - "full_prepayment";
  • taxation_item_type - "service";
  • taxation_system - "general" по умолчанию, если не указано иное в конфиге;
  • taxes - налог, где
    • amount - вычисляется согласно выбранной системе расчета налога и валюта;
    • percentage - "no" по умолчанию, иначе - из конфига "20/120" и т.д.;
    • type - "vat";
    • source - "shop"
Предупреждение


Обратите внимание, что для корректной записи платежей в Мастер Тур, необходимо настроить автоматическое подтверждение платежа. Для этого необходимо обратиться в техподдержку Альфа-Банка.

Существует возможность также подтверждать платежи вручную. Подробнее можно ознакомиться тут https://ecom.alfabank.ru/assets/instructions/merchantManual/pages/index/general_description.html#koordinati_podkljuchenija или запросить информацию в технической поддержке Альфа-Банка

Sberbank

Настройки задаются в секции <Sberbank> файла web.config приложения EntryPoint. При использовании SberbankMir или SberbankMir необходимо заполнить соответствующие секции в файле web.config.

Описание Значение Настройка
1 Идентификатор клиента, который выдается платежной системой Sberbank.

Обязательная настройка.

Идентификатор клиента
<add key="userName" value="логин sberbank-api" />
2 Пароль клиента, который выдается платежной системой Sberbank.

Обязательная настройка.

Пароль клиента
<add key="password" value="пароль sberbank-api" />
3 Ссылка на платежный шлюз Sberbank Аналогично настройке link в секции Sberbank в разделе<paymentMethods>
<add key="sberbankPaymentApplicationUrl" value="https://securepayments.sberbank.ru/payment/rest/" />
4 Настройка, определяющая пользователя ПК «Мастер-Тур», к которому будет привязываться оплата.

Обязательная настройка.

Ключ пользователя, к которому привязывается оплата (Поле US_KEY из таблицы [UserList]).
<add key="masterTourUser" value="95" />
5 Настройка, позволяющая создавать объект orderBundle (товарная корзина), в котором передаются все необходимые данные о товаре/услуге.
  • true - включено создание объекта orderBundle
  • false или отсутствие настройки - объект orderBundle не создается

По умолчанию настройка имеет значение false.

<add key="useFiscalization" value="false"/>
6 Настройка, определяющая тип операции при проведении платежа.

Обязательная настройка.

Ключ операции (Поле PO_ID из таблицы [PaymentOperations]).
<add key="PaymentOperationId" value="1" />
7 Настройка, определяющая тип операции при проведении платежа для комиссий. Ключ операции (Поле PO_ID из таблицы [PaymentOperations]).


Внимание!
Если данная настройка не заполнена, то значения настроек NewDogovorServiceServiceListKey, NewDogovorServiceSvKey, NewDogovorServicePartnerKey обязательно оставить незаполненными.

<add key="paymentOperationCommissionId" value="6" />
8 Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для агентств).
Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется либо запятой, либо точкой).

Комиссия указывается в процентах.
По умолчанию комиссия для агентств равна нулю.

<add key="addAgencyComission" value="3.627" />
9 Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для частных лиц).
Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется либо запятой, либо точкой).

Комиссия указывается в процентах.
По умолчанию комиссия для частных лиц равна нулю.

<add key="addPersonalComission" value="5.0" />
10 Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками NewDogovorServiceSvKey и NewDogovorServicePartnerKey. Ключ услуги (Поле SL_KEY из таблицы [ServiceList]).
<add key="NewDogovorServiceServiceListKey" value="450" />
11 Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками NewDogovorServiceServiceListKey и NewDogovorServicePartnerKey. Ключ класса услуги (Поле SV_KEY из таблицы [Service]).
<add key="NewDogovorServiceSvKey" value="1055" />
12 Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками NewDogovorServiceServiceListKey и NewDogovorServiceSvKey. Ключ класса услуги (Поле PR_KEY из таблицы [Partners]).
<add key="NewDogovorServicePartnerKey" value="12921" />
13 Настройка, включающая расчет через Мастер финанс.
  • false - расчет через мастер финанс не включен;
  • true - расчет через мастер финанс включен.
<add key="AddPaymentsToMasterFinance" value="false"/>


Tinkoff (Т-Банк)

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

Описание Значение Настройка
1 Платежный метод

Обязательная настройка.

способ оплаты в платежной системе «Tinkoff (Т-Банк)».
  • code="1" – идентификатор платежного метода, должен быть уникальным. Используется в других секциях, для ссылки на данный метод оплаты;
  • name="Tinkoff" – название платежной системы (если не задана ссылка на логотип, то отображается кнопка с наименованием данного поля);
  • paymentSystem="Tinkoff" – название платежной системы.
  • LogoLink – расположение логотипа способа оплаты;
  • maximumAmount – максимальный размер платежа;
  • skipDescriptionPage – отображать экран редактирования оплаты или сразу выполнять платеж с текущими значениями.
    • Если значение skipDescriptionPage=true, то сразу происходит переход к оплате.
    • Если значение skipDescriptionPage=false, то происходит переход на страницу редактирования суммы к оплате, а уже из нее переход к оплате на платежный шлюз.
  • displayWindowWithEditingRequestData – настройка включающая проверку e-mail и телефона плательщика, при отсутствии выводит модальное окно с просьбой ввести e-mail и телефон плательщика. после ввода данных отправлять на оплату.
    • false – проверка не проводится
    • true – проверка проводится
<add code="12" name="Платформа Tinkoff" logoLink="~/Content/logos/logoTinkoff.png"
		     maximumAmount="1000000"
		     skipDescriptionPage="false" displayWindowWithEditingRequestData="true" paymentSystem="Tinkoff" />


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

Описание Значение Настройка
1 Адрес платежной службы

Обязательная настройка.

Адрес сервиса оплаты через карту банка «Tinkoff (Т-Банк)».
<add key="LoginUrl" value="https://securepay.tinkoff.ru/v2/Init"/>
2 Адрес для оплаты по QR коду

Обязательная настройка.

Адрес сервиса оплаты через карту банка «Tinkoff (Т-Банк)» по QR коду.
<add key="QRCodeUrl" value="https://securepay.tinkoff.ru/v2/GetQr"/>
3 Адрес метода для получения статуса платежа

Обязательная настройка.

Адрес метода для получения статуса платежа.
<add key="GetStateUrl" value="https://securepay.tinkoff.ru/v2/GetState"/>
4 Адрес метода возвращающего статус заказа

Обязательная настройка.

Адрес метода возвращающего статус заказа.
<add key="CheckOrderUrl" value="https://securepay.tinkoff.ru/v2/CheckOrder"/>
5 Идентификатор терминала

Обязательная настройка.

Параметр Терминал из раздела Терминалы в л/к сервиса «Tinkoff (Т-Банк)».
<add key="TerminalKey" value="1587990738"/>
6 Пароль терминала

Обязательная настройка.

Параметр Пароль из раздела Терминалы в л/к сервиса «Tinkoff (Т-Банк)».
<add key="TerminalPassword" value="cn5du3jxcfbmwtyuii"/>
7 Настройка, определяющая язык окна платежной формы «Tinkoff (Т-Банк)».

Обязательная настройка.

  • ru - русский язык
  • en - английский язык
<add key="LanguageFormCode" value="ru"/>
8 Код системы налогообложения, его значение должно соответствовать режимам налогообложения, сконфигурированным в ККМ при регистрации. Данная настройка необходима для работы фискализации платежей.
  • osn – общая система налогообложения
  • usn_income – упрощенная система налогообложения (Доход)
  • usn_income_outcome – упрощенная СН (Доход минус Расход)
  • patent – патентная система налогообложения
  • envd – единый налог на вмененный доход
  • esn – единый сельскохозяйственный налог
<add key="TaxationCode" value="osn"/>
9 Код ставки налогообложения. Данная настройка необходима для работы фискализации платежей.
  • none – не облагается НДС
  • vat0 – облагается НДС по ставке 0%
  • vat10 – облагается НДС по ставке 10%
  • vat20 – облагается НДС по ставке 20%
  • vat110 – облагается НДС по ставке 10/110
  • vat120 – облагается НДС по ставке 18/120
<add key="Tax" value="none"/>
10 Настройка, определяющая тип операции при проведении платежа.

Обязательная настройка.

Ключ операции (Поле PO_ID из таблицы [PaymentOperations]).
<add key="PaymentOperationId" value="6" />
11 Настройка, определяющая тип операции при проведении платежа для комиссий. Ключ операции (Поле PO_ID из таблицы [PaymentOperations]).
<add key="paymentOperationCommissionId" value="" />
12 Настройка, определяющая пользователя ПК «Мастер-Тур», к которому будет привязываться оплата.

Обязательная настройка.

Ключ пользователя, к которому привязывается оплата (Поле US_KEY из таблицы [UserList]).
<add key="masterTourUser" value="80" />
13 Настройка, определяющая партнера, к которому будет привязываться оплата.

Обязательная настройка.

Ключ филиала, к которому привязывается оплата (Поле PR_KEY из таблицы [Partners]).
<add key="paymentFilialKey" value="1" />
14 Настройка, определяющая отдел, к которому будет привязываться оплата.

Обязательная настройка.

Ключ отдела (кассы), к которому привязывается оплата (Поле PDP_KEY из таблицы [PrtDeps]).
<add key="departmentKey" value="2" />
15 Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для агентств)

Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется запятой). Комиссия указывается в процентах.

<add key="addAgencyComission" value="15,8" />
16 Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для частных лиц)

Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется запятой). Комиссия указывается в процентах.

<add key="addPersonalComission" value="17,4" />
17 Настройка, включающая расчет через Мастер финанс.
  • false - расчет через мастер финанс не включен;
  • true - расчет через мастер финанс включен.
<add key="AddPaymentsToMasterFinance" value="false"/>
18 Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками NewDogovorServiceSvKey и NewDogovorServicePartnerKey. Ключ услуги (Поле SL_KEY из таблицы [ServiceList]).

Название услуги комиссии в путевке берется из этого параметра

<add key="NewDogovorServiceServiceListKey" value="450" />
19 Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками NewDogovorServiceServiceListKey и NewDogovorServicePartnerKey.

Название услуги комиссии в путевке берется из этого параметра

Ключ класса услуги (Поле SV_KEY из таблицы [Service]).
<add key="NewDogovorServiceSvKey" value="1055" />
20 Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками NewDogovorServiceServiceListKey и NewDogovorServiceSvKey. Ключ класса услуги (Поле PR_KEY из таблицы [Partners]).
<add key="NewDogovorServicePartnerKey" value="12921" />
21 Настройки, определяющие способ расчета. Если значение не передано, по умолчанию будет передаваться full_payment – полный расчет.
  • Если сумма, которую мы оплачиваем меньше суммы, которую нужно оплатить, способ расчета определяется следующим образом:
    • Если PaymentMethodPrepayment имеет значение, то берем его. Если он пуст, то берем PaymentMethodMain, если и он пуст, то передаем пустое значение (а на стороне Тинькофф это будет full_payment)
  • Если по договору уже есть какая-то ранее оплаченная сумма, то способ расчета считается следующим образом:
    • Если сумма, которую мы оплачиваем равна сумме, которую нужно оплатить, берем PaymentMethodFull. Если он пуст, то берем PaymentMethodMain, если и он пуст, то передаем пустое значение (а на стороне Тинькофф это будет full_payment)
  • Если у нас нет ранее оплаченной суммы, то способ расчета считается следующим образом:
    • Если сумма, которую мы оплачиваем равна сумме, которую нужно оплатить, берем PaymentMethodMain. Если он пуст, то передаем пустое значение (а на стороне Тинькофф это будет full_payment)
Возможные значения:
  • full_prepayment – предоплата 100%
  • prepayment – предоплата
  • advance – аванс
  • full_payment – полный расчет
  • partial_payment – частичный расчет и кредит
  • credit – передача в кредит
  • credit_payment – оплата кредита
<add key="PaymentMethodMain" value="prepayment" />
<add key="PaymentMethodPrepayment" value="full_prepayment" />
<add key="PaymentMethodFull" value="" />


Uniteller

Настройки задаются в секции <Uniteller> файла web.config приложения EntryPoint. При использовании UnitellerMir или UnitellerChildren необходимо заполнить соответствующие секции в файле web.config.

Описание Значение Настройка
1 Точки продажи (shopIDP)

Обязательная настройка.

Uniteller Point ID из раздела Точки продажи ЛК «Uniteller».
<add key="shopIDP" value="00005432"/>
2 Логин

Обязательная настройка.

Login из раздела Параметры авторизации ЛК «Uniteller».
<add key="login" value="2281" />
3 Пароль

Обязательная настройка.

Password из раздела Параметры авторизации ЛК «Uniteller».
<add key="password" value="XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX" />
4 Платёжная система кредитной карты.
  • 0 или отсутствует значение - любая
  • 1 - VISA
  • 2 - MasterCard
  • 3 - Diners Club
  • 4 - JCB
  • 5 - American Express
<add key="meanType" value="" />
5 Тип электронной валюты.
  • 0 или отсутствует значение - любая система электронных платежей
  • 1 - Яндекс.Деньги
  • 2 - RBK Money
  • 3 - MoneyMail
  • 4 - WebCreds
  • 6 - Platezh.ru
  • 7 - Деньги@Mail.Ru
  • 8 - Мобильный платёж Мегафон
  • 9 - Мобильный платёж МТС
  • 10 - Мобильный платёж Билайн
  • 11 - PayPal
  • 12 - ВКонтакте
  • 13 - Евросеть
  • 14 - Yota.money
  • 15 - QIWI Кошелек
  • 16 - ПлатФон
  • 17 - Moneybookers
  • 29 - WebMoney WMR
<add key="eMoneyType" value="" />
6 Таймаут между попытками запроса результата

По умолчанию 100.

<add key="requestTimeout" value="100" />
7 Количество попыток запроса результата

По умолчанию 5.

<add key="requestAttempts" value="5" />
8 Настройка, определяющая пользователя ПК «Мастер-Тур», к которому будет привязываться оплата.

Обязательная настройка.

Ключ пользователя, к которому привязывается оплата (Поле US_KEY из таблицы [UserList]).
<add key="masterTourUser" value="80" />
9 Настройка, определяющая партнера, к которому будет привязываться оплата.

Обязательная настройка.

Ключ филиала, к которому привязывается оплата (Поле PR_KEY из таблицы [Partners]).
<add key="paymentFilialKey" value="1" />
10 Настройка, определяющая отдел, к которому будет привязываться оплата.

Обязательная настройка.

Ключ отдела (кассы), к которому привязывается оплата (Поле PDP_KEY из таблицы [PrtDeps]).
<add key="departmentKey" value="2" />
11 Настройка, определяющая валюту, в которой будет совершаться платеж через систему «Uniteller».

Обязательная настройка.

  • Contract - оплата в валюте путевки;
  • Tour - оплата в валюте тура;
  • National – оплата в национальной валюте;
  • DefinedBySettings - оплата в валюте, определенной настройкой Сurrency.
<add key="currencyToPay" value="Contract" />
12 Настройка, определяющая код валюты, в которой будет совершаться платеж через платежную систему «Uniteller» при значении DefinedBySettings настройки currencyToPay. Код валюты (Поле RA_CODE из таблицы [Rates]).

Код валюты из ПК «Мастер-Тур» должен быть сопоставлен с кодом валюты в системе «Uniteller». Данное сопоставление задается в секции <currencyMap>, в качестве параметра key указывается код валюты из ПК «Мастер-Тур», в качестве параметра value задается код валюты в системе «Uniteller», например:

<currencyMap>
      <add key="рб" value="RUB"/>
      <add key="грн" value="UAH"/>
      <add key="azn" value="AZN"/>
      <add key="тг" value="KZT"/>
</currencyMap>
.
<add key="currency" value="рб" />
13 Включение функционала фискализации платежей.

После включения необходимо заполнить настройки Код системы налогообложения (TaxMode) и Код ставки налогообложения (TaxRateCode).

  • true – использовать фискализацию при оплате
  • false или отсутствие настройки – не использовать фискализацию при оплате
<add key="UseFiscalization" value="true"/>
14 Код системы налогообложения, его значение должно соответствовать режимам налогообложения, сконфигурированным в ККМ при регистрации. Данная настройка необходима для работы фискализации платежей.
  • 0 – общая система налогообложения
  • 1 – упрощенная система налогообложения (Доход)
  • 2 – упрощенная СН (Доход минус Расход)
  • 3 – единый налог на вмененный доход
  • 4 – единый сельскохозяйственный налог
  • 5 – патентная система налогообложения
<add key="TaxMode" value=""/>
15 Код ставки налогообложения. Данная настройка необходима для работы фискализации платежей.
  • -1 – не облагается НДС
  • 0 – облагается НДС по ставке 0%
  • 10 – облагается НДС по ставке 10%
  • 18 – облагается НДС по ставке 18%
  • 110 – облагается НДС по ставке 10/110
  • 118 – облагается НДС по ставке 18/118
<add key="TaxRateCode" value=""/>
16 Настройка, задающая услугу страхования, добавляемую в фискальный чек. Применяется в случае если в путевке отсутствует скрытая услуга "Операторский тур".

Описание формирования чека с данными настройками находится в разделе Формирование чека при использовании скрытой услуги "Операторский тур" в путевке.

Ключ класса услуги (Поле SV_KEY из таблицы [Service]).
<add key="InsuranceServiceKey" value="6"/>
17 Настройка задающая название услуги в фискальном чеке если в путевке имеется скрытая услуга "Операторский тур". Описание формирования чека с данными настройками находится в разделе Формирование чека при использовании скрытой услуги "Операторский тур" в путевке. Ключ класса услуги (Поле SV_KEY из таблицы [Service]).
<add key="OperatorTourServiceKey" value="1134"/>
18 Настройка, определяющая тип операции при проведении платежа.

Обязательная настройка.

Ключ операции (Поле PO_ID из таблицы [PaymentOperations]).
<add key="PaymentOperationId" value="1" />
19 Настройка, определяющая тип операции при проведении платежа для комиссий. Ключ операции (Поле PO_ID из таблицы [PaymentOperations]).
<add key="paymentOperationCommissionId" value="6" />
20 Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для агентств). Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется запятой).

Комиссия указывается в процентах.
Сумма оплаты вычисляется следующим образом:
Если из конечной суммы платежа в системе «Uniteller» вычесть указанный процент - получится стоимость путевки.
Пример:
Стоимость путевки - 100 у.е.
В настройке указана комиссия - 50%.
Итоговая сумма платежа в системе «Uniteller» - 200 у.е.
200 у.е. - 50% * 200 у.е. = 100 у.е. (стоимость путевки).

<add key="addAgencyComission" value="3,627" />
21 Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для частных лиц). Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется запятой).

Комиссия указывается в процентах.
Сумма оплаты вычисляется следующим образом:
Если из конечной суммы платежа в системе «Uniteller» вычесть указанный процент - получится стоимость путевки.
Пример:
Стоимость путевки - 100 у.е.
В настройке указана комиссия - 50%.
Итоговая сумма платежа в системе «Uniteller» - 200 у.е.
200 у.е. - 50% * 200 у.е. = 100 у.е. (стоимость путевки).

<add key="addPersonalComission" value="5" />
22 Настройка, включающая расчет через Мастер финанс.
  • false - расчет через мастер финанс не включен;
  • true - расчет через мастер финанс включен.
<add key="AddPaymentsToMasterFinance" value="false"/>
23 Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками NewDogovorServiceSvKey и NewDogovorServicePartnerKey. Ключ услуги (Поле SL_KEY из таблицы [ServiceList]).
<add key="NewDogovorServiceServiceListKey" value="450" />
24 Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками NewDogovorServiceServiceListKey и NewDogovorServicePartnerKey. Ключ класса услуги (Поле SV_KEY из таблицы [Service]).
<add key="NewDogovorServiceSvKey" value="1055" />
25 Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками NewDogovorServiceServiceListKey и NewDogovorServiceSvKey. Ключ класса услуги (Поле PR_KEY из таблицы [Partners]).
<add key="NewDogovorServicePartnerKey" value="12921" />
26 Настройка, задающая форму оплаты на шлюзе Uniteller "All" - и карта и СБП, "Card" - только карта, "SBP" - только СБП

Если параметр не указан, или пустой или любой набор символов, то по умолчанию All

<add key="PaymentFormType" value="Card" />
27 Тип отображения комиссии платежной системы в фискальном чеке.
0 - увеличивает стоимость позиций по чеку на размер (%) комиссию

1 - добавляет в чек комиссию отдельной строкой

<add key="ComissionShowModeInVoucher" value ="0"/>
28 Наименование позиции в чеке для комиссии для <add key="ComissionShowModeInVoucher" value ="1"/>.
По умолчанию - "Комиссия платежной системы"
<add key="ComissionTextInVoucher" value ="Юнителлер комиcсия"/>
29 Вид формирования чека
true - разбить по услугам отдельно,

false - одной строкой из ключа VoucherServiceText
По умолчанию настройка в состоянии false.

<add key="VoucherShowDetails" value="false"/>
30 Наименование услуги в чеке
%dogovor% (не обязательно) - для вставки номера договора.
<add key="VoucherServiceText" value="Туристическая услуга по договору %dogovor%"/>


Фискализация в Uniteller

Настройки задаются в секции <<paymentMethods>> файла web.config приложения EntryPoint.
В зависимости от типа используемой фискализации прописывается соответствующая настройка.

Описание Значение Настройка
1 Настройка, определяющая адрес шлюза оплаты с включенной фискализацией v.1.0.
<add key="unitellerLoginWithFiscalizationUrl" value="https://fpay.uniteller.ru/v1/pay"/>
2 Настройка, определяющая адрес шлюза оплаты с включенной фискализацией v.2.0.
<add key="unitellerLoginWithFiscalizationUrl" value="https://fpay.uniteller.ru/v2/pay"/>

Добавлены следующие возможности в версии 2.0 от версии 1.0:

  • Продажа подарочных карт, начисления бонусов-авансов, фискализация авансов.
  • Частичная либо полная оплаты заказа подарочными картами, бонусами либо другими авансами.
  • Возврат авансов и покупок, оплаченых частично либо полностью авансами.
  • Отнесение авансов в доход.
  • Осуществления агентских продаж.
  • Настройка механизма «Защита от штрафов» для интерфейсов версии 2.0.

Добавлены следующие сценарии:

  • Операция оплаты с использованием платежной формы (версия 2.0).
  • Операция оплаты с использованием API (версия 2.0).
  • Операция оплаты через ApplePay с использованием API (версия 2.0).
  • Операция подтверждения преавторизации (версия 2.0).
  • Операция отнесения авансов в доход с помощью API.
  • Операция отнесения авансов в доход с помощью ЛК.
  • Частичная или полная отмена платежа с фискализацией, выполненного через Uniteller (версия 2.0).
  • Частичная или полная отмена платежа с фискализацией, выполненного через Uniteller через ЛК (версия 2.0).
  • В сценарии регистрации заказа добавлена возможность регистрации для интерфейса 2.0.
  • Добавлены программные интерфейсы для новых сценариев.
  • Для интерфейсов версии 2.0 изменен формат фискального чека.

YandexPay

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

Описание Значение Настройка
1 Таймаут запроса

Обязательная настройка.

Время ожидания ответа от сервера в миллисекундах.
<add key="RequestTimeout" value="10" />
2 API-ключ

Обязательная настройка.

Уникальный ключ API для доступа к сервисам Yandex Pay.
<add key="ApiKey" value="a8412f07-5583-4b3e-abe1-06ad6733ea1d" />
3 URL создания заказа

Обязательная настройка.

URL для запроса на создание ссылки на оплату заказа.
<add key="CreateOrderUrl" value="https://sandbox.pay.yandex.ru/api/merchant/v1/orders" />
4 URL получения деталей заказа

Обязательная настройка.

URL для запроса на получение деталей заказа.
<add key="GetOrderDetailsUrl" value="https://sandbox.pay.yandex.ru/api/merchant/v1/orders" />
5 Ставка НДС

Обязательная настройка.

Значение ставки НДС:
  • 1 - НДС по ставке 20%
  • 2 - НДС по ставке 10%
  • 3 - НДС по расчетной ставке 20/120
  • 4 - НДС по расчетной ставке 10/110
  • 5 - НДС по ставке 0%
  • 6 - Без НДС
<add key="Tax" value="1" />
6 Доступные методы оплаты

Опциональная настройка.

Методы оплаты, доступные на платежной форме Yandex Pay:
  • 0 - CARD
  • 1 - SPLIT
  • 2 - CARD, SPLIT
<add key="AvailablePaymentMethods" value="2" />
7 Сплит при наличии комиссии

Опциональная настройка.

Указывает, доступен ли сплит, когда есть комиссия:
  • true - доступен
  • false - не доступен
<add key="AvailableSplitMethodWhenCommission" value="false" />
8 Ключ пользователя

Обязательная настройка.

Ключ пользователя, к которому привязывается оплата.
<add key="masterTourUser" value="106" />
9 Ключ филиала

Обязательная настройка.

Ключ филиала, к которому привязывается оплата.
<add key="paymentFilialKey" value="7" />
10 Ключ отдела

Обязательная настройка.

Ключ отдела (кассы), к которому привязывается оплата.
<add key="departmentKey" value="7" />
11 Тип операции при проведении платежа

Обязательная настройка.

Ключ операции из таблицы PaymentOperations, определяющий тип операции при проведении платежа.
<add key="PaymentOperationId" value="36" />
12 Тип операции для комиссий

Опциональная настройка.

Ключ операции из таблицы PaymentOperations для комиссий.
<add key="paymentOperationCommissionId" value="7" />
13 Размер комиссии для агентств

Опциональная настройка.

Размер комиссии для агентств в процентах.
<add key="addAgencyComission" value="10" />
14 Размер комиссии для частных лиц

Опциональная настройка.

Размер комиссии для частных лиц в процентах.
<add key="addPersonalComission" value="" />
15 Класс услуги для комиссии

Опциональная настройка.

Класс услуги, добавляемой в путевку при наличии комиссии.
<add key="NewDogovorServiceSvKey" value="1055" />
16 Услуга для комиссии

Опциональная настройка.

Услуга, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии.
<add key="NewDogovorServiceServiceListKey" value="982" />
17 Партнер для комиссии

Опциональная настройка.

Партнер, являющийся поставщиком для услуги, добавляемой в путевку при наличии комиссии.
<add key="NewDogovorServicePartnerKey" value="10760" />
18 Расчеты через MasterFinance

Опциональная настройка.

Указывает, проводятся ли платежи через MasterFinance:
  • true - проводятся
  • false - не проводятся
<add key="AddPaymentsToMasterFinance" value="false" />
19 Система налогообложения

Обязательная настройка.

Указывает, какая система налогообложения будет использоваться при платежах:
  • osn — общая СН
  • usn_income — упрощенная СН (доходы)
  • usn_income_outcome – упрощенная СН (доходы минус расходы)
  • esn – единый сельскохозяйственный налог
  • patent – патентная СН
<add key="TaxationCode" value="osn" />
20 Идентификатор группы ККТ

Обязательная настройка.

Идентификатор группы контрольно-кассовой техники.
<add key="ReceiptGroupCode" value="2ca8430a-ff34-421a-b2aa-2071d79eb782" />
21 Логин для авторизации в сервисе формирования чеков

Обязательная настройка.

Логин для авторизации в сервисе формирования чеков.
<add key="ReceiptLogin" value="7709624788" />
22 Пароль для авторизации в сервисе формирования чеков

Обязательная настройка.

Пароль для авторизации в сервисе формирования чеков.
<add key="ReceiptPassword" value="79161128982" />
23 URL для авторизации в сервисе формирования чеков

Обязательная настройка.

URL для авторизации в сервисе формирования чеков.
<add key="ReceiptAuthUrl" value="https://fiscalization.evotor.ru/possystem/v5/getToken" />
24 Почта для отправки чеков по умолчанию

Опциональная настройка.

Указывается почта, на которую будут приходить чеки, в случае отсутствия их в партнере или представителе партнера
<add key="ReceiptClientDefaultEmail" value="peligrim@mail.ru" />

Assist

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

Описание Значение Настройка
1 Ключ интернет-магазина Ключ магазина, который предоставляет Assist
<add key="shopID" value="326055"/>
2 Логин для авторизации в системе Assist Логин для авторизации, который предоставляет Assist. Необходимо добавить обе настройки.
<add key="shopLogin" value="login"/>
3 Пароль для авторизации в системе Assist Пароль для авторизации, который предоставляет Assist
<add key="shopPassword" value="password"/>
4 Логин для авторизации Логин веб-сервиса, который предоставляет Assist
<add key="webServiceLogin" value=" login "/>
5 Настройка, определяющая пользователя, к которому будет привязываться оплата Ключ пользователя из таблицы [UserList], к которому привязывается оплата
<add key="masterTourUser" value="100006"/>
6 Настройка, определяющая партнера, к которому будет привязываться оплата Ключ партнера из таблицы [tbl_Partners], к которому привязывается оплата
<add key="paymentFilialKey" value="1"/>
7 Настройка, определяющая отдел, к которому будет привязываться оплата Ключ отдела (кассы) из таблицы [PrtDeps], к которому привязывается оплата
<add key="departmentKey" value="2"/>
8 Боевой/тестовый адрес. Откуда получать ответ. Боевой адрес, который предоставляет Assist

либо белорусский тестовый сервис:
https://test.paysec.by/orderstate/orderstate.cfm
либо питерский тестовый сервис:
https://payments.demo.paysecure.ru/orderstate/orderstate.cfm

<add key="assistGetTransaction" value="" />
9 Секретное слово из личного кабинета Секретное слово, которое указывается в личном кабинете в Assist
<add key="salt" value="" />
10 Настройка, определяющая код валюты, в которой будет совершаться платеж через платежную систему Assist Код валюты из таблицы [Rates], в которой будет совершаться платеж
<add key="assistPaymentsRate" value="рб" />
11 Настройка, определяющая тип операции при проведении платежа Ключ операции из таблицы [PaymentOperations]
<add key="paymentOperationId" value="1"/>
12 Настройка, определяющая тип операции при проведении платежа для комиссий. Ключ операции (Поле PO_ID из таблицы [PaymentOperations]).
<add key="paymentOperationCommissionId" value="6" />


13 Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для агентств). Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется запятой).

Комиссия указывается в процентах.
Сумма оплаты вычисляется следующим образом:
Если из конечной суммы платежа в системе «PayOnline» вычесть указанный процент - получится стоимость путевки.
Пример:
Стоимость путевки - 100 у.е.
В настройке указана комиссия - 50%.
Итоговая сумма платежа в системе «Assist» - 200 у.е.
200 у.е. - 50% * 200 у.е. = 100 у.е. (стоимость путевки).

<add key="addAgencyComission" value="3,627" />
14 Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для частных лиц). Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется запятой).

Комиссия указывается в процентах.
Сумма оплаты вычисляется следующим образом:
Если из конечной суммы платежа в системе «Assist» вычесть указанный процент - получится стоимость путевки.
Пример:
Стоимость путевки - 100 у.е.
В настройке указана комиссия - 50%.
Итоговая сумма платежа в системе «PayOnline» - 200 у.е.
200 у.е. - 50% * 200 у.е. = 100 у.е. (стоимость путевки).

<add key="addPersonalComission" value="5" />
15 Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками NewDogovorServiceSvKey и NewDogovorServicePartnerKey. Ключ услуги (Поле SL_KEY из таблицы [ServiceList]).
<add key="NewDogovorServiceServiceListKey" value="450" />
16 Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками NewDogovorServiceServiceListKey и NewDogovorServicePartnerKey. Ключ класса услуги (Поле SV_KEY из таблицы [Service]).
<add key="NewDogovorServiceSvKey" value="1055" />
17 Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками NewDogovorServiceServiceListKey и NewDogovorServiceSvKey. Ключ класса услуги (Поле PR_KEY из таблицы [Partners]).
<add key="NewDogovorServicePartnerKey" value="12921" />
18 Настройка, включающая расчет через Мастер Финанс.
  • false - расчет через Мастер Финанс не включен;
  • true - расчет через Мастер Финанс включен.
<add key="AddPaymentsToMasterFinance" value="false"/>

Webpay

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

Описание Значение Настройка
1 Идентификатор клиента в платежной системе предоставляется Webpay
<add key="storeID" value="344612596"/>
2 Пароль клиента в платежной системе предоставляется Webpay
<add key="privateKey" value="37kfffkvjj"
3 Код платежного агента предоставляется Webpay
<add key="customerID" value="megatec-2" />
4 Настройка, определяющая пользователя, к которому будет привязываться оплата Ключ пользователя из таблицы [UserList], к которому привязывается оплата
<add key="masterTourUser" value="100006"/>
5 Настройка, определяющая партнера, к которому будет привязываться оплата Ключ партнера из таблицы [tbl_Partners], к которому привязывается оплата
<add key="paymentFilialKey" value="1"/>
6 Настройка, определяющая отдел, к которому будет привязываться оплата Ключ отдела (кассы) из таблицы [PrtDeps], к которому привязывается оплата
<add key="departmentKey" value="2"/>
7 Откуда получать ответ. Тестовый адрес: https://sandbox.webpay.by адрес платежного сервиса
<add key="webPayGetTransaction" value="https://securesandbox.webpay.by" />
8 Режим тестирования Режим тестирования - 1, боевой режим - 0
<add key="isTest" value="1" />
9 Настройка, определяющая тип операции при проведении платежа Ключ операции из таблицы [PaymentOperations]
<add key="paymentOperationId" value="1"/>
10 Настройка, определяющая тип операции при проведении платежа для комиссий. Ключ операции (Поле PO_ID из таблицы [PaymentOperations]).
<add key="paymentOperationCommissionId" value="6" />


11 Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для агентств). Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется запятой).

Комиссия указывается в процентах.
Сумма оплаты вычисляется следующим образом:
Если из конечной суммы платежа в системе «PayOnline» вычесть указанный процент - получится стоимость путевки.
Пример:
Стоимость путевки - 100 у.е.
В настройке указана комиссия - 50%.
Итоговая сумма платежа в системе «Assist» - 200 у.е.
200 у.е. - 50% * 200 у.е. = 100 у.е. (стоимость путевки).

<add key="addAgencyComission" value="3,627" />
12 Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для частных лиц). Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется запятой).

Комиссия указывается в процентах.
Сумма оплаты вычисляется следующим образом:
Если из конечной суммы платежа в системе «Assist» вычесть указанный процент - получится стоимость путевки.
Пример:
Стоимость путевки - 100 у.е.
В настройке указана комиссия - 50%.
Итоговая сумма платежа в системе «PayOnline» - 200 у.е.
200 у.е. - 50% * 200 у.е. = 100 у.е. (стоимость путевки).

<add key="addPersonalComission" value="5" />
13 Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками NewDogovorServiceSvKey и NewDogovorServicePartnerKey. Ключ услуги (Поле SL_KEY из таблицы [ServiceList]).
<add key="NewDogovorServiceServiceListKey" value="450" />
14 Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками NewDogovorServiceServiceListKey и NewDogovorServicePartnerKey. Ключ класса услуги (Поле SV_KEY из таблицы [Service]).
<add key="NewDogovorServiceSvKey" value="1055" />
15 Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками NewDogovorServiceServiceListKey и NewDogovorServiceSvKey. Ключ класса услуги (Поле PR_KEY из таблицы [Partners]).
<add key="NewDogovorServicePartnerKey" value="12921" />
16 Настройка, включающая расчет через Мастер Финанс.
  • false - расчет через Мастер Финанс не включен;
  • true - расчет через Мастер Финанс включен.
<add key="AddPaymentsToMasterFinance" value="false"/>


PayOnline

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

Описание Значение Настройка
1 Ключ сайта.

Обязательная настройка.

Merchant ID сайта в системе «PayOnline».
<add key="merchantId" value="2898" />
2 Ключ.

Обязательная настройка.

Security key в Параметрах интеграции сайта в системе «PayOnline».
<add key="privateSecurityKey" value="XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX" />
3 Сопоставление кодов валют из ПК «Мастер-Тур» с кодом валюты в системе «PayOnline». В качестве параметра key указывается код валюты из ПК «Мастер-Тур», в качестве параметра value задается код валюты в системе «PayOnline», например:
   <add key="рб" value="RUB"/>
   <add key="$" value="USD"/>
   <add key="EU" value="EUR"/>
4 Настройка, определяющая код валюты, в которой будет совершаться платеж через платежную систему «PayOnline» при значении DefinedBySettings настройки currencyToPay. Код валюты (Поле RA_CODE из таблицы [Rates]).
<add key="currency" value="рб" />
5 Настройка, определяющая валюту, в которой будет совершаться платеж через систему «PayOnline».

Обязательная настройка.

  • Contract - оплата в валюте путевки;
  • Tour - оплата в валюте тура;
  • National – оплата в национальной валюте;
  • DefinedBySettings - оплата в валюте, определенной настройкой Сurrency.
<add key="currencyToPay" value="Contract" />
6 Настройка, определяющая тип операции при проведении платежа.

Обязательная настройка.

Ключ операции (Поле PO_ID из таблицы [PaymentOperations]).
<add key="kindOfPay" value="6" />
7 Настройка, определяющая пользователя ПК «Мастер-Тур», к которому будет привязываться оплата.

Обязательная настройка.

Ключ пользователя, к которому привязывается оплата (Поле US_KEY из таблицы [UserList]).
<add key="masterTourUser" value="80" />
8 Настройка, определяющая партнера, к которому будет привязываться оплата.

Обязательная настройка.

Ключ филиала, к которому привязывается оплата (Поле PR_KEY из таблицы [Partners]).
<add key="paymentFilialKey" value="1" />
9 Настройка, определяющая отдел, к которому будет привязываться оплата.

Обязательная настройка.

Ключ отдела (кассы), к которому привязывается оплата (Поле PDP_KEY из таблицы [PrtDeps]).
<add key="departmentKey" value="2" />
10 Настройка, определяющая тип операции при проведении платежа Ключ операции из таблицы [PaymentOperations]
<add key="paymentOperationId" value="1"/>
11 Настройка, определяющая тип операции при проведении платежа для комиссий. Ключ операции (Поле PO_ID из таблицы [PaymentOperations]).
<add key="paymentOperationCommissionId" value="6" />
12 Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для агентств).

Обязательная настройка.

Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется запятой).

Комиссия указывается в процентах.
Сумма оплаты вычисляется следующим образом:
Если из конечной суммы платежа в системе «PayOnline» вычесть указанный процент - получится стоимость путевки.
Пример:
Стоимость путевки - 100 у.е.
В настройке указана комиссия - 50%.
Итоговая сумма платежа в системе «PayOnline» - 200 у.е.
200 у.е. - 50% * 200 у.е. = 100 у.е. (стоимость путевки).

<add key="addAgencyComission" value="3,627" />
13 Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для частных лиц).

Обязательная настройка.

Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется запятой).

Комиссия указывается в процентах.
Сумма оплаты вычисляется следующим образом:
Если из конечной суммы платежа в системе «PayOnline» вычесть указанный процент - получится стоимость путевки.
Пример:
Стоимость путевки - 100 у.е.
В настройке указана комиссия - 50%.
Итоговая сумма платежа в системе «PayOnline» - 200 у.е.
200 у.е. - 50% * 200 у.е. = 100 у.е. (стоимость путевки).

<add key="addPersonalComission" value="5" />
14 Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками NewDogovorServiceSvKey и NewDogovorServicePartnerKey. Ключ услуги (Поле SL_KEY из таблицы [ServiceList]).
<add key="NewDogovorServiceServiceListKey" value="450" />
15 Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками NewDogovorServiceServiceListKey и NewDogovorServicePartnerKey. Ключ класса услуги (Поле SV_KEY из таблицы [Service]).
<add key="NewDogovorServiceSvKey" value="1055" />
16 Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками NewDogovorServiceServiceListKey и NewDogovorServiceSvKey. Ключ класса услуги (Поле PR_KEY из таблицы [Partners]).
<add key="NewDogovorServicePartnerKey" value="12921" />
17 Настройка, включающая расчет через Мастер Финанс.
  • false - расчет через Мастер Финанс не включен;
  • true - расчет через Мастер Финанс включен.
<add key="AddPaymentsToMasterFinance" value="false"/>



Сценарии работы

Предполагаются 3 сценария работы:
1. Заданы размеры комиссий и параметры paymentOperationId, paymentOperationComissionId, NewDogovorServiceSvKey, NewDogovorServiceServiceListKey, NewDogovorServicePartnerKey. В этом случае при оплате в базе данных формируется 1 ПКО (сумма за путевку + сумма комиссии), в путевке создается услуга "Комиссия при оплате через платежный шлюз" и сумма путевки увеличивается на размер стоимости созданной услуги.
2. Заданы размеры комиссий и параметры paymentOperationId, paymentOperationComissionId. Параметры NewDogovorServiceSvKey, NewDogovorServiceServiceListKey, NewDogovorServicePartnerKey не заданы. В этом случае при оплате в базе данных формируются 2 ПКО (отдельно за путевку и за комиссию). Услуга в путевке не создается и сумма путевки не меняется.
3. Заданы размеры комиссий и параметр paymentOperationId. Значение параметра paymentOperationComissionId=0 или параметр отсутствует. Оплата за комиссию уходит сразу в банк. В этом случае при оплате в базе данных формируется 1 ПКО за путевку.
Внимание! Данные настройки не работают при включенной настройке <add key="AddPaymentsToMasterFinance" value="true"/>.

Настройка индивидуальных подписей и ссылок для кнопки оплаты

Имеется возможность добавить индивидуальную подпись и ссылку к баннеру платежной системы. Необходимо добавить новые параметры в секции paymentMethods соответствующего способа оплаты:

<add code="17" name="Оплатить с кешбек" logoLink="~/Content/themes/base/images/payCashback.jpg"
header="Оплата тура для участников программы «Кешбэк по карте МИР»"
returnMoneyText = "В последствии можно будет вернуть часть средств"
paymentTermsText = "Условия оплаты туров по программе «Кешбэк по карте МИР»"
paymentTermsLink = "https://payment.webpay.by/"
pair = "1"
maximumAmount="1000000"
skipDescriptionPage="true" paymentSystem="Uniteller" link="https://fpay.uniteller.ru/v2/pay"/>


Описание

  • header - шапка с основным описанием способа оплаты
  • returnMoneyText - дополнительное описание способа оплаты
  • paymentTermsText - текст гиперссылки
  • paymentTermsLink - ссылка на которую происходит переход при нажатии на текст гиперссылки
  • pair - параметр позволяющий связать 2 баннера в пару

В случае, если имеется необходимость в отображении нескольких баннеров с подписями, для корректного отображения на странице рекомендуется их связывать в пары.
Для того, чтобы баннеры отображались рядом необходимо одному присвоить параметр pair = "1", другому - pair = "2" и указать коды данных способов оплат в разделе paymentAvailabilities друг за другом.

Настройка стилей

В папке приложения EntryPoint есть файл Views\Shared\ _Layout.cshtml. В тегах <div> можно разместить информацию в Нeader и Footer. Если Header и Footer не нужны, можно в этом же файле их убрать, удалив теги <div>.

<div id="header">
    Header
  </div>
  . . .
  <div id="footer">
    Footer
  </div>

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

Оплату можно произвести по путевкам, статус которых указан в настройке paymentsStatuses.
Перед использованием приложения EntryPoint необходимо в таблице tbl_Country в поле CN_RateKey проставить ключи национальных валют для стран, в которых зарегистрированы филиалы продающие путевки.

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

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

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

Предупреждение


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


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

Экран «Список заказов»

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

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

Способ оплаты

Предупреждение


Модуль "Выбор платежной системы" доступен только для путевок имеющих статус, ключ которого указан в настройке paymentsStatuses.


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

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

Оплата путевок в экране «Список заказов»

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

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

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

Выбрав способ оплаты, открывается экран оплаты, в котором указывается способ оплаты, ссылка на изменение способа (если их несколько), номер путевки, стоимость путевки к оплате, оплаченная сумма, курс валюты, сумма к оплате с учетом комиссии:

Оплата «Параметры платежа»

Сумму к оплате можно изменить, при этом необходимо учитывать правила оплаты, которые выводятся из файла, путь к которому указан в настройке:

<add key="agreementText" value="templates/AgreementText.htm"/>

При изменении суммы к оплате автоматически высчитывается комиссия.

После нажатия кнопки «Оплатить» определяются параметры для выбранной платежной системы (из соответствующей секции описанной в web.config) и формируется ссылка для передачи параметров платежа платежной системе. Затем осуществляется переход по сформированной ссылке.
Оплата

Возможные ошибки и методы их устранения

Ошибка SecureChannelFailure

Появление такой ошибки может быть вызвано невозможностью установить TLS соединение, которое используется для передачи данных от платежной системы. Вызвано некорректными настройками брандмауэра/firewall или некорректными настройками сервера. В случае обнаружения закрытого канала TLS необходимо обратиться к администратору вашей интернет-сети.

On error occurred during signing in. Contact our manager System.Exception: Some error occured: SecureChannelFailure at Megatec.MasterWeb.PaymentSystem.Tinkoff.TinkoffGateway.Authorization(TinkoffParameters parameters, String token) in C:\Users\vmizh\Work\MasterTour\Source\MW\Megatec.MasterWeb.PaymentSystem.Tinkoff\TinkoffGateway.cs:line 430 at Megatec.MasterWeb.PaymentSystem.Tinkoff.TinkoffGateway.Login(IPaymentParameters parameters) in C:\Users\vmizh\Work\MasterTour\Source\MW\Megatec.MasterWeb.PaymentSystem.Tinkoff\TinkoffGateway.cs:line 106 at MasterWebStandard2.Payment.ParseRequest(String action, String orderCode)

Для проверки доступности TLS соединения необходимо выполнить следующую команду в командной строке или в оболочке Powershell, заменив ссылку на ссылку для необходимой системы оплаты:
Invoke-WebRequest -Uri https://securepay.tinkoff.ru

Вариант успешного ответа при доступном соединении

Invoke-WebRequest : Удаленный сервер возвратил ошибку: (404) Не найден.
строка:1 знак:1
+ Invoke-WebRequest -Uri https://securepay.tinkoff.ru

Вариант некорректного ответа при закрытом соединении

Invoke-WebRequest : The request was aborted: Could not create SSL/TLS secure channel.
At line:1 char:2
+  Invoke-WebRequest -Uri https://securepay.tinkoff.ru

Ошибка конфигурации

Ea 297.png
Проверить наличие символов на строке 67 и в строках ниже файла web.config.

500 Внутренняя ошибка сервера

Ea 298.png
Проверить, что не пропущен символ кавычки " в параметрах файла web.config.

Извините, при обработке запроса произошла ошибка.

Ea 299.png
Проверить, что не допущено ошибок в параметрах секции конкретной платежной системы, по которой происходит оплата, в файле web.config.