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

Материал из Megatec
Перейти к: навигация, поиск
[досмотренная версия][досмотренная версия]
(→‎Tinkoff)
(→‎Sberbank)
 
(не показаны 33 промежуточные версии 4 участников)
Строка 6: Строка 6:
 
* Alfabank
 
* Alfabank
 
* Sberbank
 
* Sberbank
−
* Tinkoff
+
* Tinkoff (Т-Банк)
 
* Uniteller
 
* Uniteller
 +
* YandexPay
 
* Assist
 
* Assist
 
* WebPay
 
* WebPay
Строка 135: Строка 136:
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
 +
|}
 +
 +
===Настройки логирования===
 +
Настройки секции <code><loggerSection></code> файла <code>web.config</code> модуля EntryPoint.
 +
{| 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
 +
|Логирование <br>
 +
|
 +
Путь к лог-файлам задается в секции ''Loggers path''.
 +
* ExceptionLogger – информация об ошибках
 +
* MasterWeb – общая информация при работе с системой
 +
* DetailEPLoger – пошаговое отслеживание работы платежной системы (работаем через EP). Сейчас реализован только для Юнителлера, при необходимости можно расширять и на другие платежные системы. Удобно использовать для тестирования и проверки платежной системы на стороне клиента.
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<Loggers path="Logs\">
 +
<Logger level="ALL" name="ExceptionLogger" />
 +
<Logger level="ALL" name="MasterWeb" />
 +
<Logger level="OFF" name="DetailEPLoger" />
 +
</Loggers>
 +
</syntaxhighlight>
 
|}
 
|}
  
Строка 210: Строка 240:
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
 +
| 7
 +
| Настройка способа учёта типов тура из <code>&lt;paymentAvailabilities&gt;</code> (атрибут <code>tourTypes</code>) при определении доступности оплаты. Если <code>value="true"</code>, оплата доступна только когда у тура присутствуют все типы, указанные в <code>tourTypes</code>. Если <code>false</code> или настройка отсутствует – оплата доступна, когда у тура есть хотя бы один тип из <code>tourTypes</code>.
 +
| '''false''' или '''отсутствие настройки''' – оплата доступна при наличии хотя бы одного типа из <code>tourTypes</code>;<br>
 +
'''true''' – оплата доступна только при наличии всех типов из <code>tourTypes</code>.
 +
| <syntaxhighlight lang="xml" enclose="div">
 +
<add key="allowPaymentIfAllTypeAllowed" value="true" />
 +
</syntaxhighlight>
 
|}
 
|}
  
Строка 242: Строка 279:
 
  </paymentAvailabilities>
 
  </paymentAvailabilities>
  
−
* '''code''' - идентификатор доступности способа оплаты, должен быть уникальным;
+
* '''code''' – идентификатор доступности способа оплаты, должен быть уникальным;
−
* '''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''' – приоритет при выборе нескольких доступных вариантов оплаты;
−
* '''tourTypes''' - ограничение доступности метода оплаты по ключу типа тура (''tp_key'' из таблицы ''TipTur''). Отсутствие параметра или пустой параметр - оплата доступна для всех типов туров.
+
* '''tourTypes''' – ограничение доступности метода оплаты по ключу типа тура (''tp_key'' из таблицы ''TipTur''). Отсутствие параметра или пустой параметр – оплата доступна для всех типов туров (допускается внесение нескольких параметров через ","). Если требуется оплата с типом тура ''Индивидуально'', то в настройку необходимо добавить ключ ''0''
  
 
===Настройки подключения и параметров используемых платежных систем модуля EntryPoint===
 
===Настройки подключения и параметров используемых платежных систем модуля EntryPoint===
Строка 311: Строка 348:
  
 
| 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>
 +
Для корректной работы настройки – в путевке должно быть выбрано лицо, заключающее договор (представитель агентства).
 
|  
 
|  
 
Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется  запятой).
 
Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется  запятой).
Строка 321: Строка 369:
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
−
| 6
+
| 7
 
|Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для частных лиц) <br>
 
|Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для частных лиц) <br>
 
|  
 
|  
Строка 332: Строка 380:
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
−
| 7
+
| 8
 
| Настройка, определяющая '''пользователя''' ПК «Мастер-Тур», к которому будет '''привязываться оплата'''.
 
| Настройка, определяющая '''пользователя''' ПК «Мастер-Тур», к которому будет '''привязываться оплата'''.
 
Обязательная настройка.
 
Обязательная настройка.
Строка 342: Строка 390:
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
−
| 8
+
| 9
 
| Настройка, определяющая '''отдел''', к которому будет '''привязываться оплата'''.
 
| Настройка, определяющая '''отдел''', к которому будет '''привязываться оплата'''.
 
Обязательная настройка.
 
Обязательная настройка.
Строка 352: Строка 400:
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
−
| 9
+
| 10
 
| Настройка, включающая расчет через Мастер финанс.
 
| Настройка, включающая расчет через Мастер финанс.
 
|
 
|
Строка 363: Строка 411:
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
−
| 10
+
| 11
 
| Настройка, определяющая '''тип операции при проведении платежа'''.
 
| Настройка, определяющая '''тип операции при проведении платежа'''.
 
Обязательная настройка.
 
Обязательная настройка.
Строка 373: Строка 421:
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
−
| 11
+
| 12
 
| Настройка, определяющая '''тип операции при проведении платежа для комиссий'''.
 
| Настройка, определяющая '''тип операции при проведении платежа для комиссий'''.
 
| '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).
 
| '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).
Строка 382: Строка 430:
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
−
| 12
+
| 13
 
| Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками ''NewDogovorServiceSvKey'' и ''NewDogovorServicePartnerKey''.
 
| Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками ''NewDogovorServiceSvKey'' и ''NewDogovorServicePartnerKey''.
 
| Ключ услуги (Поле '''SL_KEY''' из таблицы <code>'''[ServiceList]'''</code>).
 
| Ключ услуги (Поле '''SL_KEY''' из таблицы <code>'''[ServiceList]'''</code>).
Строка 392: Строка 440:
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
−
| 13
+
| 14
 
| Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServicePartnerKey''.
 
| Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServicePartnerKey''.
 
| Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>).
 
| Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>).
Строка 402: Строка 450:
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
−
| 14
+
| 15
 
| Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServiceSvKey''.
 
| Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServiceSvKey''.
 
| Ключ класса услуги (Поле '''PR_KEY''' из таблицы <code>'''[Partners]'''</code>).
 
| Ключ класса услуги (Поле '''PR_KEY''' из таблицы <code>'''[Partners]'''</code>).
Строка 411: Строка 459:
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
−
| 15
+
| 16
 
| Настройка, определяющая '''адрес электронной почты по умолчанию'''.  
 
| Настройка, определяющая '''адрес электронной почты по умолчанию'''.  
 
|Используется в том случае, если не указан адрес электронной почты главного туриста.
 
|Используется в том случае, если не указан адрес электронной почты главного туриста.
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
 
<add key="defaultEmail" value="" />
 
<add key="defaultEmail" value="" />
−
 
 
</syntaxhighlight>
 
</syntaxhighlight>
−
 
 
|}<br />
 
|}<br />
−
 
+
=====Формирование чеков Alfabank=====
−
====Sberbank====
+
Настройки для формирования чека задаются в секции <code><Alfabank></code> файла <code>web.config</code> приложения '''EntryPoint'''.<br />
−
Настройки задаются в секции <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"
 
{| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse"
  
Строка 436: Строка 481:
  
 
| 1
 
| 1
−
| Идентификатор клиента, который выдается платежной системой Sberbank.
+
| '''Система налогообложения'''  
−
Обязательная настройка.
+
| Значения:
−
| '''Идентификатор клиента'''  
+
  general — общая
 +
  simple_income — упрощенная (доходы)
 +
  simple_profit — упрощенная (доходы минус расходы)
 +
  patent — патентная
 +
  unified_agricultural — единый сельскохозяйственный налог
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
−
<add key="userName" value="логин sberbank-api" />
+
<add key="TaxationCode" value="general" />
 
</syntaxhighlight>
 
</syntaxhighlight>
 +
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
 +
 
| 2
 
| 2
−
| Пароль клиента, который выдается платежной системой Sberbank.
+
| '''Ставка НДС'''
−
Обязательная настройка.
+
| Значения:
−
| '''Пароль клиента'''  
+
  no — без НДС
 +
  0 — 0%
 +
  10 — 10%
 +
  20 — 20%
 +
  10/110 — 10/110
 +
  20/120 — 20/120
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
−
<add key="password" value="пароль sberbank-api" />
+
<add key="Tax" value="no" />
 
</syntaxhighlight>
 
</syntaxhighlight>
 +
|}<br />
 +
Обратите внимание, что для каждой услуги отправляется на уровне кода:</br>
 +
* typename - ServiceType согласно ключу SvKey, нигде в чеке не фигурирует;</br>
 +
* number - ключ услуги в БД;</br>
 +
* quantity - 1(услуга);</br>
 +
* name - "Туристическая услуга по путевке {код договора}";</br>
 +
* amount - сумма оплаты по услуге и валюта;</br>
 +
* taxation_item_settlement_method - "full_prepayment";</br>
 +
* taxation_item_type - "service";</br>
 +
* taxation_system - "general" по умолчанию, если не указано иное в конфиге;</br>
 +
* taxes - налог, где</br>
 +
** amount - вычисляется согласно выбранной системе расчета налога и валюта;</br>
 +
** percentage - "no" по умолчанию, иначе - из конфига "20/120" и т.д.;</br>
 +
** type - "vat";</br>
 +
** source - "shop"</br>
 +
 +
[[Файл: mb_030.png|left|Предупреждение]] <BR> Обратите внимание, что для корректной записи платежей в Мастер Тур, необходимо настроить автоматическое подтверждение платежа. Для этого необходимо обратиться в техподдержку Альфа-Банка.
 +
Существует возможность также подтверждать платежи вручную. Подробнее можно ознакомиться тут https://ecom.alfabank.ru/assets/instructions/merchantManual/pages/index/general_description.html#koordinati_podkljuchenija  или запросить информацию в технической поддержке Альфа-Банка<br />
 +
 +
====Sberbank====
 +
Настройки задаются в секции <code><Sberbank></code> файла <code>web.config</code> приложения '''EntryPoint'''. При использовании SberbankMir или SberbankMir необходимо заполнить соответствующие секции в файле <code>web.config</code>.
 +
<br /><br />
 +
 +
Также поддерживается прием оплат через платежную систему '''Юкасса''' с использованием '''API Сбербанка'''.
 +
В данном случае клиент подключает в Юкасса возможность работы по API Сбербанка, после чего Юкасса выдает:
 +
* '''логин'''
 +
* '''пароль'''
 +
* '''ссылку на платежный шлюз'''
 +
 +
При использовании Юкасса по API Сбербанка необходимо указать в настройках секции <code><Sberbank></code> логин и пароль, выданные Юкасса, а также заменить ссылку на платежный шлюз на предоставленную Юкасса.
 +
