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

Материал из Megatec
Перейти к: навигация, поиск
[непроверенная версия][досмотренная версия]
(→‎YandexPay)
(→‎Sberbank)
 
(не показана 21 промежуточная версия 2 участников)
Строка 6: Строка 6:
 
* Alfabank
 
* Alfabank
 
* Sberbank
 
* Sberbank
−
* Tinkoff
+
* Tinkoff (Т-Банк)
 
* Uniteller
 
* Uniteller
 
* YandexPay
 
* YandexPay
Строка 136: Строка 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>
 
|}
 
|}
  
Строка 211: Строка 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>
 
|}
 
|}
  
Строка 243: Строка 279:
 
  </paymentAvailabilities>
 
  </paymentAvailabilities>
  
−
* '''code''' - идентификатор доступности способа оплаты, должен быть уникальным;
+
* '''code''' – идентификатор доступности способа оплаты, должен быть уникальным;
−
* '''paymentMethodCode''' - идентификатор способа оплаты (''code'') из секции '''paymentMethod''';
+
* '''paymentMethodCode''' – идентификатор способа оплаты (''code'') из секции '''paymentMethod''';
−
* '''countryCode''' - ограничение доступности метода оплаты по ключу страны (''cn_key'' из таблицы ''tbl_country''). Может быть пустым - доступен для всех стран;
+
* '''countryCode''' – ограничение доступности метода оплаты по ключу страны (''cn_key'' из таблицы ''tbl_country''). Может быть пустым - доступен для всех стран;
−
* '''filialCode''' - ограничение доступности метода оплаты по коду партнера-филиала из его карточки (поле ''PR_COD''). Может быть пустым - доступен для всех филиалов;
+
* '''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===
Строка 323: Строка 359:
 
| 6
 
| 6
 
|Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для агентств) <br>
 
|Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для агентств) <br>
 +
Для корректной работы настройки – в путевке должно быть выбрано лицо, заключающее договор (представитель агентства).
 
|  
 
|  
 
Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется  запятой).
 
Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется  запятой).
Строка 486: Строка 523:
  
 
[[Файл: mb_030.png|left|Предупреждение]] <BR> Обратите внимание, что для корректной записи платежей в Мастер Тур, необходимо настроить автоматическое подтверждение платежа. Для этого необходимо обратиться в техподдержку Альфа-Банка.
 
[[Файл: mb_030.png|left|Предупреждение]] <BR> Обратите внимание, что для корректной записи платежей в Мастер Тур, необходимо настроить автоматическое подтверждение платежа. Для этого необходимо обратиться в техподдержку Альфа-Банка.
−
Существует возможность также подтверждать платежи вручную. Подробнее можно ознакомиться тут https://ecom.alfabank.ru/assets/instructions/merchantManual/pages/index/general_description.html#koordinati_podkljuchenija  или запросить информацию в технической поддержке Альфа-Банка
+
Существует возможность также подтверждать платежи вручную. Подробнее можно ознакомиться тут https://ecom.alfabank.ru/assets/instructions/merchantManual/pages/index/general_description.html#koordinati_podkljuchenija  или запросить информацию в технической поддержке Альфа-Банка<br />
  
 
====Sberbank====
 
====Sberbank====
 
Настройки задаются в секции <code><Sberbank></code> файла <code>web.config</code> приложения '''EntryPoint'''. При использовании SberbankMir или SberbankMir необходимо заполнить соответствующие секции в файле <code>web.config</code>.
 
Настройки задаются в секции <code><Sberbank></code> файла <code>web.config</code> приложения '''EntryPoint'''. При использовании SberbankMir или SberbankMir необходимо заполнить соответствующие секции в файле <code>web.config</code>.
 
<br /><br />
 
<br /><br />
 +
 +
Также поддерживается прием оплат через платежную систему '''Юкасса''' с использованием '''API Сбербанка'''.
 +
В данном случае клиент подключает в Юкасса возможность работы по API Сбербанка, после чего Юкасса выдает:
 +
* '''логин'''
 +
* '''пароль'''
 +
* '''ссылку на платежный шлюз'''
 +
 +
При использовании Юкасса по API Сбербанка необходимо указать в настройках секции <code><Sberbank></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"
  
Строка 503: Строка 550:
  
 
| 1
 
| 1
−
| Идентификатор клиента, который выдается платежной системой Sberbank.
+
| Идентификатор клиента, который выдается платежной системой Sberbank.<br /><br />
 +
При использовании '''Юкасса по API Сбербанка''' используется логин, выданный Юкасса.<br />
 
Обязательная настройка.
 
Обязательная настройка.
 
| '''Идентификатор клиента'''  
 
| '''Идентификатор клиента'''  
Строка 509: Строка 557:
 
<add key="userName" value="логин sberbank-api" />
 
<add key="userName" value="логин sberbank-api" />
 
</syntaxhighlight>
 
</syntaxhighlight>
 +
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
 
| 2
 
| 2
−
| Пароль клиента, который выдается платежной системой Sberbank.
+
| Пароль клиента, который выдается платежной системой Sberbank.<br /><br />
 +
При использовании '''Юкасса по API Сбербанка''' используется пароль, выданный Юкасса.<br />
 
Обязательная настройка.
 
Обязательная настройка.
 
| '''Пароль клиента'''  
 
| '''Пароль клиента'''  
Строка 517: Строка 567:
 
<add key="password" value="пароль sberbank-api" />
 
<add key="password" value="пароль sberbank-api" />
 
</syntaxhighlight>
 
</syntaxhighlight>
 +
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
 
| 3
 
| 3
−
| Ссылка на платежный шлюз Sberbank
+
| Ссылка на платежный шлюз Sberbank.<br /><br />
−
|Аналогично настройке link в секции Sberbank в разделе<paymentMethods>
+
Также поддерживается прием оплат через '''Юкасса''' по '''API Сбербанка'''. В этом случае необходимо указать ссылку на шлюз, предоставленную Юкасса.
 +
|Аналогично настройке link в секции Sberbank в разделе<paymentMethods><br /><br />
 +
Пример ссылки, предоставляемой Юкасса:<br />
 +
<code>https://3dsec-payments.yookassa.ru/payment/rest/</code>
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
 
<add key="sberbankPaymentApplicationUrl" value="https://securepayments.sberbank.ru/payment/rest/" />
 
<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>
 
</syntaxhighlight>
  
Строка 544: Строка 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
 
| Настройка, определяющая '''тип операции при проведении платежа'''.
 
| Настройка, определяющая '''тип операции при проведении платежа'''.
Строка 555: Строка 613:
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
−
 
 
| 7
 
| 7
 
| Настройка, определяющая '''тип операции при проведении платежа для комиссий'''.
 
| Настройка, определяющая '''тип операции при проведении платежа для комиссий'''.
Строка 566: Строка 623:
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
−
 
 
| 8
 
| 8
 
| Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для агентств''').<br>
 
| Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для агентств''').<br>
 +
Для корректной работы настройки – в путевке должно быть выбрано лицо, заключающее договор (представитель агентства).
 
| '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется либо запятой, либо точкой).
 
| '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется либо запятой, либо точкой).
 
Комиссия указывается '''в процентах'''.<br />
 
Комиссия указывается '''в процентах'''.<br />
Строка 577: Строка 634:
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
−
 
 
| 9
 
| 9
 
| Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для частных лиц''').<br>
 
| Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для частных лиц''').<br>
Строка 588: Строка 644:
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
−
 
 
| 10
 
| 10
 
| Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками ''NewDogovorServiceSvKey'' и ''NewDogovorServicePartnerKey''.
 
| Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками ''NewDogovorServiceSvKey'' и ''NewDogovorServicePartnerKey''.
Строка 597: Строка 652:
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
−
 
 
| 11
 
| 11
 
| Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServicePartnerKey''.
 
| Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServicePartnerKey''.
Строка 606: Строка 660:
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
−
 
 
| 12
 
| 12
 
| Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServiceSvKey''.
 
| Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServiceSvKey''.
Строка 615: Строка 668:
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
−
 
 
| 13
 
| 13
 
| Настройка, включающая расчет через Мастер финанс.
 
| Настройка, включающая расчет через Мастер финанс.
Строка 628: Строка 680:
 
<br />
 
<br />
  
−
====Tinkoff====
+
====Tinkoff (Т-Банк)====
 +
Настройки задаются в секции <code><paymentMethods></code> файла <code>web.config</code> приложения '''EntryPoint'''.<br />
 +
 
 +
{| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse"
 +
 
 +
|- style="background-color:#F2F2F2"
 +
 
 +
! width="2%" | №
 +
! width="28%" | Описание
 +
! width="35%" | Значение
 +
! width="35%" | Настройка
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 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 />
 
Настройки задаются в секции <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"
Строка 644: Строка 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"/>
Строка 654: Строка 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"/>
Строка 684: Строка 772:
 
| '''Идентификатор терминала'''
 
| '''Идентификатор терминала'''
 
Обязательная настройка.
 
Обязательная настройка.
−
| Параметр '''Терминал''' из раздела Терминалы в л/к сервиса «Tinkoff».
+
| Параметр '''Терминал''' из раздела Терминалы в л/к сервиса «Tinkoff (Т-Банк)».
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
 
<add key="TerminalKey" value="1587990738"/>
 
<add key="TerminalKey" value="1587990738"/>
Строка 694: Строка 782:
 
| '''Пароль терминала'''
 
| '''Пароль терминала'''
 
Обязательная настройка.
 
Обязательная настройка.
−
| Параметр '''Пароль''' из раздела Терминалы в л/к сервиса «Tinkoff».
+
| Параметр '''Пароль''' из раздела Терминалы в л/к сервиса «Tinkoff (Т-Банк)».
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
 
<add key="TerminalPassword" value="cn5du3jxcfbmwtyuii"/>
 
<add key="TerminalPassword" value="cn5du3jxcfbmwtyuii"/>
Строка 702: Строка 790:
  
 
| 7
 
| 7
−
| Настройка, определяющая '''язык''' окна платежной формы «Tinkoff».
+
| Настройка, определяющая '''язык''' окна платежной формы «Tinkoff (Т-Банк)».
 
Обязательная настройка.
 
Обязательная настройка.
 
|  
 
|  
Строка 795: Строка 883:
 
| 15
 
| 15
 
|Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для агентств) <br>
 
|Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для агентств) <br>
 +
Для корректной работы настройки – в путевке должно быть выбрано лицо, заключающее договор (представитель агентства).
 
|  
 
|  
 
Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется  запятой).
 
Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется  запятой).
Строка 1079: Строка 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=""/>
Строка 1132: Строка 1225:
 
| 20
 
| 20
 
| Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для агентств''').
 
| Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для агентств''').
 +
Для корректной работы настройки – в путевке должно быть выбрано лицо, заключающее договор (представитель агентства).
 
| '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется запятой).
 
| '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется запятой).
 
Комиссия указывается '''в процентах'''.<br />
 
Комиссия указывается '''в процентах'''.<br />
Строка 1256: Строка 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 />
Строка 1313: Строка 1438:
 
* Добавлены программные интерфейсы для новых сценариев.</br>
 
* Добавлены программные интерфейсы для новых сценариев.</br>
 
* Для интерфейсов версии 2.0 изменен формат фискального чека.</br>
 
* Для интерфейсов версии 2.0 изменен формат фискального чека.</br>
−
====YandexPay====
+
 
−
Настройки задаются в секции <code><YandexPay></code> файла <code>web.config</code> приложения '''EntryPoint'''.<br />
+
====Uniteller для юридических лиц====
−
{| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse"
+
Настройки задаются в секции <code><UnitellerPerson></code> файла <code>web.config</code> приложения '''EntryPoint'''.
−
 
+
 
−
 
+
При использовании платёжной системы для юридических лиц — Платформа Юнителлер для юридических лиц, добавляется соответствующий paymentMethod, paymentAvailability, configSection, а также настройки в секции <code><UnitellerPerson></code>.
−
|- style="background-color:#F2F2F2"
+
 
−
 
+
{| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse"
−
! width="2%" | №
+
 
−
! width="28%" | Описание
+
|- style="background-color:#F2F2F2"
−
! width="35%" | Значение
+
! width="2%" | №
−
! width="35%" | Настройка
+
! width="28%" | Описание
−
 
+
! width="35%" | Значение
−
|- style="vertical-align:text-top
+
! width="35%" | Настройка
−
 
+
 
−
 
+
|- style="vertical-align:text-top"
−
| 1
+
 
−
| '''Таймаут запроса'''
+
| 1
−
Обязательная настройка.
+
| '''Точки продажи''' ('''shopIDP''')
−
| Время ожидания ответа от сервера в миллисекундах.
+
Обязательная настройка.
−
|<syntaxhighlight lang="xml" enclose="div">
+
| '''Uniteller Point ID''' из раздела Точки продажи ЛК «Uniteller».
−
<add key="RequestTimeout" value="10" />
+
|<syntaxhighlight lang="xml" enclose="div">
−
</syntaxhighlight>
+
<add key="shopIDP" value="00005432"/>
−
 
+
</syntaxhighlight>
−
|- style="vertical-align
+
 
−
 
+
|- style="vertical-align:text-top"
−
 
+
 
−
| 2
+
| 2
−
| '''API-ключ'''
+
| '''Логин'''
−
Обязательная настройка.
+
Обязательная настройка.
−
| Уникальный ключ API для доступа к сервисам Yandex Pay.
+
| '''Login''' из раздела Параметры авторизации ЛК «Uniteller».
−
|<syntaxhighlight lang="xml" enclose="div">
+
|<syntaxhighlight lang="xml" enclose="div">
−
<add key="ApiKey" value="a8412f07-5583-4b3e-abe1-06ad6733ea1d" />
+
<add key="login" value="2281" />
−
</syntaxhighlight>
+
</syntaxhighlight>
−
 
+
 
−
|- style="vertical-align
+
|- style="vertical-align:text-top"
−
 
+
 
−
 
+
| 3
−
| 3
+
| '''Пароль'''
−
| '''URL создания заказа'''
+
Обязательная настройка.
−
Обязательная настройка.
+
| '''Password''' из раздела Параметры авторизации ЛК «Uniteller».
−
| URL для запроса на создание ссылки на оплату заказа.
+
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="password" value="XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX" />
 +
</syntaxhighlight>
 +
 
 +
|- style="vertical-align:text-top"
 +
 
 +
| 4
 +
| Платёжная система кредитной карты.
 +
|
 +
 
 +
*'''0''' или '''отсутствует значение''' - любая
 +
*'''Any''' или пустое значение - любая
 +
*'''VISA''' - VISA
 +
*'''MasterCard''' - MasterCard
 +
*'''DinersClub''' - Diners Club
 +
*'''JCB''' - JCB
 +
*'''AmericanExpress''' - American Express
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
 
 +
<add key="meanType" value="" />
 +
</syntaxhighlight>
 +
|- style="vertical-align:text-top"
 +
 
 +
| 5
 +
| Тип электронной валюты.
 +
|
 +
 
 +
*'''Any''' или пустое значение - любая система электронных платежей
 +
*'''YandexMoney''' - Яндекс.Деньги
 +
*'''RBKMoney''' - RBK Money
 +
*'''MoneyMail''' - MoneyMail
 +
*'''WebCreds''' - WebCreds
 +
*'''PlatezhRu''' - Platezh.ru
 +
*'''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">
 
