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

Материал из Megatec
Перейти к: навигация, поиск
[непроверенная версия][досмотренная версия]
(Uniteller)
(Tinkoff (Т-Банк))
 
(не показаны 54 промежуточные версии 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 />
  
Строка 282: Строка 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>
 
|  
 
|  
Строка 292: Строка 332:
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 6
+
| 7
 
|Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для частных лиц) <br>
 
|Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для частных лиц) <br>
 
|  
 
|  
Строка 303: Строка 343:
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 7
+
| 8
 
| Настройка, определяющая '''пользователя''' ПК «Мастер-Тур», к которому будет '''привязываться оплата'''.
 
| Настройка, определяющая '''пользователя''' ПК «Мастер-Тур», к которому будет '''привязываться оплата'''.
 
Обязательная настройка.
 
Обязательная настройка.
Строка 313: Строка 353:
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 8
+
| 9
 
| Настройка, определяющая '''отдел''', к которому будет '''привязываться оплата'''.
 
| Настройка, определяющая '''отдел''', к которому будет '''привязываться оплата'''.
 
Обязательная настройка.
 
Обязательная настройка.
Строка 323: Строка 363:
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 9
+
| 10
 
| Настройка, включающая расчет через Мастер финанс.
 
| Настройка, включающая расчет через Мастер финанс.
 
|
 
|
Строка 334: Строка 374:
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 10
+
| 11
 
| Настройка, определяющая '''тип операции при проведении платежа'''.
 
| Настройка, определяющая '''тип операции при проведении платежа'''.
 
Обязательная настройка.
 
Обязательная настройка.
Строка 344: Строка 384:
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 11
+
| 12
 
| Настройка, определяющая '''тип операции при проведении платежа для комиссий'''.
 
| Настройка, определяющая '''тип операции при проведении платежа для комиссий'''.
 
| '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).
 
| '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).
Строка 353: Строка 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>).
 
Название услуги комиссии в путевке берется из этого параметра
 
Название услуги комиссии в путевке берется из этого параметра
Строка 364: Строка 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>).
 
Название услуги комиссии в путевке берется из этого параметра
 
Название услуги комиссии в путевке берется из этого параметра
Строка 375: Строка 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">
Строка 385: Строка 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>
 +
|}<br />
 +
=====Формирование чеков Alfabank=====
 +
Настройки для формирования чека задаются в секции <code><Alfabank></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
 +
| '''Система налогообложения'''
 +
| Значения:
 +
  general — общая
 +
  simple_income — упрощенная (доходы)
 +
  simple_profit — упрощенная (доходы минус расходы)
 +
  patent — патентная
 +
  unified_agricultural — единый сельскохозяйственный налог
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="TaxationCode" value="general" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 +
|- style="vertical-align:text-top"
 +
 +
| 2
 +
| '''Ставка НДС'''
 +
| Значения:
 +
  no — без НДС
 +
  0 — 0%
 +
  10 — 10%
 +
  20 — 20%
 +
  10/110 — 10/110
 +
  20/120 — 20/120
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="Tax" value="no" />
 +
</syntaxhighlight>
 
|}<br />
 
|}<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"
 +
 +
| 1
 +
| Идентификатор клиента, который выдается платежной системой Sberbank.
 +
Обязательная настройка.
 +
| '''Идентификатор клиента'''
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="userName" value="логин sberbank-api" />
 +
</syntaxhighlight>
 +
|- style="vertical-align:text-top"
 +
| 2
 +
| Пароль клиента, который выдается платежной системой Sberbank.
 +
Обязательная настройка.
 +
| '''Пароль клиента'''
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<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>
 +
 +
|- style="vertical-align:text-top"
 +
| 4
 +
| Настройка, определяющая '''пользователя''' ПК «Мастер-Тур», к которому будет '''привязываться оплата'''.
 +
Обязательная настройка.
 +
| '''Ключ пользователя''', к которому ''привязывается оплата'' (Поле '''US_KEY''' из таблицы <code>'''[UserList]'''</code>).
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="masterTourUser" value="95" />
 +