<br /><br />
 +
 +
{| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse"
 +
 +
|- style="background-color:#F2F2F2"
 +
 +
! width="2%" | №
 +
! width="28%" | Описание
 +
! width="35%" | Значение
 +
! width="35%" | Настройка
 +
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
−
| 3
+
 
−
| Ссылка на платежный шлюз Sberbank
+
| 1
−
|Аналогично настройке link в секции Sberbank в разделе<paymentMethods>
+
| Идентификатор клиента, который выдается платежной системой Sberbank.<br /><br />
 +
При использовании '''Юкасса по API Сбербанка''' используется логин, выданный Юкасса.<br />
 +
Обязательная настройка.
 +
| '''Идентификатор клиента'''
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
−
<add key="sberbankPaymentApplicationUrl" value="https://securepayments.sberbank.ru/payment/rest/" />
+
<add key="userName" value="логин sberbank-api" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
−
| 4
+
| 2
−
| Настройка, определяющая '''пользователя''' ПК «Мастер-Тур», к которому будет '''привязываться оплата'''.
+
| Пароль клиента, который выдается платежной системой Sberbank.<br /><br />
 +
При использовании '''Юкасса по API Сбербанка''' используется пароль, выданный Юкасса.<br />
 
Обязательная настройка.
 
Обязательная настройка.
−
| '''Ключ пользователя''', к которому ''привязывается оплата'' (Поле '''US_KEY''' из таблицы <code>'''[UserList]'''</code>).
+
| '''Пароль клиента'''  
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
−
<add key="masterTourUser" value="95" />
+
<add key="password" value="пароль sberbank-api" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
| 3
 +
| Ссылка на платежный шлюз Sberbank.<br /><br />
 +
Также поддерживается прием оплат через '''Юкасса''' по '''API Сбербанка'''. В этом случае необходимо указать ссылку на шлюз, предоставленную Юкасса.
 +
|Аналогично настройке link в секции Sberbank в разделе<paymentMethods><br /><br />
 +
Пример ссылки, предоставляемой Юкасса:<br />
 +
<code>https://3dsec-payments.yookassa.ru/payment/rest/</code>
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="sberbankPaymentApplicationUrl" value="https://securepayments.sberbank.ru/payment/rest/" />
 +
</syntaxhighlight>
 +
<br />
 +
<syntaxhighlight lang="xml" enclose="div">
 +
<add key="sberbankPaymentApplicationUrl" value="https://3dsec-payments.yookassa.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>
 
</syntaxhighlight>
  
Строка 477: Строка 602:
 
<add key="useFiscalization" value="false"/>
 
<add key="useFiscalization" value="false"/>
 
</syntaxhighlight>
 
</syntaxhighlight>
 +
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
−
 
 
| 6
 
| 6
 
| Настройка, определяющая '''тип операции при проведении платежа'''.
 
| Настройка, определяющая '''тип операции при проведении платежа'''.
Строка 488: Строка 613:
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
−
 
 
| 7
 
| 7
 
| Настройка, определяющая '''тип операции при проведении платежа для комиссий'''.
 
| Настройка, определяющая '''тип операции при проведении платежа для комиссий'''.
−
| '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).
+
| '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).</br>
 +
<br /><font style="color:red">''Внимание!''</font><br />
 +
Если данная настройка не заполнена, то значения настроек '''NewDogovorServiceServiceListKey''', '''NewDogovorServiceSvKey''', '''NewDogovorServicePartnerKey''' обязательно оставить незаполненными.
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
 
<add key="paymentOperationCommissionId" value="6" />
 
<add key="paymentOperationCommissionId" value="6" />
Строка 497: Строка 623:
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
−
 
 
| 8
 
| 8
 
| Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для агентств''').<br>
 
| Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для агентств''').<br>
 +
Для корректной работы настройки – в путевке должно быть выбрано лицо, заключающее договор (представитель агентства).
 
| '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется либо запятой, либо точкой).
 
| '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется либо запятой, либо точкой).
 
Комиссия указывается '''в процентах'''.<br />
 
Комиссия указывается '''в процентах'''.<br />
Строка 508: Строка 634:
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
−
 
 
| 9
 
| 9
 
| Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для частных лиц''').<br>
 
| Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для частных лиц''').<br>
Строка 519: Строка 644:
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
−
 
 
| 10
 
| 10
 
| Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками ''NewDogovorServiceSvKey'' и ''NewDogovorServicePartnerKey''.
 
| Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками ''NewDogovorServiceSvKey'' и ''NewDogovorServicePartnerKey''.
Строка 528: Строка 652:
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
−
 
 
| 11
 
| 11
 
| Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServicePartnerKey''.
 
| Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServicePartnerKey''.
Строка 537: Строка 660:
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
−
 
 
| 12
 
| 12
 
| Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServiceSvKey''.
 
| Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServiceSvKey''.
Строка 546: Строка 668:
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
−
 
 
| 13
 
| 13
 
| Настройка, включающая расчет через Мастер финанс.
 
| Настройка, включающая расчет через Мастер финанс.
Строка 559: Строка 680:
 
<br />
 
<br />
  
−
====Tinkoff====
+
====Tinkoff (Т-Банк)====
−
Настройки задаются в секции <code><Tinkoff></code> файла <code>web.config</code> приложения '''EntryPoint'''.<br />
+
Настройки задаются в секции <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
 +
| '''Платежный метод'''
 +
Обязательная настройка.
 +
| способ оплаты в платежной системе «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">
 +
<add code="12" name="Платформа Tinkoff" logoLink="~/Content/logos/logoTinkoff.png"
 +
    maximumAmount="1000000"
 +
    skipDescriptionPage="false" displayWindowWithEditingRequestData="true" paymentSystem="Tinkoff" />
 +
</syntaxhighlight>
 +
|}
 +
<br />
 +
 
 +
