Платежные web-сервисы:EntryPoint

Введение

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

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


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


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

Настройка

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

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

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

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

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

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

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

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

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

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

<paymentMethods>
    <add code="1" name="Tinkoff" logoLink="~/Content/logos/logoTinkoff.png" maximumAmount="1000000" skipDescriptionPage="false" paymentSystem="Tinkoff" link="https://securepay.tinkoff.ru/v2/Init/" />	
</paymentMethods>

• code="1" - идентификатор платежного метода, должен быть уникальным. Используется в других секциях, для ссылки на данный метод оплаты;
• name="Tinkoff" - название платежной системы (если не задана ссылка на логотип, то отображается кнопка с наименованием данного поля);
• paymentSystem="Tinkoff" - название платежной системы. Одно из предопределенных значений:
  • Alfabank
  • Sberbank и SberbankMir, SberbankChildren
  • Tinkoff
  • Uniteller и UnitellerMir, UnitellerChildren
  • Assist
  • WebPay
  • PayOnline
• LogoLink - расположение логотипа способа оплаты;
• maximumAmount - максимальный размер платежа;
• skipDescriptionPage - отображать экран редактирования оплаты или сразу выполнять платеж с текущими значениями.
  

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

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

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

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

<paymentAvailabilities>
<add code="1" paymentMethodCode="1" countryCode="7" filialCode="1" consumerCode="Person" isAvailable="false" priority="100" tourTypes="2"/>
</paymentAvailabilities>

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

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

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

Alfabank

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

№	Описание	Значение	Настройка
1	Точки продажи (shop_ID) Обязательная настройка.	Shop_ID из раздела Точки продажи ЛК «Alfabank».	<add key="shop_id" value="32565" />
2	Логин Обязательная настройка.	Login из раздела Параметры авторизации ЛК «Alfabank».	<add key="login" value="megatec" />
3	Пароль Обязательная настройка.	Password из раздела Параметры авторизации ЛК «Alfabank».	<add key="password" value="ХХХХХХХХХХ" />
4	Настройка, определяющая язык окна платежной формы «Alfabank». Обязательная настройка.	ru - русский язык en - английский язык	<add key="language" value="ru" />
5	Ссылка на платежный шлюз	Ссылка на платежный шлюз	<add key="paymentSystemLoginURL" value="https://ws.egopay.ru/order/v2/" />
6	Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для агентств)	Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется запятой). Комиссия указывается в процентах.	<add key="addAgencyComission" value="15,8" />
7	Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для частных лиц)	Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется запятой). Комиссия указывается в процентах.	<add key="addPersonalComission" value="17,4" />
8	Настройка, определяющая пользователя ПК «Мастер-Тур», к которому будет привязываться оплата. Обязательная настройка.	Ключ пользователя, к которому привязывается оплата (Поле US_KEY из таблицы [UserList]).	<add key="masterTourUser" value="0" />
9	Настройка, определяющая отдел, к которому будет привязываться оплата. Обязательная настройка.	Ключ отдела (кассы), к которому привязывается оплата (Поле PDP_KEY из таблицы [PrtDeps]).	<add key="departmentKey" value="0" />
10	Настройка, включающая расчет через Мастер финанс.	false - расчет через мастер финанс не включен; true - расчет через мастер финанс включен.	<add key="AddPaymentsToMasterFinance" value="false"/>
11	Настройка, определяющая тип операции при проведении платежа. Обязательная настройка.	Ключ операции (Поле PO_ID из таблицы [PaymentOperations]).	<add key="PaymentOperationId" value="6" />
12	Настройка, определяющая тип операции при проведении платежа для комиссий.	Ключ операции (Поле PO_ID из таблицы [PaymentOperations]).	<add key="paymentOperationCommissionId" value="" />
13	Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками NewDogovorServiceSvKey и NewDogovorServicePartnerKey.	Ключ услуги (Поле SL_KEY из таблицы [ServiceList]). Название услуги комиссии в путевке берется из этого параметра	<add key="NewDogovorServiceServiceListKey" value="450" />
14	Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками NewDogovorServiceServiceListKey и NewDogovorServicePartnerKey.	Ключ класса услуги (Поле SV_KEY из таблицы [Service]). Название услуги комиссии в путевке берется из этого параметра	<add key="NewDogovorServiceSvKey" value="1055" />
15	Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками NewDogovorServiceServiceListKey и NewDogovorServiceSvKey.	Ключ класса услуги (Поле PR_KEY из таблицы [Partners]).	<add key="NewDogovorServicePartnerKey" value="12921" />
16	Настройка, определяющая адрес электронной почты по умолчанию.	Используется в том случае, если не указан адрес электронной почты главного туриста.	<add key="defaultEmail" value="" />

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

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

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

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

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

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

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

Sberbank

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