</syntaxhighlight>
 +
 +
|- style="vertical-align:text-top"
 +
| 5
 +
| Настройка, позволяющая создавать объект '''orderBundle''' (товарная корзина), в котором передаются все необходимые данные о товаре/услуге.
 +
|
 +
* '''true''' - включено создание объекта '''orderBundle'''
 +
* '''false''' или отсутствие настройки -  объект '''orderBundle''' не создается <br />
 +
По умолчанию настройка имеет значение false.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="useFiscalization" value="false"/>
 +
</syntaxhighlight>
 +
|- style="vertical-align:text-top"
 +
 +
| 6
 +
| Настройка, определяющая '''тип операции при проведении платежа'''.
 +
Обязательная настройка.
 +
| '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="PaymentOperationId" value="1" />
 +
</syntaxhighlight>
 +
 +
|- style="vertical-align:text-top"
 +
 +
| 7
 +
| Настройка, определяющая '''тип операции при проведении платежа для комиссий'''.
 +
| '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).</br>
 +
<br /><font style="color:red">''Внимание!''</font><br />
 +
Если данная настройка не заполнена, то значения настроек '''NewDogovorServiceServiceListKey''', '''NewDogovorServiceSvKey''', '''NewDogovorServicePartnerKey''' обязательно оставить незаполненными.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="paymentOperationCommissionId" value="6" />
 +
</syntaxhighlight>
 +
 +
|- style="vertical-align:text-top"
 +
 +
| 8
 +
| Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для агентств''').<br>
 +
| '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется либо запятой, либо точкой).
 +
Комиссия указывается '''в процентах'''.<br />
 +
По умолчанию комиссия для агентств равна нулю.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="addAgencyComission" value="3.627" />
 +
</syntaxhighlight>
 +
 +
|- style="vertical-align:text-top"
 +
 +
| 9
 +
| Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для частных лиц''').<br>
 +
| '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется либо запятой, либо точкой).
 +
Комиссия указывается '''в процентах'''.<br />
 +
По умолчанию комиссия для частных лиц равна нулю.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="addPersonalComission" value="5.0" />
 +
</syntaxhighlight>
 +
 +
|- style="vertical-align:text-top"
 +
 +
| 10
 +
| Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками ''NewDogovorServiceSvKey'' и ''NewDogovorServicePartnerKey''.
 +
| Ключ услуги (Поле '''SL_KEY''' из таблицы <code>'''[ServiceList]'''</code>).
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="NewDogovorServiceServiceListKey" value="450" />
 +
</syntaxhighlight>
  
==Sberbank==
+
|- style="vertical-align:text-top"
 +
 
 +
| 11
 +
| Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServicePartnerKey''.
 +
| Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>).
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="NewDogovorServiceSvKey" value="1055" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 12
 +
| Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServiceSvKey''.
 +
| Ключ класса услуги (Поле '''PR_KEY''' из таблицы <code>'''[Partners]'''</code>).
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="NewDogovorServicePartnerKey" value="12921" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 13
 +
| Настройка, включающая расчет через Мастер финанс.
 +
|
 +
* '''false''' - расчет через мастер финанс не включен;
 +
* '''true''' - расчет через мастер финанс включен.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="AddPaymentsToMasterFinance" value="false"/>
 +
</syntaxhighlight>
 +
 
 +
|}
 +
<br />
 +
 
 +
====Tinkoff (Т-Банк)====
 +
Настройки задаются в секции <code><paymentMethods></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"
  
Строка 411: Строка 643:
  
 
| 1
 
| 1
| '''Адрес платежной службы'''
+
| '''Платежный метод'''
 
Обязательная настройка.
 
Обязательная настройка.
| Адрес сервиса оплаты через карту банка «Tinkoff».
+
| способ оплаты в платежной системе «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="LoginUrl" value="https://securepay.tinkoff.ru/v2/Init"/>
+
<add code="12" name="Платформа Tinkoff" logoLink="~/Content/logos/logoTinkoff.png"
 +
    maximumAmount="1000000"
 +
    skipDescriptionPage="false" displayWindowWithEditingRequestData="true" paymentSystem="Tinkoff" />
 