Настройки задаются в секции <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"
  
Строка 575: Строка 732:
 
| '''Адрес платежной службы'''
 
| '''Адрес платежной службы'''
 
Обязательная настройка.
 
Обязательная настройка.
−
| Адрес сервиса оплаты через карту банка «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"/>
Строка 585: Строка 742:
 
| '''Адрес для оплаты по 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"/>
Строка 615: Строка 772:
 
| '''Идентификатор терминала'''
 
| '''Идентификатор терминала'''
 
Обязательная настройка.
 
Обязательная настройка.
−
| Параметр '''Терминал''' из раздела Терминалы в л/к сервиса «Tinkoff».
+
| Параметр '''Терминал''' из раздела Терминалы в л/к сервиса «Tinkoff (Т-Банк)».
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
 
<add key="TerminalKey" value="1587990738"/>
 
<add key="TerminalKey" value="1587990738"/>
Строка 625: Строка 782:
 
| '''Пароль терминала'''
 
| '''Пароль терминала'''
 
Обязательная настройка.
 
Обязательная настройка.
−
| Параметр '''Пароль''' из раздела Терминалы в л/к сервиса «Tinkoff».
+
| Параметр '''Пароль''' из раздела Терминалы в л/к сервиса «Tinkoff (Т-Банк)».
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
 
<add key="TerminalPassword" value="cn5du3jxcfbmwtyuii"/>
 
<add key="TerminalPassword" value="cn5du3jxcfbmwtyuii"/>
Строка 633: Строка 790:
  
 
| 7
 
| 7
−
| Настройка, определяющая '''язык''' окна платежной формы «Tinkoff».
+
| Настройка, определяющая '''язык''' окна платежной формы «Tinkoff (Т-Банк)».
 
Обязательная настройка.
 
Обязательная настройка.
 
|  
 
|  
Строка 726: Строка 883:
 
| 15
 
| 15
 
|Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для агентств) <br>
 
|Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для агентств) <br>
 +
Для корректной работы настройки – в путевке должно быть выбрано лицо, заключающее договор (представитель агентства).
 
|  
 
|  
 
Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется  запятой).
 
Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется  запятой).
Строка 782: Строка 940:
 
|<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>
 
|}
 
|}
Строка 986: Строка 1168:
  
 
|  
 
|  
−
* '''-1''' – не облагается НДС
+
*-1 – не облагается НДС
−
* '''0''' – облагается НДС по ставке 0%
+
*0 – облагается НДС по ставке 0%
−
* '''10''' – облагается НДС по ставке 10%
+
*5 - облагается НДС по ставке 5%
−
* '''18''' – облагается НДС по ставке 18%
+
*7 - облагается НДС по ставке 7%
−
* '''110''' – облагается НДС по ставке 10/110
+
*10 – облагается НДС по ставке 10%
−
* '''118''' – облагается НДС по ставке 18/118
+
*20 – облагается НДС по ставке 20%
 +
*105 – облагается НДС по ставке 5/105
 +
*107 – облагается НДС по ставке 7/107
 +
*110 – облагается НДС по ставке 10/110
 +
*120 – облагается НДС по ставке 20/120
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
 
<add key="TaxRateCode" value=""/>
 
<add key="TaxRateCode" value=""/>
Строка 1039: Строка 1225:
 
| 20
 
| 20
 
| Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для агентств''').
 
| Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для агентств''').
 +
Для корректной работы настройки – в путевке должно быть выбрано лицо, заключающее договор (представитель агентства).
 
| '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется запятой).
 
| '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется запятой).
 
Комиссия указывается '''в процентах'''.<br />
 
Комиссия указывается '''в процентах'''.<br />
Строка 1163: Строка 1350:
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
  
 +
| 31
 +
| Типы договоров поставщиков, для которых необходимо указывать данные поставщика в фискальном чеке.<br>
 +
Работает совместно с настройкой '''VoucherShowDetails'''.<br><br>
 +
* Если VoucherShowDetails = true и типы договоров не указаны — в чеке будет просто список услуг.<br>
 +
* Если VoucherShowDetails = true и типы договоров указаны, и в путёвке есть услуги с поставщиком указанного типа — в чеке по этим услугам будет указана информация о поставщике.<br>
 +
* Если VoucherShowDetails = false — настройка не используется.
 +
| Список типов договоров, перечисленных через запятую.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="SendDetailPartnerByDogovorTypes" value=""/>
 +
</syntaxhighlight>
 +
 +
|- style="vertical-align:text-top"
 +
 +
| 32
 +
| Код ставки налогообложения для поставщиков, типы договоров которых указаны в настройке '''SendDetailPartnerByDogovorTypes'''.<br>
 +
Если не указан — используется значение общей настройки '''TaxRateCode'''.<br>
 +
Допустимые значения:<br>
 +
* -1 – не облагается НДС<br>
 +
* 0 – ставка 0%<br>
 +
* 5 – ставка 5%<br>
 +
* 7 – ставка 7%<br>
 +
* 10 – ставка 10%<br>
 +
* 20 – ставка 20%<br>
 +
* 105 – 5/105<br>
 +
* 107 – 7/107<br>
 +
* 110 – 10/110<br>
 +
* 120 – 20/120
 +
| Код ставки НДС.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="TaxRateCodePartner" value="20" />
 +
</syntaxhighlight>
 
|}
 
|}
 
<br />
 
<br />
Строка 1221: Строка 1439:
 
* Для интерфейсов версии 2.0 изменен формат фискального чека.</br>
 
* Для интерфейсов версии 2.0 изменен формат фискального чека.</br>
  
−
====Assist====
+
====Uniteller для юридических лиц====
−
Настройки задаются в секции <code><Assist></code> файла <code>web.config</code> приложения '''EntryPoint'''.
+
Настройки задаются в секции <code><UnitellerPerson></code> файла <code>web.config</code> приложения '''EntryPoint'''.
−
<br /><br />
+
 
 +
При использовании платёжной системы для юридических лиц — Платформа Юнителлер для юридических лиц, добавляется соответствующий paymentMethod, paymentAvailability, configSection, а также настройки в секции <code><UnitellerPerson></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"
  
 
|- style="background-color:#F2F2F2"
 
|- style="background-color:#F2F2F2"
−
 
 
! width="2%" | №
 
! width="2%" | №
 
! width="28%" | Описание
 
! width="28%" | Описание
Строка 1234: Строка 1453:
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
 +
 
| 1
 
| 1
−
| Ключ интернет-магазина
+
| '''Точки продажи''' ('''shopIDP''')
−
| '''Ключ магазина''', который предоставляет Assist
+
Обязательная настройка.
−
| <syntaxhighlight lang="xml" enclose="div">
+
| '''Uniteller Point ID''' из раздела Точки продажи ЛК «Uniteller».
−
<add key="shopID" value="326055"/>
+
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="shopIDP" value="00005432"/>
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
 +
 
| 2
 
| 2
−
| Логин для авторизации в системе Assist
+
| '''Логин'''
−
| '''Логин''' для авторизации, который предоставляет Assist. Необходимо добавить обе настройки.
+
Обязательная настройка.
−
| <syntaxhighlight lang="xml" enclose="div">
+
| '''Login''' из раздела Параметры авторизации ЛК «Uniteller».
−
<add key="shopLogin" value="login"/>
+
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="login" value="2281" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
 +
 
| 3
 
| 3
−
| Пароль для авторизации в системе Assist
+
| '''Пароль'''
−
| '''Пароль''' для авторизации, который предоставляет Assist
+
Обязательная настройка.
−
| <syntaxhighlight lang="xml" enclose="div">
+
| '''Password''' из раздела Параметры авторизации ЛК «Uniteller».
−
<add key="shopPassword" value="password"/>
+
|<syntaxhighlight lang="xml" enclose="div">
−
</syntaxhighlight>
+
<add key="password" value="XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX" />
−
 
+
</syntaxhighlight>
−
|- style="vertical-align:text-top"
+
 
−
| 4
+
|- style="vertical-align:text-top"
−
| Логин для авторизации
+
 
−
| '''Логин''' веб-сервиса, который предоставляет Assist
+
| 4
−
| <syntaxhighlight lang="xml" enclose="div">
+
| Платёжная система кредитной карты.
−
<add key="webServiceLogin" value=" login "/>
+
|
−
</syntaxhighlight>
+
 
−
 
+
*'''0''' или '''отсутствует значение''' - любая
−
|- style="vertical-align:text-top"
+
*'''Any''' или пустое значение - любая
−
| 5
+
*'''VISA''' - VISA
−
| Настройка, определяющая пользователя, к которому будет привязываться оплата
+
*'''MasterCard''' - MasterCard
−
| '''Ключ пользователя''' из таблицы '''[UserList]''', к которому привязывается оплата
+
*'''DinersClub''' - Diners Club
−
| <syntaxhighlight lang="xml" enclose="div">
+
*'''JCB''' - JCB
−
<add key="masterTourUser" value="100006"/>
+
*'''AmericanExpress''' - American Express
−
</syntaxhighlight>
+
|<syntaxhighlight lang="xml" enclose="div">
−
 
+
 
−
|- style="vertical-align:text-top"
+
<add key="meanType" value="" />
−
| 6
+
</syntaxhighlight>
−
| Настройка, определяющая партнера, к которому будет привязываться оплата
+
|- style="vertical-align:text-top"
−
| '''Ключ партнера''' из таблицы '''[tbl_Partners]''', к которому привязывается оплата
+
 
−
| <syntaxhighlight lang="xml" enclose="div">
+
| 5
−
<add key="paymentFilialKey" value="1"/>
+
| Тип электронной валюты.
−
</syntaxhighlight>
+
|
−
 
+
 
−
|- style="vertical-align:text-top"
+
*'''Any''' или пустое значение - любая система электронных платежей
−
| 7
+
*'''YandexMoney''' - Яндекс.Деньги
−
| Настройка, определяющая отдел, к которому будет привязываться оплата
+
*'''RBKMoney''' - RBK Money
−
| '''Ключ отдела (кассы)''' из таблицы '''[PrtDeps]''', к которому привязывается оплата
+
*'''MoneyMail''' - MoneyMail
−
| <syntaxhighlight lang="xml" enclose="div">
+
*'''WebCreds''' - WebCreds
−
<add key="departmentKey" value="2"/>
+
*'''PlatezhRu''' - Platezh.ru
−
</syntaxhighlight>
+
*'''MailRuMoney''' - Деньги@Mail.Ru
 +
*'''MobileMegafon''' - Мобильный платёж Мегафон
 +
*'''MobileMTS''' - Мобильный платёж МТС
 +
*'''MobileBeeline''' - Мобильный платёж Билайн
 +
*'''EuroSet''' - Евросеть
 +
*'''QIWI''' - QIWI Кошелек
 +
*'''WebMonewWMR''' - WebMoney WMR
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
 
 +
<add key="eMoneyType" value="" />
 +
</syntaxhighlight>
 +
|- style="vertical-align:text-top"
 +
 
 +
| 6
 +
| Таймаут между попытками запроса результата (в миллисекундах).
 +
| По умолчанию 100.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="requestTimeout" value="100" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 7
 +
| Количество попыток запроса результата.
 +
| По умолчанию 5.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="requestAttempts" value="5" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 8
 +
| Настройка, определяющая '''пользователя''' ПК «Мастер-Тур», к которому будет '''привязываться оплата'''.
 +
Обязательная настройка.
 +
| '''Ключ пользователя''', к которому привязывается оплата (Поле '''US_KEY''' из таблицы <code>'''[UserList]'''</code>).
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="masterTourUser" value="80" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 9
 +
| Настройка, определяющая '''филиал''' (партнера), к которому будет '''привязываться оплата'''.
 +
Обязательная настройка.
 +
| '''Ключ филиала''', к которому привязывается оплата (Поле '''PR_KEY''' из таблицы <code>'''[Partners]'''</code>).
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="filialKey" value="1" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 10
 +
| Настройка, определяющая '''отдел''' (кассу), к которому будет '''привязываться оплата'''.
 +
Обязательная настройка.
 +
| '''Ключ отдела''' (кассы), к которому привязывается оплата (Поле '''PDP_KEY''' из таблицы <code>'''[PrtDeps]'''</code>).
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="departmentKey" value="0" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 11
 +
| Настройка, определяющая '''валюту''', в которой будет совершаться платеж через систему «Uniteller».
 +
Обязательная настройка.
 +
|
 +
 
 +
*'''Contract''' — оплата в валюте путевки;
 +
*'''Tour''' — оплата в валюте тура;
 +
*'''National''' — оплата в национальной валюте;
 +
*'''DefinedBySettings''' — оплата в валюте, определенной настройкой '''currency'''.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
 
 +
<add key="currencyToPay" value="National" />
 +
</syntaxhighlight>
 +
|- style="vertical-align:text-top"
 +
 
 +
| 12
 +
| Настройка, определяющая '''код валюты''', в которой будет совершаться платеж через систему «Uniteller» при значении '''DefinedBySettings''' настройки '''currencyToPay'''.
 +
| '''Код валюты''' (Поле '''RA_CODE''' из таблицы <code>'''[Rates]'''</code>).
 +
Сопоставление кодов валют ПК «Мастер-Тур» и системы «Uniteller» задается в секции <code><currencyMap></code>, например:
 +
<syntaxhighlight lang="xml">
 +
<currencyMap>
 +
<add key="рб" value="RUB"/>
 +
<add key="грн" value="UAH"/>
 +
<add key="azn" value="AZN"/>
 +
<add key="тг" value="KZT"/>
 +
</currencyMap>
 +
</syntaxhighlight>
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="currency" value="рб" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 13
 +
| Включение функционала фискализации платежей.
 +
После включения необходимо заполнить настройки '''TaxMode''' и '''TaxRateCode'''.
 +
|
 +
 
 +
*'''true''' — использовать фискализацию при оплате;
 +
*'''false''' или отсутствие настройки — не использовать фискализацию при оплате.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
 
 +
<add key="UseFiscalization" value="true"/>
 +
</syntaxhighlight>
 +
|- style="vertical-align:text-top"
 +
 
 +
| 14
 +
| Код системы налогообложения, необходимый для работы фискализации платежей.
 +
|
 +
 
 +
*'''0''' — общая система налогообложения;
 +
*'''1''' — упрощенная система налогообложения (Доход);
 +
*'''2''' — упрощенная система налогообложения (Доход минус Расход);
 +
*'''3''' — единый налог на вмененный доход;
 +
*'''4''' — единый сельскохозяйственный налог;
 +
*'''5''' — патентная система налогообложения.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
 
 +
<add key="TaxMode" value="2" />
 +
</syntaxhighlight>
 +
|- style="vertical-align:text-top"
 +
 
 +
| 15
 +
| Код ставки налогообложения, необходимый для работы фискализации платежей.
 +
|
 +
 
 +
*-1 – не облагается НДС
 +
*0 – облагается НДС по ставке 0%
 +
*5 - облагается НДС по ставке 5%
 +
*7 - облагается НДС по ставке 7%
 +
*10 – облагается НДС по ставке 10%
 +
*20 – облагается НДС по ставке 20%
 +
*105 – облагается НДС по ставке 5/105
 +
*107 – облагается НДС по ставке 7/107
 +
*110 – облагается НДС по ставке 10/110
 +
*120 – облагается НДС по ставке 20/120
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
 
 +
<add key="TaxRateCode" value="20" />
 +
</syntaxhighlight>
 +
|- style="vertical-align:text-top"
 +
 
 +
| 16
 +
| Пути к шаблонам для формирования запросов и подписи.
 +
|
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="base" value="templates/unitellerBaseRequestTemplate.txt" />
 +
<add key="signature" value="templates/unitellerSignatureTemplate.txt" />
 +
<add key="otherParams" value="templates/unitellerOtherParamsTemplate.txt" />
 +
<add key="resultRequest" value="templates/unitellerResultRequestTemplate.txt" />
 +
<add key="fiscalizationParams" value="templates/unitellerFiscalizationParamsTemplate.txt" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 17
 +
| Валюты, поддерживаемые системой Uniteller.
 +
| В системе Uniteller возможны только следующие валюты платежа: RUB, UAH, AZN, KZT
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="рб" value="RUB" />
 +
<add key="грн" value="UAH" />
 +
<add key="azn" value="AZN" />
 +
<add key="тг" value="KZT" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 18
 +
| Ключ услуги страхования, добавляемой в фискальный чек. Применяется, если отсутствует скрытая услуга "Операторский тур".
 +
| Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>).
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="InsuranceServiceKey" value="" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 19
 +
| Ключ услуги для скрытой услуги "Операторский тур", отображаемой в фискальном чеке.
 +
| Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>).
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="OperatorTourServiceKey" value="" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 20
 +
| Настройка, определяющая '''тип операции при проведении платежа'''.
 +
Обязательная настройка.
 +
| '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="PaymentOperationId" value="1" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 21
 +
| Настройка, определяющая '''тип операции при проведении платежа для комиссий'''.
 +
| '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>).
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="paymentOperationComissionId" value="" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 22
 +
| Настройка, позволяющая задавать '''размер комиссии''', включаемой в сумму оплаты (для агентств).
 +
Для корректной работы настройки – в путевке должно быть выбрано лицо, заключающее договор (представитель агентства).
 +
| Значение комиссии в процентах. При вычислении итоговой суммы платежа в Uniteller из неё вычитается процент комиссии, чтобы получить стоимость путевки.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="addAgencyComission" value="" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 23
 +
| Настройка, позволяющая задавать '''размер комиссии''', включаемой в сумму оплаты (для частных лиц).
 +
| Значение комиссии в процентах. При вычислении итоговой суммы платежа в Uniteller из неё вычитается процент комиссии, чтобы получить стоимость путевки.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="addPersonalComission" value="" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 24
 +
| Настройка, включающая расчет через Мастер финанс.
 +
|
 +
 
 +
*'''false''' — расчет через Мастер финанс не включен;
 +
*'''true''' — расчет через Мастер финанс включен.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
 
 +
<add key="AddPaymentsToMasterFinance" value="false" />
 +
</syntaxhighlight>
 +
|- style="vertical-align:text-top"
 +
 
 +
| 25
 +
| Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками NewDogovorServiceSvKey и NewDogovorServicePartnerKey.
 +
| Ключ услуги (Поле '''SL_KEY''' из таблицы <code>'''[ServiceList]'''</code>).
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="NewDogovorServiceServiceListKey" value="" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 26
 +
| Настройка, задающая класс услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками NewDogovorServiceServiceListKey и NewDogovorServicePartnerKey.
 +
| Ключ класса услуги (Поле '''SV_KEY''' из таблицы <code>'''[Service]'''</code>).
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="NewDogovorServiceSvKey" value="" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 27
 +
| Настройка, задающая партнера, который является поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками NewDogovorServiceServiceListKey и NewDogovorServiceSvKey.
 +
| Ключ партнера (Поле '''PR_KEY''' из таблицы <code>'''[Partners]'''</code>).
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="NewDogovorServicePartnerKey" value="" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 28
 +
| Настройка, задающая форму оплаты на шлюзе Uniteller.
 +
|
 +
 
 +
*'''All''' — и карта и СБП;
 +
*'''Card''' — только карта;
 +
*'''SBP''' — только СБП.
 +
Если параметр не указан, или пустой, используется значение по умолчанию — '''All'''.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
 
 +
<add key="PaymentFormType" value="Person" />
 +
</syntaxhighlight>
 +
|- style="vertical-align:text-top"
 +
 
 +
| 29
 +
| Тип отображения комиссии платежной системы в фискальном чеке.
 +
|
 +
 
 +
*'''0''' — комиссия увеличивает стоимость позиций по чеку на указанный процент комиссии;
 +
*'''1''' — комиссия добавляется отдельной строкой в чеке.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
 
 +
<add key="ComissionShowModeInVoucher" value="0" />
 +
</syntaxhighlight>
 +
|- style="vertical-align:text-top"
 +
 
 +
| 30
 +
| Текст наименования позиции в чеке для комиссии при типе отображения '''1'''.
 +
| По умолчанию — "Комиссия платежной системы".
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="ComissionTextInVoucher" value="Юнителлер комиcсия" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 31
 +
| Вид формирования чека.
 +
|
 +
 
 +
*'''true''' — разбить по услугам отдельно;
 +
*'''false''' — одной строкой из ключа VoucherServiceText.
 +
По умолчанию — '''false'''.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
 
 +
<add key="VoucherShowDetails" value="false" />
 +
</syntaxhighlight>
 +
|- style="vertical-align:text-top"
 +
 
 +
| 32
 +
| Наименование услуги в чеке.
 +
| Поддерживается вставка номера договора через параметр '''%dogovor%'''.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="VoucherServiceText" value="Туристическая услуга по договору %dogovor%" />
 +
</syntaxhighlight>
 +
|- style="vertical-align:text-top"
 +
 
 +
| 33
 +
| Типы договоров поставщиков, для которых необходимо указывать данные поставщика в фискальном чеке.<br>
 +
Работает совместно с настройкой '''VoucherShowDetails'''.<br><br>
 +
* Если VoucherShowDetails = true и типы договоров не указаны — в чеке будет просто список услуг.<br>
 +
* Если VoucherShowDetails = true и типы договоров указаны, и в путёвке есть услуги с поставщиком указанного типа — в чеке по этим услугам будет указана информация о поставщике.<br>
 +
* Если VoucherShowDetails = false — настройка не используется.
 +
| Список типов договоров, перечисленных через запятую.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="SendDetailPartnerByDogovorTypes" value=""/>
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 34
 +
| Код ставки налогообложения для поставщиков, типы договоров которых указаны в настройке '''SendDetailPartnerByDogovorTypes'''.<br>
 +
Если не указан — используется значение общей настройки '''TaxRateCode'''.<br>
 +
Допустимые значения:<br>
 +
* -1 – не облагается НДС<br>
 +
* 0 – ставка 0%<br>
 +
* 5 – ставка 5%<br>
 +
* 7 – ставка 7%<br>
 +
* 10 – ставка 10%<br>
 +
* 20 – ставка 20%<br>
 +
* 105 – 5/105<br>
 +
* 107 – 7/107<br>
 +
* 110 – 10/110<br>
 +
* 120 – 20/120
 +
| Код ставки НДС.
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="TaxRateCodePartner" value="20" />
 +
</syntaxhighlight>
 +
|}
 +
 
 +
====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"
 
|- style="vertical-align:text-top"
Строка 1338: Строка 2274:
 
| 13
 
| 13
 
| Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для агентств''').
 
| Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для агентств''').
 +
Для корректной работы настройки – в путевке должно быть выбрано лицо, заключающее договор (представитель агентства).
 
| '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется запятой).
 
| '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется запятой).
 
Комиссия указывается '''в процентах'''.<br />
 
Комиссия указывается '''в процентах'''.<br />
Строка 1499: Строка 2436:
 
| 11
 
| 11
 
| Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для агентств''').
 
| Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для агентств''').
 +
Для корректной работы настройки – в путевке должно быть выбрано лицо, заключающее договор (представитель агентства).
 
| '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется запятой).
 
| '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется запятой).
 
Комиссия указывается '''в процентах'''.<br />
 
Комиссия указывается '''в процентах'''.<br />
Строка 1692: Строка 2630:
 
| Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для агентств''').
 
| Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для агентств''').
 
Обязательная настройка.
 
Обязательная настройка.
 +
Для корректной работы настройки – в путевке должно быть выбрано лицо, заключающее договор (представитель агентства).
 
| '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется запятой).
 
| '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется запятой).
 
Комиссия указывается '''в процентах'''.<br />
 
Комиссия указывается '''в процентах'''.<br />
Строка 1760: Строка 2699:
 
|}
 
|}
 
<br />
 
<br />
 +
 +
 +
 +
==Сценарии работы==
 +
Предполагаются 3 сценария работы:<br />
 +
1. Заданы размеры комиссий и параметры '''paymentOperationId''', '''paymentOperationComissionId''', '''NewDogovorServiceSvKey''', '''NewDogovorServiceServiceListKey''', '''NewDogovorServicePartnerKey'''. В этом случае при оплате в базе данных формируется 1 ПКО (сумма за путевку + сумма комиссии), в путевке создается услуга "Комиссия при оплате через платежный шлюз" и сумма путевки увеличивается на размер стоимости созданной услуги.<br />
 +
2. Заданы размеры комиссий и параметры '''paymentOperationId''', '''paymentOperationComissionId'''. Параметры '''NewDogovorServiceSvKey''', '''NewDogovorServiceServiceListKey''', '''NewDogovorServicePartnerKey''' не заданы. В этом случае при оплате в базе данных формируются 2 ПКО (отдельно за путевку и за комиссию). Услуга в путевке не создается и сумма путевки не меняется.<br />
 +
3. Заданы размеры комиссий и параметр '''paymentOperationId'''. Значение параметра '''paymentOperationComissionId=0''' или параметр отсутствует. Оплата за комиссию уходит сразу в банк. В этом случае при оплате в базе данных формируется 1 ПКО за путевку.<br />
 +
<span style="color:red">Внимание!</span> Данные настройки не работают при включенной настройке <add key="AddPaymentsToMasterFinance" value="true"/>.
  
 
==Настройка индивидуальных подписей и ссылок для кнопки оплаты==
 
==Настройка индивидуальных подписей и ссылок для кнопки оплаты==
Строка 1854: Строка 2802:
  
 
После нажатия кнопки «Оплатить» определяются параметры для выбранной платежной системы (из соответствующей секции описанной в web.config) и формируется ссылка для передачи параметров платежа платежной системе. Затем осуществляется переход по сформированной ссылке.<br />
 
После нажатия кнопки «Оплатить» определяются параметры для выбранной платежной системы (из соответствующей секции описанной в web.config) и формируется ссылка для передачи параметров платежа платежной системе. Затем осуществляется переход по сформированной ссылке.<br />
−
[[Файл: ea_296.png|x1000px|Оплата]]<br />
+
[[Файл:Ag 111.png|x1000px|Оплата]]<br />
 +
 
 
===Возможные ошибки и методы их устранения===
 
===Возможные ошибки и методы их устранения===
 
====Ошибка SecureChannelFailure====
 
====Ошибка SecureChannelFailure====

Текущая версия на 20:35, 13 февраля 2026

Содержание

Введение

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


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



Модуль 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" />

Настройки логирования

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

№ Описание Значение Настройка
1 Логирование

Путь к лог-файлам задается в секции Loggers path.

  • ExceptionLogger – информация об ошибках
  • MasterWeb – общая информация при работе с системой
  • DetailEPLoger – пошаговое отслеживание работы платежной системы (работаем через EP). Сейчас реализован только для Юнителлера, при необходимости можно расширять и на другие платежные системы. Удобно использовать для тестирования и проверки платежной системы на стороне клиента.
 
<Loggers path="Logs\">
 <Logger level="ALL" name="ExceptionLogger" />
 <Logger level="ALL" name="MasterWeb" />
 <Logger level="OFF" name="DetailEPLoger" />
</Loggers>

Настройки в секции 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" />
7 Настройка способа учёта типов тура из <paymentAvailabilities> (атрибут tourTypes) при определении доступности оплаты. Если value="true", оплата доступна только когда у тура присутствуют все типы, указанные в tourTypes. Если false или настройка отсутствует – оплата доступна, когда у тура есть хотя бы один тип из tourTypes. false или отсутствие настройки – оплата доступна при наличии хотя бы одного типа из tourTypes;

true – оплата доступна только при наличии всех типов из tourTypes. 

<add key="allowPaymentIfAllTypeAllowed" value="true" />

Настройки в секции 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" -