№	Описание	Значение	Настройка
1	Идентификатор клиента, который выдается платежной системой Sberbank. Обязательная настройка.	Идентификатор клиента	<add key="userName" value="логин sberbank-api" />
2	Пароль клиента, который выдается платежной системой Sberbank. Обязательная настройка.	Пароль клиента	<add key="password" value="пароль sberbank-api" />
3	Ссылка на платежный шлюз Sberbank	Аналогично настройке link в секции Sberbank в разделе<paymentMethods>	<add key="sberbankPaymentApplicationUrl" value="https://securepayments.sberbank.ru/payment/rest/" />
4	Настройка, определяющая пользователя ПК «Мастер-Тур», к которому будет привязываться оплата. Обязательная настройка.	Ключ пользователя, к которому привязывается оплата (Поле US_KEY из таблицы [UserList]).	<add key="masterTourUser" value="95" />
5	Настройка, позволяющая создавать объект orderBundle (товарная корзина), в котором передаются все необходимые данные о товаре/услуге.	true - включено создание объекта orderBundle false или отсутствие настройки - объект orderBundle не создается По умолчанию настройка имеет значение false.	<add key="useFiscalization" value="false"/>
6	Настройка, определяющая тип операции при проведении платежа. Обязательная настройка.	Ключ операции (Поле PO_ID из таблицы [PaymentOperations]).	<add key="PaymentOperationId" value="1" />
7	Настройка, определяющая тип операции при проведении платежа для комиссий.	Ключ операции (Поле PO_ID из таблицы [PaymentOperations]). Внимание! Если данная настройка не заполнена, то значения настроек NewDogovorServiceServiceListKey, NewDogovorServiceSvKey, NewDogovorServicePartnerKey обязательно оставить незаполненными.	<add key="paymentOperationCommissionId" value="6" />
8	Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для агентств).	Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется либо запятой, либо точкой). Комиссия указывается в процентах. По умолчанию комиссия для агентств равна нулю.	<add key="addAgencyComission" value="3.627" />
9	Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для частных лиц).	Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется либо запятой, либо точкой). Комиссия указывается в процентах. По умолчанию комиссия для частных лиц равна нулю.	<add key="addPersonalComission" value="5.0" />
10	Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками NewDogovorServiceSvKey и NewDogovorServicePartnerKey.	Ключ услуги (Поле SL_KEY из таблицы [ServiceList]).	<add key="NewDogovorServiceServiceListKey" value="450" />
11	Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками NewDogovorServiceServiceListKey и NewDogovorServicePartnerKey.	Ключ класса услуги (Поле SV_KEY из таблицы [Service]).	<add key="NewDogovorServiceSvKey" value="1055" />
12	Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками NewDogovorServiceServiceListKey и NewDogovorServiceSvKey.	Ключ класса услуги (Поле PR_KEY из таблицы [Partners]).	<add key="NewDogovorServicePartnerKey" value="12921" />
13	Настройка, включающая расчет через Мастер финанс.	false - расчет через мастер финанс не включен; true - расчет через мастер финанс включен.	<add key="AddPaymentsToMasterFinance" value="false"/>

Tinkoff (Т-Банк)

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

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

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