</syntaxhighlight>
 
</syntaxhighlight>
 +
|}
 +
<br />
 +
 +
Настройки задаются в секции <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"
 +
 +
! width="2%" | №
 +
! width="28%" | Описание
 +
! width="35%" | Значение
 +
! width="35%" | Настройка
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
Строка 423: Строка 680:
 
| '''Адрес платежной службы'''
 
| '''Адрес платежной службы'''
 
Обязательная настройка.
 
Обязательная настройка.
| Адрес сервиса оплаты через карту банка «Tinkoff».
+
| Адрес сервиса оплаты через карту банка «Tinkoff (Т-Банк)».
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
 
<add key="LoginUrl" value="https://securepay.tinkoff.ru/v2/Init"/>
 
<add key="LoginUrl" value="https://securepay.tinkoff.ru/v2/Init"/>
Строка 433: Строка 690:
 
| '''Адрес для оплаты по QR коду'''
 
| '''Адрес для оплаты по QR коду'''
 
Обязательная настройка.
 
Обязательная настройка.
| Адрес сервиса оплаты через карту банка «Tinkoff» по QR коду.
+
| Адрес сервиса оплаты через карту банка «Tinkoff (Т-Банк)» по QR коду.
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
 
<add key="QRCodeUrl" value="https://securepay.tinkoff.ru/v2/GetQr"/>
 
<add key="QRCodeUrl" value="https://securepay.tinkoff.ru/v2/GetQr"/>
Строка 463: Строка 720:
 
| '''Идентификатор терминала'''
 
| '''Идентификатор терминала'''
 
Обязательная настройка.
 
Обязательная настройка.
| Параметр '''Терминал''' из раздела Терминалы в л/к сервиса «Tinkoff».
+
| Параметр '''Терминал''' из раздела Терминалы в л/к сервиса «Tinkoff (Т-Банк)».
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
 
<add key="TerminalKey" value="1587990738"/>
 
<add key="TerminalKey" value="1587990738"/>
Строка 473: Строка 730:
 
| '''Пароль терминала'''
 
| '''Пароль терминала'''
 
Обязательная настройка.
 
Обязательная настройка.
| Параметр '''Пароль''' из раздела Терминалы в л/к сервиса «Tinkoff».
+
| Параметр '''Пароль''' из раздела Терминалы в л/к сервиса «Tinkoff (Т-Банк)».
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
 
<add key="TerminalPassword" value="cn5du3jxcfbmwtyuii"/>
 
<add key="TerminalPassword" value="cn5du3jxcfbmwtyuii"/>
Строка 481: Строка 738:
  
 
| 7
 
| 7
| Настройка, определяющая '''язык''' окна платежной формы «Tinkoff».
+
| Настройка, определяющая '''язык''' окна платежной формы «Tinkoff (Т-Банк)».
 
Обязательная настройка.
 
Обязательная настройка.
 
|  
 
|  
Строка 607: Строка 864:
 
| 18
 
| 18
 
| Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками ''NewDogovorServiceSvKey'' и ''NewDogovorServicePartnerKey''.
 
| Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками ''NewDogovorServiceSvKey'' и ''NewDogovorServicePartnerKey''.
<span style="color:red">Обрабатывается с релиза 15.8.</span>
 
 
| Ключ услуги (Поле '''SL_KEY''' из таблицы <code>'''[ServiceList]'''</code>).
 
| Ключ услуги (Поле '''SL_KEY''' из таблицы <code>'''[ServiceList]'''</code>).
 
Название услуги комиссии в путевке берется из этого параметра
 
Название услуги комиссии в путевке берется из этого параметра
Строка 618: Строка 874:
 
| 19
 
| 19
 
| Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServicePartnerKey''.
 
| Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServicePartnerKey''.
<span style="color:red">Обрабатывается с релиза 15.8.</span>
 
 
Название услуги комиссии в путевке берется из этого параметра
 
Название услуги комиссии в путевке берется из этого параметра
 
| Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>).
 
| Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>).
Строка 629: Строка 884:
 
| 20
 
| 20
 
| Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''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">
 
<add key="NewDogovorServicePartnerKey" value="12921" />
 
<add key="NewDogovorServicePartnerKey" value="12921" />
 +
</syntaxhighlight>
 +
 +
|- style="vertical-align:text-top"
 +
 +
|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''' – оплата кредита
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="PaymentMethodMain" value="prepayment" />
 +
<add key="PaymentMethodPrepayment" value="full_prepayment" />
 +
<add key="PaymentMethodFull" value="" />
 
</syntaxhighlight>
 
</syntaxhighlight>
 
|}
 
|}
 
<br />
 
<br />
  
==Uniteller==
+
====Uniteller====
Настройки задаются в секции <code><Uniteller></code> файла <code>web.config</code> приложения '''EntryPoint'''.
+
Настройки задаются в секции <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"
 
{| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse"
Строка 923: Строка 1201:
  
 
| 22
 
| 22
 +
| Настройка, включающая расчет через Мастер финанс.
 +
|
 +
* '''false''' - расчет через мастер финанс не включен;
 +
* '''true''' - расчет через мастер финанс включен.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="AddPaymentsToMasterFinance" value="false"/>
 +
</syntaxhighlight>
 +
 +
|- style="vertical-align:text-top"
 +
 +
| 23
 
| Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками ''NewDogovorServiceSvKey'' и ''NewDogovorServicePartnerKey''.
 
| Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками ''NewDogovorServiceSvKey'' и ''NewDogovorServicePartnerKey''.
 
| Ключ услуги (Поле '''SL_KEY''' из таблицы <code>'''[ServiceList]'''</code>).
 
| Ключ услуги (Поле '''SL_KEY''' из таблицы <code>'''[ServiceList]'''</code>).
Строка 931: Строка 1220:
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 23
+
| 24
 
| Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServicePartnerKey''.
 
| Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServicePartnerKey''.
 
| Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>).
 
| Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>).
Строка 940: Строка 1229:
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 24
+
| 25
 
| Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServiceSvKey''.
 
| Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServiceSvKey''.
 
| Ключ класса услуги (Поле '''PR_KEY''' из таблицы <code>'''[Partners]'''</code>).
 
| Ключ класса услуги (Поле '''PR_KEY''' из таблицы <code>'''[Partners]'''</code>).
Строка 949: Строка 1238:
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 24
+
| 26
| Настройка, задающая форму оплаты на шлюзе Unitellere
+
| Настройка, задающая форму оплаты на шлюзе Uniteller
 
| "All" - и карта и СБП, "Card" - только карта, "SBP" - только СБП  
 
| "All" - и карта и СБП, "Card" - только карта, "SBP" - только СБП  
 
Если параметр не указан, или пустой или любой набор символов, то по умолчанию All
 
Если параметр не указан, или пустой или любой набор символов, то по умолчанию All
Строка 959: Строка 1248:
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 25
+
| 27
 
| Тип отображения комиссии платежной системы в фискальном чеке.<br>
 
| Тип отображения комиссии платежной системы в фискальном чеке.<br>
 
   
 
   
|Работает начиная с релиза 15.8 если используется [[Платежные web-сервисы: Выбор платежной системы (оплата картой в личном кабинете)|дополнительный модуль Выбор платежной системы (оплата картой в личном кабинете)]]
+
|0 - увеличивает стоимость позиций по чеку на размер (%) комиссию<br>
0 - увеличивает стоимость позиций по чеку на размер (%) комиссию<br>
 
 
1 - добавляет в чек комиссию отдельной строкой<br>
 
1 - добавляет в чек комиссию отдельной строкой<br>
  
Строка 971: Строка 1259:
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 26
+
| 28
 
| Наименование позиции в чеке для комиссии для <add key="ComissionShowModeInVoucher" value ="1"/>.<br>
 
| Наименование позиции в чеке для комиссии для <add key="ComissionShowModeInVoucher" value ="1"/>.<br>
 
   
 
   
|Работает начиная с релиза 15.8 если используется [[Платежные web-сервисы: Выбор платежной системы (оплата картой в личном кабинете)|дополнительный модуль Выбор платежной системы (оплата картой в личном кабинете)]]
+
|По умолчанию - "Комиссия платежной системы"
По умолчанию - "Комиссия платежной системы"
 
  
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
 
<add key="ComissionTextInVoucher" value ="Юнителлер комиcсия"/>
 
<add key="ComissionTextInVoucher" value ="Юнителлер комиcсия"/>
 
</syntaxhighlight>
 
</syntaxhighlight>
 +
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 27
+
| 29
 
| Вид формирования чека <br>
 
| Вид формирования чека <br>
 
   
 
   
|Работает начиная с релиза 15.8 если используется [[Платежные web-сервисы: Выбор платежной системы (оплата картой в личном кабинете)|дополнительный модуль Выбор платежной системы (оплата картой в личном кабинете)]]
+
|true - разбить по услугам отдельно, </br>
true - разбить по услугам отдельно, </br>
 
 
false - одной строкой из ключа VoucherServiceText</br>
 
false - одной строкой из ключа VoucherServiceText</br>
 
По умолчанию настройка в состоянии false.</br>
 
По умолчанию настройка в состоянии false.</br>
Строка 995: Строка 1282:
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
| 28
+
| 30
 
| Наименование услуги в чеке <br>
 
| Наименование услуги в чеке <br>
 
   
 
   
|Работает начиная с релиза 15.8 если используется [[Платежные web-сервисы: Выбор платежной системы (оплата картой в личном кабинете)|дополнительный модуль Выбор платежной системы (оплата картой в личном кабинете)]]
+
|%dogovor% (не обязательно) - для вставки номера договора.</br>
%dogovor% (не обязательно) - для вставки номера договора.</br>
 
  
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
Строка 1008: Строка 1294:
 
|}
 
|}
 
<br />
 
<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 />
 +
 +
  
===Настройка индивидуальных подписей и ссылок для кнопки оплаты===
+
==Сценарии работы==
Начиная с релиза 15.8 появилась возможность добавить индивидуальную подпись и ссылку к баннеру платежной системы.
+
Предполагаются 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''' соответствующего способа оплаты:
 