|<syntaxhighlight lang="xml" enclose="div">
 
<add key="CreateOrderUrl" value="https://sandbox.pay.yandex.ru/api/merchant/v1/orders" />
 
<add key="CreateOrderUrl" value="https://sandbox.pay.yandex.ru/api/merchant/v1/orders" />
Строка 1474: Строка 2024:
 
| '''Размер комиссии для агентств'''
 
| '''Размер комиссии для агентств'''
 
Опциональная настройка.
 
Опциональная настройка.
 +
Для корректной работы настройки – в путевке должно быть выбрано лицо, заключающее договор (представитель агентства).
 
| Размер комиссии для агентств в процентах.
 
| Размер комиссии для агентств в процентах.
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
Строка 1596: Строка 2147:
 
<add key="ReceiptAuthUrl" value="https://fiscalization.evotor.ru/possystem/v5/getToken" />
 
<add key="ReceiptAuthUrl" value="https://fiscalization.evotor.ru/possystem/v5/getToken" />
 
</syntaxhighlight>
 
</syntaxhighlight>
 +
|- style="vertical-align
 +
| 24
 +
| '''Почта для отправки чеков по умолчанию'''
 +
Опциональная настройка.
 +
| Указывается почта, на которую будут приходить чеки, в случае отсутствия их в партнере или представителе партнера
 +
|<syntaxhighlight lang="xml" enclose="div">
 +
<add key="ReceiptClientDefaultEmail" value="peligrim@mail.ru" />
 +
</syntaxhighlight>
 +
|}
  
 
====Assist====
 
====Assist====
Строка 1714: Строка 2274:
 
| 13
 
| 13
 
| Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для агентств''').
 
| Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для агентств''').
 +
Для корректной работы настройки – в путевке должно быть выбрано лицо, заключающее договор (представитель агентства).
 
| '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется запятой).
 
| '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется запятой).
 
Комиссия указывается '''в процентах'''.<br />
 
Комиссия указывается '''в процентах'''.<br />
Строка 1875: Строка 2436:
 
| 11
 
| 11
 
| Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для агентств''').
 
| Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для агентств''').
 +
Для корректной работы настройки – в путевке должно быть выбрано лицо, заключающее договор (представитель агентства).
 
| '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется запятой).
 
| '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется запятой).
 
Комиссия указывается '''в процентах'''.<br />
 
Комиссия указывается '''в процентах'''.<br />
Строка 2068: Строка 2630:
 
| Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для агентств''').
 
| Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для агентств''').
 
Обязательная настройка.
 
Обязательная настройка.
 +
Для корректной работы настройки – в путевке должно быть выбрано лицо, заключающее договор (представитель агентства).
 
| '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется запятой).
 
| '''Значение комиссии''', которую необходимо ''включить в сумму платежа'' (целая часть отделяется запятой).
 
Комиссия указывается '''в процентах'''.<br />
 
Комиссия указывается '''в процентах'''.<br />
Строка 2239: Строка 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" - название платежной системы (если не задана ссылка на логотип, то отображается кнопка с наименованием данного поля);
  • 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). Отсутствие параметра или пустой параметр – оплата доступна для всех типов туров (допускается внесение нескольких параметров через ","). Если требуется оплата с типом тура Индивидуально, то в настройку необходимо добавить ключ 0

Настройки подключения и параметров используемых платежных систем модуля 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.
Обратите внимание, настройки являются обязательными.