№	Описание	Значение	Настройка
1	Адрес платежной службы Обязательная настройка.	Адрес сервиса оплаты через карту банка «Tinkoff (Т-Банк)».	<add key="LoginUrl" value="https://securepay.tinkoff.ru/v2/Init"/>
2	Адрес для оплаты по QR коду Обязательная настройка.	Адрес сервиса оплаты через карту банка «Tinkoff (Т-Банк)» по QR коду.	<add key="QRCodeUrl" value="https://securepay.tinkoff.ru/v2/GetQr"/>
3	Адрес метода для получения статуса платежа Обязательная настройка.	Адрес метода для получения статуса платежа.	<add key="GetStateUrl" value="https://securepay.tinkoff.ru/v2/GetState"/>
4	Адрес метода возвращающего статус заказа Обязательная настройка.	Адрес метода возвращающего статус заказа.	<add key="CheckOrderUrl" value="https://securepay.tinkoff.ru/v2/CheckOrder"/>
5	Идентификатор терминала Обязательная настройка.	Параметр Терминал из раздела Терминалы в л/к сервиса «Tinkoff (Т-Банк)».	<add key="TerminalKey" value="1587990738"/>
6	Пароль терминала Обязательная настройка.	Параметр Пароль из раздела Терминалы в л/к сервиса «Tinkoff (Т-Банк)».	<add key="TerminalPassword" value="cn5du3jxcfbmwtyuii"/>
7	Настройка, определяющая язык окна платежной формы «Tinkoff (Т-Банк)». Обязательная настройка.	ru - русский язык en - английский язык	<add key="LanguageFormCode" value="ru"/>
8	Код системы налогообложения, его значение должно соответствовать режимам налогообложения, сконфигурированным в ККМ при регистрации. Данная настройка необходима для работы фискализации платежей.	osn – общая система налогообложения usn_income – упрощенная система налогообложения (Доход) usn_income_outcome – упрощенная СН (Доход минус Расход) patent – патентная система налогообложения envd – единый налог на вмененный доход esn – единый сельскохозяйственный налог	<add key="TaxationCode" value="osn"/>
9	Код ставки налогообложения. Данная настройка необходима для работы фискализации платежей.	none – не облагается НДС vat0 – облагается НДС по ставке 0% vat10 – облагается НДС по ставке 10% vat20 – облагается НДС по ставке 20% vat110 – облагается НДС по ставке 10/110 vat120 – облагается НДС по ставке 18/120	<add key="Tax" value="none"/>
10	Настройка, определяющая тип операции при проведении платежа. Обязательная настройка.	Ключ операции (Поле PO_ID из таблицы [PaymentOperations]).	<add key="PaymentOperationId" value="6" />
11	Настройка, определяющая тип операции при проведении платежа для комиссий.	Ключ операции (Поле PO_ID из таблицы [PaymentOperations]).	<add key="paymentOperationCommissionId" value="" />
12	Настройка, определяющая пользователя ПК «Мастер-Тур», к которому будет привязываться оплата. Обязательная настройка.	Ключ пользователя, к которому привязывается оплата (Поле US_KEY из таблицы [UserList]).	<add key="masterTourUser" value="80" />
13	Настройка, определяющая партнера, к которому будет привязываться оплата. Обязательная настройка.	Ключ филиала, к которому привязывается оплата (Поле PR_KEY из таблицы [Partners]).	<add key="paymentFilialKey" value="1" />
14	Настройка, определяющая отдел, к которому будет привязываться оплата. Обязательная настройка.	Ключ отдела (кассы), к которому привязывается оплата (Поле PDP_KEY из таблицы [PrtDeps]).	<add key="departmentKey" value="2" />
15	Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для агентств)	Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется запятой). Комиссия указывается в процентах.	<add key="addAgencyComission" value="15,8" />
16	Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для частных лиц)	Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется запятой). Комиссия указывается в процентах.	<add key="addPersonalComission" value="17,4" />
17	Настройка, включающая расчет через Мастер финанс.	false - расчет через мастер финанс не включен; true - расчет через мастер финанс включен.	<add key="AddPaymentsToMasterFinance" value="false"/>
18	Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками NewDogovorServiceSvKey и NewDogovorServicePartnerKey.	Ключ услуги (Поле SL_KEY из таблицы [ServiceList]). Название услуги комиссии в путевке берется из этого параметра	<add key="NewDogovorServiceServiceListKey" value="450" />
19	Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками NewDogovorServiceServiceListKey и NewDogovorServicePartnerKey. Название услуги комиссии в путевке берется из этого параметра	Ключ класса услуги (Поле SV_KEY из таблицы [Service]).	<add key="NewDogovorServiceSvKey" value="1055" />
20	Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками NewDogovorServiceServiceListKey и NewDogovorServiceSvKey.	Ключ класса услуги (Поле PR_KEY из таблицы [Partners]).	<add key="NewDogovorServicePartnerKey" value="12921" />
21	Настройки, определяющие способ расчета. Если значение не передано, по умолчанию будет передаваться full_payment – полный расчет. Если сумма, которую мы оплачиваем меньше суммы, которую нужно оплатить, способ расчета определяется следующим образом: Если PaymentMethodPrepayment имеет значение, то берем его. Если он пуст, то берем PaymentMethodMain, если и он пуст, то передаем пустое значение (а на стороне Тинькофф это будет full_payment) Если по договору уже есть какая-то ранее оплаченная сумма, то способ расчета считается следующим образом: Если сумма, которую мы оплачиваем равна сумме, которую нужно оплатить, берем PaymentMethodFull. Если он пуст, то берем PaymentMethodMain, если и он пуст, то передаем пустое значение (а на стороне Тинькофф это будет full_payment) Если у нас нет ранее оплаченной суммы, то способ расчета считается следующим образом: Если сумма, которую мы оплачиваем равна сумме, которую нужно оплатить, берем PaymentMethodMain. Если он пуст, то передаем пустое значение (а на стороне Тинькофф это будет full_payment)	Возможные значения: full_prepayment – предоплата 100% prepayment – предоплата advance – аванс full_payment – полный расчет partial_payment – частичный расчет и кредит credit – передача в кредит credit_payment – оплата кредита	<add key="PaymentMethodMain" value="prepayment" /> <add key="PaymentMethodPrepayment" value="full_prepayment" /> <add key="PaymentMethodFull" value="" />

Uniteller

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

