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

Материал из Megatec
Перейти к: навигация, поиск

Содержание

Введение

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


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



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

№ Описание Значение Настройка
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.

Также поддерживается прием оплат через платежную систему Юкасса с использованием API Сбербанка. В данном случае клиент подключает в Юкасса возможность работы по API Сбербанка, после чего Юкасса выдает:

  • логин
  • пароль
  • ссылку на платежный шлюз

При использовании Юкасса по API Сбербанка необходимо указать в настройках секции <Sberbank> логин и пароль, выданные Юкасса, а также заменить ссылку на платежный шлюз на предоставленную Юкасса.

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

При использовании Юкасса по API Сбербанка используется логин, выданный Юкасса.
Обязательная настройка.

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

При использовании Юкасса по API Сбербанка используется пароль, выданный Юкасса.
Обязательная настройка.

Пароль клиента 
<add key="password" value="пароль sberbank-api" />
3 Ссылка на платежный шлюз Sberbank.

Также поддерживается прием оплат через Юкасса по API Сбербанка. В этом случае необходимо указать ссылку на шлюз, предоставленную Юкасса.

Аналогично настройке link в секции Sberbank в разделе<paymentMethods>

Пример ссылки, предоставляемой Юкасса:
https://3dsec-payments.yookassa.ru/payment/rest/ 

<add key="sberbankPaymentApplicationUrl" value="https://securepayments.sberbank.ru/payment/rest/" />



<add key="sberbankPaymentApplicationUrl" value="https://3dsec-payments.yookassa.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». Данное сопоставление задаетс