Необходимо добавить новые параметры в секции '''paymentMethods''' соответствующего способа оплаты:
 
<syntaxhighlight lang="xml" enclose="div">
 
<syntaxhighlight lang="xml" enclose="div">
Строка 1030: Строка 2212:
 
В случае, если имеется необходимость в отображении нескольких баннеров с подписями, для корректного отображения на странице рекомендуется их связывать в пары.<br />
 
В случае, если имеется необходимость в отображении нескольких баннеров с подписями, для корректного отображения на странице рекомендуется их связывать в пары.<br />
 
Для того, чтобы баннеры отображались рядом необходимо одному присвоить параметр pair = "1", другому - pair = "2" и указать коды данных способов оплат в разделе '''paymentAvailabilities''' друг за другом.<br />
 
Для того, чтобы баннеры отображались рядом необходимо одному присвоить параметр pair = "1", другому - pair = "2" и указать коды данных способов оплат в разделе '''paymentAvailabilities''' друг за другом.<br />
<br>[[Файл: Ea_106.png|Способы оплаты]]<br/>
 
  
===Настройка стилей===
+
==Настройка стилей==
 
В папке приложения '''EntryPoint''' есть файл ''Views\Shared\'' '''_Layout.cshtml'''.
 
В папке приложения '''EntryPoint''' есть файл ''Views\Shared\'' '''_Layout.cshtml'''.
 