№	Описание	Значение	Настройка
1	Точки продажи (shopIDP) Обязательная настройка.	Uniteller Point ID из раздела Точки продажи ЛК «Uniteller».	<add key="shopIDP" value="00005432"/>
2	Логин Обязательная настройка.	Login из раздела Параметры авторизации ЛК «Uniteller».	<add key="login" value="2281" />
3	Пароль Обязательная настройка.	Password из раздела Параметры авторизации ЛК «Uniteller».	<add key="password" value="XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX" />
4	Платёжная система кредитной карты.	0 или отсутствует значение - любая 1 - VISA 2 - MasterCard 3 - Diners Club 4 - JCB 5 - American Express	<add key="meanType" value="" />
5	Тип электронной валюты.	0 или отсутствует значение - любая система электронных платежей 1 - Яндекс.Деньги 2 - RBK Money 3 - MoneyMail 4 - WebCreds 6 - Platezh.ru 7 - Деньги@Mail.Ru 8 - Мобильный платёж Мегафон 9 - Мобильный платёж МТС 10 - Мобильный платёж Билайн 11 - PayPal 12 - ВКонтакте 13 - Евросеть 14 - Yota.money 15 - QIWI Кошелек 16 - ПлатФон 17 - Moneybookers 29 - WebMoney WMR	<add key="eMoneyType" value="" />
6	Таймаут между попытками запроса результата	По умолчанию 100.	<add key="requestTimeout" value="100" />
7	Количество попыток запроса результата	По умолчанию 5.	<add key="requestAttempts" value="5" />
8	Настройка, определяющая пользователя ПК «Мастер-Тур», к которому будет привязываться оплата. Обязательная настройка.	Ключ пользователя, к которому привязывается оплата (Поле US_KEY из таблицы [UserList]).	<add key="masterTourUser" value="80" />
9	Настройка, определяющая партнера, к которому будет привязываться оплата. Обязательная настройка.	Ключ филиала, к которому привязывается оплата (Поле PR_KEY из таблицы [Partners]).	<add key="paymentFilialKey" value="1" />
10	Настройка, определяющая отдел, к которому будет привязываться оплата. Обязательная настройка.	Ключ отдела (кассы), к которому привязывается оплата (Поле PDP_KEY из таблицы [PrtDeps]).	<add key="departmentKey" value="2" />
11	Настройка, определяющая валюту, в которой будет совершаться платеж через систему «Uniteller». Обязательная настройка.	Contract - оплата в валюте путевки; Tour - оплата в валюте тура; National – оплата в национальной валюте; DefinedBySettings - оплата в валюте, определенной настройкой Сurrency.	<add key="currencyToPay" value="Contract" />
12	Настройка, определяющая код валюты, в которой будет совершаться платеж через платежную систему «Uniteller» при значении DefinedBySettings настройки currencyToPay.	Код валюты (Поле RA_CODE из таблицы [Rates]). Код валюты из ПК «Мастер-Тур» должен быть сопоставлен с кодом валюты в системе «Uniteller». Данное сопоставление задается в секции <currencyMap>, в качестве параметра key указывается код валюты из ПК «Мастер-Тур», в качестве параметра value задается код валюты в системе «Uniteller», например: <currencyMap> <add key="рб" value="RUB"/> <add key="грн" value="UAH"/> <add key="azn" value="AZN"/> <add key="тг" value="KZT"/> </currencyMap> .	<add key="currency" value="рб" />
13	Включение функционала фискализации платежей. После включения необходимо заполнить настройки Код системы налогообложения (TaxMode) и Код ставки налогообложения (TaxRateCode).	true – использовать фискализацию при оплате false или отсутствие настройки – не использовать фискализацию при оплате	<add key="UseFiscalization" value="true"/>
14	Код системы налогообложения, его значение должно соответствовать режимам налогообложения, сконфигурированным в ККМ при регистрации. Данная настройка необходима для работы фискализации платежей.	0 – общая система налогообложения 1 – упрощенная система налогообложения (Доход) 2 – упрощенная СН (Доход минус Расход) 3 – единый налог на вмененный доход 4 – единый сельскохозяйственный налог 5 – патентная система налогообложения	<add key="TaxMode" value=""/>
15	Код ставки налогообложения. Данная настройка необходима для работы фискализации платежей.	-1 – не облагается НДС 0 – облагается НДС по ставке 0% 10 – облагается НДС по ставке 10% 18 – облагается НДС по ставке 18% 110 – облагается НДС по ставке 10/110 118 – облагается НДС по ставке 18/118	<add key="TaxRateCode" value=""/>
16	Настройка, задающая услугу страхования, добавляемую в фискальный чек. Применяется в случае если в путевке отсутствует скрытая услуга "Операторский тур". Описание формирования чека с данными настройками находится в разделе Формирование чека при использовании скрытой услуги "Операторский тур" в путевке.	Ключ класса услуги (Поле SV_KEY из таблицы [Service]).	<add key="InsuranceServiceKey" value="6"/>
17	Настройка задающая название услуги в фискальном чеке если в путевке имеется скрытая услуга "Операторский тур". Описание формирования чека с данными настройками находится в разделе Формирование чека при использовании скрытой услуги "Операторский тур" в путевке.	Ключ класса услуги (Поле SV_KEY из таблицы [Service]).	<add key="OperatorTourServiceKey" value="1134"/>
18	Настройка, определяющая тип операции при проведении платежа. Обязательная настройка.	Ключ операции (Поле PO_ID из таблицы [PaymentOperations]).	<add key="PaymentOperationId" value="1" />
19	Настройка, определяющая тип операции при проведении платежа для комиссий.	Ключ операции (Поле PO_ID из таблицы [PaymentOperations]).	<add key="paymentOperationCommissionId" value="6" />
20	Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для агентств).	Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется запятой). Комиссия указывается в процентах. Сумма оплаты вычисляется следующим образом: Если из конечной суммы платежа в системе «Uniteller» вычесть указанный процент - получится стоимость путевки. Пример: Стоимость путевки - 100 у.е. В настройке указана комиссия - 50%. Итоговая сумма платежа в системе «Uniteller» - 200 у.е. 200 у.е. - 50% * 200 у.е. = 100 у.е. (стоимость путевки).	<add key="addAgencyComission" value="3,627" />
21	Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для частных лиц).	Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется запятой). Комиссия указывается в процентах. Сумма оплаты вычисляется следующим образом: Если из конечной суммы платежа в системе «Uniteller» вычесть указанный процент - получится стоимость путевки. Пример: Стоимость путевки - 100 у.е. В настройке указана комиссия - 50%. Итоговая сумма платежа в системе «Uniteller» - 200 у.е. 200 у.е. - 50% * 200 у.е. = 100 у.е. (стоимость путевки).	<add key="addPersonalComission" value="5" />
22	Настройка, включающая расчет через Мастер финанс.	false - расчет через мастер финанс не включен; true - расчет через мастер финанс включен.	<add key="AddPaymentsToMasterFinance" value="false"/>
23	Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками NewDogovorServiceSvKey и NewDogovorServicePartnerKey.	Ключ услуги (Поле SL_KEY из таблицы [ServiceList]).	<add key="NewDogovorServiceServiceListKey" value="450" />
24	Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками NewDogovorServiceServiceListKey и NewDogovorServicePartnerKey.	Ключ класса услуги (Поле SV_KEY из таблицы [Service]).	<add key="NewDogovorServiceSvKey" value="1055" />
25	Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками NewDogovorServiceServiceListKey и NewDogovorServiceSvKey.	Ключ класса услуги (Поле PR_KEY из таблицы [Partners]).	<add key="NewDogovorServicePartnerKey" value="12921" />
26	Настройка, задающая форму оплаты на шлюзе Uniteller	"All" - и карта и СБП, "Card" - только карта, "SBP" - только СБП Если параметр не указан, или пустой или любой набор символов, то по умолчанию All	<add key="PaymentFormType" value="Card" />
27	Тип отображения комиссии платежной системы в фискальном чеке.	0 - увеличивает стоимость позиций по чеку на размер (%) комиссию 1 - добавляет в чек комиссию отдельной строкой	<add key="ComissionShowModeInVoucher" value ="0"/>
28	Наименование позиции в чеке для комиссии для <add key="ComissionShowModeInVoucher" value ="1"/>.	По умолчанию - "Комиссия платежной системы"	<add key="ComissionTextInVoucher" value ="Юнителлер комиcсия"/>
29	Вид формирования чека	true - разбить по услугам отдельно, false - одной строкой из ключа VoucherServiceText По умолчанию настройка в состоянии false.	<add key="VoucherShowDetails" value="false"/>
30	Наименование услуги в чеке	%dogovor% (не обязательно) - для вставки номера договора.	<add key="VoucherServiceText" value="Туристическая услуга по договору %dogovor%"/>

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

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

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

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

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

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

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

YandexPay

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

№	Описание	Значение	Настройка
1	Таймаут запроса Обязательная настройка.	Время ожидания ответа от сервера в миллисекундах.	<add key="RequestTimeout" value="10" />
2	API-ключ Обязательная настройка.	Уникальный ключ API для доступа к сервисам Yandex Pay.	<add key="ApiKey" value="a8412f07-5583-4b3e-abe1-06ad6733ea1d" />
3	URL создания заказа Обязательная настройка.	URL для запроса на создание ссылки на оплату заказа.	<add key="CreateOrderUrl" value="https://sandbox.pay.yandex.ru/api/merchant/v1/orders" />
4	URL получения деталей заказа Обязательная настройка.	URL для запроса на получение деталей заказа.	<add key="GetOrderDetailsUrl" value="https://sandbox.pay.yandex.ru/api/merchant/v1/orders" />
5	Ставка НДС Обязательная настройка.	Значение ставки НДС: 1 - НДС по ставке 20% 2 - НДС по ставке 10% 3 - НДС по расчетной ставке 20/120 4 - НДС по расчетной ставке 10/110 5 - НДС по ставке 0% 6 - Без НДС	<add key="Tax" value="1" />
6	Доступные методы оплаты Опциональная настройка.	Методы оплаты, доступные на платежной форме Yandex Pay: 0 - CARD 1 - SPLIT 2 - CARD, SPLIT	<add key="AvailablePaymentMethods" value="2" />
7	Сплит при наличии комиссии Опциональная настройка.	Указывает, доступен ли сплит, когда есть комиссия: true - доступен false - не доступен	<add key="AvailableSplitMethodWhenCommission" value="false" />
8	Ключ пользователя Обязательная настройка.	Ключ пользователя, к которому привязывается оплата.	<add key="masterTourUser" value="106" />
9	Ключ филиала Обязательная настройка.	Ключ филиала, к которому привязывается оплата.	<add key="paymentFilialKey" value="7" />
10	Ключ отдела Обязательная настройка.	Ключ отдела (кассы), к которому привязывается оплата.	<add key="departmentKey" value="7" />
11	Тип операции при проведении платежа Обязательная настройка.	Ключ операции из таблицы PaymentOperations, определяющий тип операции при проведении платежа.	<add key="PaymentOperationId" value="36" />
12	Тип операции для комиссий Опциональная настройка.	Ключ операции из таблицы PaymentOperations для комиссий.	<add key="paymentOperationCommissionId" value="7" />
13	Размер комиссии для агентств Опциональная настройка.	Размер комиссии для агентств в процентах.	<add key="addAgencyComission" value="10" />
14	Размер комиссии для частных лиц Опциональная настройка.	Размер комиссии для частных лиц в процентах.	<add key="addPersonalComission" value="" />
15	Класс услуги для комиссии Опциональная настройка.	Класс услуги, добавляемой в путевку при наличии комиссии.	<add key="NewDogovorServiceSvKey" value="1055" />
16	Услуга для комиссии Опциональная настройка.	Услуга, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии.	<add key="NewDogovorServiceServiceListKey" value="982" />
17	Партнер для комиссии Опциональная настройка.	Партнер, являющийся поставщиком для услуги, добавляемой в путевку при наличии комиссии.	<add key="NewDogovorServicePartnerKey" value="10760" />
18	Расчеты через MasterFinance Опциональная настройка.	Указывает, проводятся ли платежи через MasterFinance: true - проводятся false - не проводятся	<add key="AddPaymentsToMasterFinance" value="false" />
19	Система налогообложения Обязательная настройка.	Указывает, какая система налогообложения будет использоваться при платежах: osn — общая СН usn_income — упрощенная СН (доходы) usn_income_outcome – упрощенная СН (доходы минус расходы) esn – единый сельскохозяйственный налог patent – патентная СН	<add key="TaxationCode" value="osn" />
20	Идентификатор группы ККТ Обязательная настройка.	Идентификатор группы контрольно-кассовой техники.	<add key="ReceiptGroupCode" value="2ca8430a-ff34-421a-b2aa-2071d79eb782" />
21	Логин для авторизации в сервисе формирования чеков Обязательная настройка.	Логин для авторизации в сервисе формирования чеков.	<add key="ReceiptLogin" value="7709624788" />
22	Пароль для авторизации в сервисе формирования чеков Обязательная настройка.	Пароль для авторизации в сервисе формирования чеков.	<add key="ReceiptPassword" value="79161128982" />
23	URL для авторизации в сервисе формирования чеков Обязательная настройка.	URL для авторизации в сервисе формирования чеков.	<add key="ReceiptAuthUrl" value="https://fiscalization.evotor.ru/possystem/v5/getToken" />
24	Почта для отправки чеков по умолчанию Опциональная настройка.	Указывается почта, на которую будут приходить чеки, в случае отсутствия их в партнере или представителе партнера	<add key="ReceiptClientDefaultEmail" value="peligrim@mail.ru" />