В тегах <nowiki><div></nowiki> можно разместить информацию в '''Нeader''' и '''Footer'''. Если Header и Footer не нужны, можно в этом же файле их убрать, удалив теги <nowiki><div></nowiki>.
 
В тегах <nowiki><div></nowiki> можно разместить информацию в '''Нeader''' и '''Footer'''. Если Header и Footer не нужны, можно в этом же файле их убрать, удалив теги <nowiki><div></nowiki>.
Строка 1089: Строка 2270:
 
<br />
 
<br />
  
Для выбора способа оплаты необходимо нажать ссылку '''Оплатить''' для нужной путевки (или кнопку '''Оплатить on-line''' в экране '''Информация о заказе'''), после чего пользователь попадает в экран, в котором указывается '''номер заказа''' и  '''способы оплаты'''.
+
Для выбора способа оплаты необходимо нажать ссылку '''Оплатить''' для нужной путевки (или кнопку '''Оплатить on-line''' в экране '''Информация о заказе'''), после чего пользователь попадает в экран, в котором указывается '''номер заказа''' и  '''доступные способы оплаты'''.<br />
 
+
[[Файл: ea_257.png|x500px]]<br />
[[Файл: ep_025.png|x500px|Оплата «Способ оплаты»]]<br />
 
 
<br />
 
<br />
 
 
Выбрав способ оплаты, открывается экран оплаты, в котором указывается способ оплаты, ссылка на изменение способа (если их несколько), номер путевки, стоимость путевки к оплате, оплаченная сумма, курс валюты, сумма к оплате с учетом комиссии:
 
Выбрав способ оплаты, открывается экран оплаты, в котором указывается способ оплаты, ссылка на изменение способа (если их несколько), номер путевки, стоимость путевки к оплате, оплаченная сумма, курс валюты, сумма к оплате с учетом комиссии:
  
Строка 1100: Строка 2279:
  
 
Сумму к оплате можно изменить, при этом необходимо учитывать правила оплаты, которые выводятся из файла, путь к которому указан в настройке:
 
Сумму к оплате можно изменить, при этом необходимо учитывать правила оплаты, которые выводятся из файла, путь к которому указан в настройке:
 
 
  <add key="agreementText" value="templates/AgreementText.htm"/>
 
  <add key="agreementText" value="templates/AgreementText.htm"/>
  
Строка 1106: Строка 2284:
  
 
После нажатия кнопки «Оплатить» определяются параметры для выбранной платежной системы (из соответствующей секции описанной в web.config) и формируется ссылка для передачи параметров платежа платежной системе. Затем осуществляется переход по сформированной ссылке.<br />
 
После нажатия кнопки «Оплатить» определяются параметры для выбранной платежной системы (из соответствующей секции описанной в web.config) и формируется ссылка для передачи параметров платежа платежной системе. Затем осуществляется переход по сформированной ссылке.<br />
Параметры и способ формирования ссылки к платежной системе определены в отдельном классе для каждой платежной системы, при необходимости можно добавить новые платежные системы.<br />
+
[[Файл:Ag 111.png|x1000px|Оплата]]<br />
Путевки, оплаченные с использованием модуля '''Выбор платежной системы''', в системе Мастер-Тур как оплаченные не помечаются. Данный функционал находится в разработке.<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)
 +
 
 +
<font style="color:red">''Для проверки доступности TLS соединения необходимо выполнить следующую команду в командной строке или в оболочке Powershell, заменив ссылку на ссылку для необходимой системы оплаты:''</font><br />
 +
'''Invoke-WebRequest -Uri https://securepay.tinkoff.ru'''<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
 +
 
 +
====Ошибка конфигурации====
 +
[[Файл: ea_297.png]]<br />
 +
<font style="color:red">''Проверить наличие символов на строке 67 и в строках ниже файла web.config.''</font><br />
 +
 
 +
====500 Внутренняя ошибка сервера====
 +
[[Файл: ea_298.png]]<br />
 +
<font style="color:red">''Проверить, что не пропущен символ кавычки " в параметрах файла web.config.''</font><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.