Assist

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

№	Описание	Значение	Настройка
1	Ключ интернет-магазина	Ключ магазина, который предоставляет Assist	<add key="shopID" value="326055"/>
2	Логин для авторизации в системе Assist	Логин для авторизации, который предоставляет Assist. Необходимо добавить обе настройки.	<add key="shopLogin" value="login"/>
3	Пароль для авторизации в системе Assist	Пароль для авторизации, который предоставляет Assist	<add key="shopPassword" value="password"/>
4	Логин для авторизации	Логин веб-сервиса, который предоставляет Assist	<add key="webServiceLogin" value=" login "/>
5	Настройка, определяющая пользователя, к которому будет привязываться оплата	Ключ пользователя из таблицы [UserList], к которому привязывается оплата	<add key="masterTourUser" value="100006"/>
6	Настройка, определяющая партнера, к которому будет привязываться оплата	Ключ партнера из таблицы [tbl_Partners], к которому привязывается оплата	<add key="paymentFilialKey" value="1"/>
7	Настройка, определяющая отдел, к которому будет привязываться оплата	Ключ отдела (кассы) из таблицы [PrtDeps], к которому привязывается оплата	<add key="departmentKey" value="2"/>
8	Боевой/тестовый адрес. Откуда получать ответ.	Боевой адрес, который предоставляет Assist либо белорусский тестовый сервис: https://test.paysec.by/orderstate/orderstate.cfm либо питерский тестовый сервис: https://payments.demo.paysecure.ru/orderstate/orderstate.cfm	<add key="assistGetTransaction" value="" />
9	Секретное слово из личного кабинета	Секретное слово, которое указывается в личном кабинете в Assist	<add key="salt" value="" />
10	Настройка, определяющая код валюты, в которой будет совершаться платеж через платежную систему Assist	Код валюты из таблицы [Rates], в которой будет совершаться платеж	<add key="assistPaymentsRate" value="рб" />
11	Настройка, определяющая тип операции при проведении платежа	Ключ операции из таблицы [PaymentOperations]	<add key="paymentOperationId" value="1"/>
12	Настройка, определяющая тип операции при проведении платежа для комиссий.	Ключ операции (Поле PO_ID из таблицы [PaymentOperations]).	<add key="paymentOperationCommissionId" value="6" />
13	Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для агентств).	Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется запятой). Комиссия указывается в процентах. Сумма оплаты вычисляется следующим образом: Если из конечной суммы платежа в системе «PayOnline» вычесть указанный процент - получится стоимость путевки. Пример: Стоимость путевки - 100 у.е. В настройке указана комиссия - 50%. Итоговая сумма платежа в системе «Assist» - 200 у.е. 200 у.е. - 50% * 200 у.е. = 100 у.е. (стоимость путевки).	<add key="addAgencyComission" value="3,627" />
14	Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для частных лиц).	Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется запятой). Комиссия указывается в процентах. Сумма оплаты вычисляется следующим образом: Если из конечной суммы платежа в системе «Assist» вычесть указанный процент - получится стоимость путевки. Пример: Стоимость путевки - 100 у.е. В настройке указана комиссия - 50%. Итоговая сумма платежа в системе «PayOnline» - 200 у.е. 200 у.е. - 50% * 200 у.е. = 100 у.е. (стоимость путевки).	<add key="addPersonalComission" value="5" />
15	Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками NewDogovorServiceSvKey и NewDogovorServicePartnerKey.	Ключ услуги (Поле SL_KEY из таблицы [ServiceList]).	<add key="NewDogovorServiceServiceListKey" value="450" />
16	Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками NewDogovorServiceServiceListKey и NewDogovorServicePartnerKey.	Ключ класса услуги (Поле SV_KEY из таблицы [Service]).	<add key="NewDogovorServiceSvKey" value="1055" />
17	Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками NewDogovorServiceServiceListKey и NewDogovorServiceSvKey.	Ключ класса услуги (Поле PR_KEY из таблицы [Partners]).	<add key="NewDogovorServicePartnerKey" value="12921" />
18	Настройка, включающая расчет через Мастер Финанс.	false - расчет через Мастер Финанс не включен; true - расчет через Мастер Финанс включен.	<add key="AddPaymentsToMasterFinance" value="false"/>

Webpay

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

№	Описание	Значение	Настройка
1	Идентификатор клиента в платежной системе	предоставляется Webpay	<add key="storeID" value="344612596"/>
2	Пароль клиента в платежной системе	предоставляется Webpay	<add key="privateKey" value="37kfffkvjj"
3	Код платежного агента	предоставляется Webpay	<add key="customerID" value="megatec-2" />
4	Настройка, определяющая пользователя, к которому будет привязываться оплата	Ключ пользователя из таблицы [UserList], к которому привязывается оплата	<add key="masterTourUser" value="100006"/>
5	Настройка, определяющая партнера, к которому будет привязываться оплата	Ключ партнера из таблицы [tbl_Partners], к которому привязывается оплата	<add key="paymentFilialKey" value="1"/>
6	Настройка, определяющая отдел, к которому будет привязываться оплата	Ключ отдела (кассы) из таблицы [PrtDeps], к которому привязывается оплата	<add key="departmentKey" value="2"/>
7	Откуда получать ответ. Тестовый адрес: https://sandbox.webpay.by	адрес платежного сервиса	<add key="webPayGetTransaction" value="https://securesandbox.webpay.by" />
8	Режим тестирования	Режим тестирования - 1, боевой режим - 0	<add key="isTest" value="1" />
9	Настройка, определяющая тип операции при проведении платежа	Ключ операции из таблицы [PaymentOperations]	<add key="paymentOperationId" value="1"/>
10	Настройка, определяющая тип операции при проведении платежа для комиссий.	Ключ операции (Поле PO_ID из таблицы [PaymentOperations]).	<add key="paymentOperationCommissionId" value="6" />
11	Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для агентств).	Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется запятой). Комиссия указывается в процентах. Сумма оплаты вычисляется следующим образом: Если из конечной суммы платежа в системе «PayOnline» вычесть указанный процент - получится стоимость путевки. Пример: Стоимость путевки - 100 у.е. В настройке указана комиссия - 50%. Итоговая сумма платежа в системе «Assist» - 200 у.е. 200 у.е. - 50% * 200 у.е. = 100 у.е. (стоимость путевки).	<add key="addAgencyComission" value="3,627" />
12	Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для частных лиц).	Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется запятой). Комиссия указывается в процентах. Сумма оплаты вычисляется следующим образом: Если из конечной суммы платежа в системе «Assist» вычесть указанный процент - получится стоимость путевки. Пример: Стоимость путевки - 100 у.е. В настройке указана комиссия - 50%. Итоговая сумма платежа в системе «PayOnline» - 200 у.е. 200 у.е. - 50% * 200 у.е. = 100 у.е. (стоимость путевки).	<add key="addPersonalComission" value="5" />
13	Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками NewDogovorServiceSvKey и NewDogovorServicePartnerKey.	Ключ услуги (Поле SL_KEY из таблицы [ServiceList]).	<add key="NewDogovorServiceServiceListKey" value="450" />
14	Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками NewDogovorServiceServiceListKey и NewDogovorServicePartnerKey.	Ключ класса услуги (Поле SV_KEY из таблицы [Service]).	<add key="NewDogovorServiceSvKey" value="1055" />
15	Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками NewDogovorServiceServiceListKey и NewDogovorServiceSvKey.	Ключ класса услуги (Поле PR_KEY из таблицы [Partners]).	<add key="NewDogovorServicePartnerKey" value="12921" />
16	Настройка, включающая расчет через Мастер Финанс.	false - расчет через Мастер Финанс не включен; true - расчет через Мастер Финанс включен.	<add key="AddPaymentsToMasterFinance" value="false"/>

PayOnline

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

№	Описание	Значение	Настройка
1	Ключ сайта. Обязательная настройка.	Merchant ID сайта в системе «PayOnline».	<add key="merchantId" value="2898" />
2	Ключ. Обязательная настройка.	Security key в Параметрах интеграции сайта в системе «PayOnline».	<add key="privateSecurityKey" value="XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX" />
3	Сопоставление кодов валют из ПК «Мастер-Тур» с кодом валюты в системе «PayOnline».	В качестве параметра key указывается код валюты из ПК «Мастер-Тур», в качестве параметра value задается код валюты в системе «PayOnline», например:	<add key="рб" value="RUB"/> <add key="$" value="USD"/> <add key="EU" value="EUR"/>
4	Настройка, определяющая код валюты, в которой будет совершаться платеж через платежную систему «PayOnline» при значении DefinedBySettings настройки currencyToPay.	Код валюты (Поле RA_CODE из таблицы [Rates]).	<add key="currency" value="рб" />
5	Настройка, определяющая валюту, в которой будет совершаться платеж через систему «PayOnline». Обязательная настройка.	Contract - оплата в валюте путевки; Tour - оплата в валюте тура; National – оплата в национальной валюте; DefinedBySettings - оплата в валюте, определенной настройкой Сurrency.	<add key="currencyToPay" value="Contract" />
6	Настройка, определяющая тип операции при проведении платежа. Обязательная настройка.	Ключ операции (Поле PO_ID из таблицы [PaymentOperations]).	<add key="kindOfPay" value="6" />
7	Настройка, определяющая пользователя ПК «Мастер-Тур», к которому будет привязываться оплата. Обязательная настройка.	Ключ пользователя, к которому привязывается оплата (Поле US_KEY из таблицы [UserList]).	<add key="masterTourUser" value="80" />
8	Настройка, определяющая партнера, к которому будет привязываться оплата. Обязательная настройка.	Ключ филиала, к которому привязывается оплата (Поле PR_KEY из таблицы [Partners]).	<add key="paymentFilialKey" value="1" />
9	Настройка, определяющая отдел, к которому будет привязываться оплата. Обязательная настройка.	Ключ отдела (кассы), к которому привязывается оплата (Поле PDP_KEY из таблицы [PrtDeps]).	<add key="departmentKey" value="2" />
10	Настройка, определяющая тип операции при проведении платежа	Ключ операции из таблицы [PaymentOperations]	<add key="paymentOperationId" value="1"/>
11	Настройка, определяющая тип операции при проведении платежа для комиссий.	Ключ операции (Поле PO_ID из таблицы [PaymentOperations]).	<add key="paymentOperationCommissionId" value="6" />
12	Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для агентств). Обязательная настройка.	Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется запятой). Комиссия указывается в процентах. Сумма оплаты вычисляется следующим образом: Если из конечной суммы платежа в системе «PayOnline» вычесть указанный процент - получится стоимость путевки. Пример: Стоимость путевки - 100 у.е. В настройке указана комиссия - 50%. Итоговая сумма платежа в системе «PayOnline» - 200 у.е. 200 у.е. - 50% * 200 у.е. = 100 у.е. (стоимость путевки).	<add key="addAgencyComission" value="3,627" />
13	Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для частных лиц). Обязательная настройка.	Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется запятой). Комиссия указывается в процентах. Сумма оплаты вычисляется следующим образом: Если из конечной суммы платежа в системе «PayOnline» вычесть указанный процент - получится стоимость путевки. Пример: Стоимость путевки - 100 у.е. В настройке указана комиссия - 50%. Итоговая сумма платежа в системе «PayOnline» - 200 у.е. 200 у.е. - 50% * 200 у.е. = 100 у.е. (стоимость путевки).	<add key="addPersonalComission" value="5" />
14	Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками NewDogovorServiceSvKey и NewDogovorServicePartnerKey.	Ключ услуги (Поле SL_KEY из таблицы [ServiceList]).	<add key="NewDogovorServiceServiceListKey" value="450" />
15	Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками NewDogovorServiceServiceListKey и NewDogovorServicePartnerKey.	Ключ класса услуги (Поле SV_KEY из таблицы [Service]).	<add key="NewDogovorServiceSvKey" value="1055" />
16	Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками NewDogovorServiceServiceListKey и NewDogovorServiceSvKey.	Ключ класса услуги (Поле PR_KEY из таблицы [Partners]).	<add key="NewDogovorServicePartnerKey" value="12921" />
17	Настройка, включающая расчет через Мастер Финанс.	false - расчет через Мастер Финанс не включен; true - расчет через Мастер Финанс включен.	<add key="AddPaymentsToMasterFinance" value="false"/>

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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


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

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

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

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

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

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

Ошибка SecureChannelFailure

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

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

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

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

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

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

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

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

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

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

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

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

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