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

Материал из Megatec
Перейти к: навигация, поиск
[досмотренная версия][досмотренная версия]
(→‎Формирование чеков Alfabank)
(→‎Sberbank)
 
Строка 528: Строка 528:
 
Настройки задаются в секции <code><Sberbank></code> файла <code>web.config</code> приложения '''EntryPoint'''. При использовании SberbankMir или SberbankMir необходимо заполнить соответствующие секции в файле <code>web.config</code>.
 
Настройки задаются в секции <code><Sberbank></code> файла <code>web.config</code> приложения '''EntryPoint'''. При использовании SberbankMir или SberbankMir необходимо заполнить соответствующие секции в файле <code>web.config</code>.
 
<br /><br />
 
<br /><br />
 +
 +
Также поддерживается прием оплат через платежную систему '''Юкасса''' с использованием '''API Сбербанка'''.
 +
В данном случае клиент подключает в Юкасса возможность работы по API Сбербанка, после чего Юкасса выдает:
 +
* '''логин'''
 +
* '''пароль'''
 +
* '''ссылку на платежный шлюз'''
 +
 +
При использовании Юкасса по API Сбербанка необходимо указать в настройках секции <code><Sberbank></code> логин и пароль, выданные Юкасса, а также заменить ссылку на платежный шлюз на предоставленную Юкасса.
 +
<br /><br />
 +
 
{| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse"
 
{| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse"
  
Строка 540: Строка 550:
  
 
| 1
 
| 1
−
| Идентификатор клиента, который выдается платежной системой Sberbank.
+
| Идентификатор клиента, который выдается платежной системой Sberbank.<br /><br />
 +
При использовании '''Юкасса по API Сбербанка''' используется логин, выданный Юкасса.<br />
 
Обязательная настройка.
 
Обязательная настройка.
 
| '''Идентификатор клиента'''  
 
| '''Идентификатор клиента'''  
Строка 546: Строка 557:
 
<add key="userName" value="логин sberbank-api" />
 
<add key="userName" value="логин sberbank-api" />
 
</syntaxhighlight>
 
</syntaxhighlight>
 +
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
 
| 2
 
| 2
−
| Пароль клиента, который выдается платежной системой Sberbank.
+
| Пароль клиента, который выдается платежной системой Sberbank.<br /><br />
 +
При использовании '''Юкасса по API Сбербанка''' используется пароль, выданный Юкасса.<br />
 
Обязательная настройка.
 
Обязательная настройка.
 
| '''Пароль клиента'''  
 
| '''Пароль клиента'''  
Строка 554: Строка 567:
 
<add key="password" value="пароль sberbank-api" />
 
<add key="password" value="пароль sberbank-api" />
 
</syntaxhighlight>
 
</syntaxhighlight>
 +
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
 
| 3
 
| 3
−
| Ссылка на платежный шлюз Sberbank
+
| Ссылка на платежный шлюз Sberbank.<br /><br />
−
|Аналогично настройке link в секции Sberbank в разделе<paymentMethods>
+
Также поддерживается прием оплат через '''Юкасса''' по '''API Сбербанка'''. В этом случае необходимо указать ссылку на шлюз, предоставленную Юкасса.
 +
|Аналогично настройке link в секции Sberbank в разделе<paymentMethods><br /><br />
 +
Пример ссылки, предоставляемой Юкасса:<br />
 +
<code>https://3dsec-payments.yookassa.ru/payment/rest/</code>
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
 
<add key="sberbankPaymentApplicationUrl" value="https://securepayments.sberbank.ru/payment/rest/" />
 
<add key="sberbankPaymentApplicationUrl" value="https://securepayments.sberbank.ru/payment/rest/" />
 +
</syntaxhighlight>
 +
<br />
 +
<syntaxhighlight lang="xml" enclose="div">
 +
<add key="sberbankPaymentApplicationUrl" value="https://3dsec-payments.yookassa.ru/payment/rest/" />
 
</syntaxhighlight>
 
</syntaxhighlight>
  
Строка 581: Строка 602:
 
<add key="useFiscalization" value="false"/>
 
<add key="useFiscalization" value="false"/>
 
</syntaxhighlight>
 
</syntaxhighlight>
 +
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
−
 
 
| 6
 
| 6
 
| Настройка, определяющая '''тип операции при проведении платежа'''.
 
| Настройка, определяющая '''тип операции при проведении платежа'''.
Строка 592: Строка 613:
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
−
 
 
| 7
 
| 7
 
| Настройка, определяющая '''тип операции при проведении платежа для комиссий'''.
 
| Настройка, определяющая '''тип операции при проведении платежа для комиссий'''.
Строка 603: Строка 623:
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
−
 
 
| 8
 
| 8
 
| Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для агентств''').<br>
 
| Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для агентств''').<br>
Строка 615: Строка 634:
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
−
 
 
| 9
 
| 9
 
| Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для частных лиц''').<br>
 
| Настройка, позволяющая задавать '''размер комиссии''', которая будет '''включена в сумму оплаты''' ('''для частных лиц''').<br>
Строка 626: Строка 644:
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
−
 
 
| 10
 
| 10
 
| Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками ''NewDogovorServiceSvKey'' и ''NewDogovorServicePartnerKey''.
 
| Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками ''NewDogovorServiceSvKey'' и ''NewDogovorServicePartnerKey''.
Строка 635: Строка 652:
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
−
 
 
| 11
 
| 11
 
| Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServicePartnerKey''.
 
| Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServicePartnerKey''.
Строка 644: Строка 660:
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
−
 
 
| 12
 
| 12
 
| Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServiceSvKey''.
 
| Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками ''NewDogovorServiceServiceListKey'' и ''NewDogovorServiceSvKey''.
Строка 653: Строка 668:
  
 
|- style="vertical-align:text-top"
 
|- style="vertical-align:text-top"
−
 
 
| 13
 
| 13
 
| Настройка, включающая расчет через Мастер финанс.
 
| Настройка, включающая расчет через Мастер финанс.

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

Содержание

Введение

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


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



Модуль EntryPoint предоставляет возможность покупателю/агентству выбрать способ оплаты путевок. Оплата путевок может осуществляться в экранах «Список заявок» (OrderList.aspx) и «Путевка» (OrderInfo.aspx).
В данный момент доступны следующие способы оплаты:

  • Alfabank
  • Sberbank
  • Tinkoff (Т-Банк)
  • Uniteller
  • YandexPay
  • Assist
  • WebPay
  • PayOnline

Установка

Для установки дополнительного модуля EntryPoint нужно создать директорию EntryPoint в каталоге C:/inetpub/wwwroot (корневом каталоге IIS) и выложить туда распакованные файлы из архива
mw-paymentSystem-entryPoin-15.8.0.xxxxxx.zip.
В управлении IIS необходимо создать виртуальный каталог для папки EntryPoint.

Создание виртуального каталога

По умолчанию корневым каталогом IIS является C:/Inetpub/wwwroot. Для создания виртуального каталога для приложения находящегося в этом каталоге нужно выполнить следующие действия:
1 Зайти в Пуск (Start) → Настройки (Settings) → Панель управления (Control Panel) → Администрирование (Administrative Tools)
Панель управления

2 Диспетчер служб IIS
Администрирование - Диспетчер служб IIS

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

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

Настройка

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

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

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

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

№ Описание Значение Настройка
1 Включение дополнительного модуля EntryPoint.

Обязательная настройка.

- true - модуль EntryPoint включен

- false или отсутствие настройки - модуль EntryPoint выключен 

<add key="usePaymentEntryPoint" value="true"/>
2 Включение дополнительного модуля EntryPoint.

Обязательная настройка.

- Путь к приложению «EntryPoint». 
 <add key="paymentsLink" value="http://somesite/EntryPoint" />
3 Настройка, определяющая статусы путевок, при которых доступна возможность оплаты через систему электронных платежей.

Обязательная настройка.

- ключи статусов из таблицы [Order_Status], при которых доступна оплата через систему электронных платежей. 
<add key="paymentsStatuses" value="7,37" />
4 Настройка, позволяющая выводить предупреждающее сообщение о снятии комиссии при оплате. – true — сообщение отображается;

– false или отсутствие настройки — сообщение не отображается. 

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

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

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

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

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

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

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

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

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

true или отсутствие настройки - хэширование пароля в файлах cookie включено. 

<add key="HashPasswordForCookie" value="true" />
4 Настройка интервала опроса платежной системы для проверки статуса незавершенных платежей.

Интервал опроса платежной системы в минутах для проверки статуса незавершенных платежей. При отсутствии настройки или указании значения меньше 3 опрос осуществляется раз в 3 минуты. Опрос осуществляется через указанное количество минут до времени указанного в настройке "TimeInMinuteForCheckStatePayments" 

<add key ="TimeoutInMinuteForPollPaymentSystem" value="3"/>
5 Настройка задержки проверки статуса платежа на платежной системе.

Отсрочка проверки статуса платежа с момента перехода на платежный шлюз, если платеж сразу не прошел в системе банка. Если по истечении этого времени статус платежа на стороне банка не станет оплаченным, то платеж в ПК "Мастер-Тур" не отобразится. При отсутствии настройки или указании значения меньше 10 отсрочка составляет 10 минут. 

<add key ="TimeInMinuteForCheckStatePayments" value="10"/>
6 Текст правил оплаты

Правила оплаты берутся из файла AgreementText.htm Если данный файл отсутствует, то описание правил оплаты берется из стандартного файла AgreementText_Standard.htm 

<add key="agreementText" value="templates/AgreementText.htm" />
7 Настройка способа учёта типов тура из <paymentAvailabilities> (атрибут tourTypes) при определении доступности оплаты. Если value="true", оплата доступна только когда у тура присутствуют все типы, указанные в tourTypes. Если false или настройка отсутствует – оплата доступна, когда у тура есть хотя бы один тип из tourTypes. false или отсутствие настройки – оплата доступна при наличии хотя бы одного типа из tourTypes;

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

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

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

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

<paymentMethods>
    <add code="1" name="Tinkoff" logoLink="~/Content/logos/logoTinkoff.png" maximumAmount="1000000" skipDescriptionPage="false" paymentSystem="Tinkoff" link="https://securepay.tinkoff.ru/v2/Init/" />	
</paymentMethods>
  • code="1" - идентификатор платежного метода, должен быть уникальным. Используется в других секциях, для ссылки на данный метод оплаты;
  • name="Tinkoff" - название платежной системы (если не задана ссылка на логотип, то отображается кнопка с наименованием данного поля);
  • paymentSystem="Tinkoff" - название платежной системы. Одно из предопределенных значений:
    • Alfabank
    • Sberbank и SberbankMir, SberbankChildren
    • Tinkoff
    • Uniteller и UnitellerMir, UnitellerChildren
    • Assist
    • WebPay
    • PayOnline
  • LogoLink - расположение логотипа способа оплаты;
  • maximumAmount - максимальный размер платежа;
  • skipDescriptionPage - отображать экран редактирования оплаты или сразу выполнять платеж с текущими значениями.

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

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

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

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

<paymentAvailabilities>
<add code="1" paymentMethodCode="1" countryCode="7" filialCode="1" consumerCode="Person" isAvailable="false" priority="100" tourTypes="2"/>
</paymentAvailabilities>
  • code – идентификатор доступности способа оплаты, должен быть уникальным;
  • paymentMethodCode – идентификатор способа оплаты (code) из секции paymentMethod;
  • countryCode – ограничение доступности метода оплаты по ключу страны (cn_key из таблицы tbl_country). Может быть пустым - доступен для всех стран;
  • filialCode – ограничение доступности метода оплаты по коду партнера-филиала из его карточки (поле PR_COD). Может быть пустым - доступен для всех филиалов;
  • consumerCode – ограничение по типу забронировавшего: турист или агентство. Person – для частных лиц, Agency – для турагентств;
  • isAvailable – включено или выключено это ограничение. Значение false равносильно отсутствию строки в секции;
  • priority – приоритет при выборе нескольких доступных вариантов оплаты;
  • tourTypes – ограничение доступности метода оплаты по ключу типа тура (tp_key из таблицы TipTur). Отсутствие параметра или пустой параметр – оплата доступна для всех типов туров (допускается внесение нескольких параметров через ","). Если требуется оплата с типом тура Индивидуально, то в настройку необходимо добавить ключ 0

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

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

Alfabank

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

№ Описание Значение Настройка
1 Точки продажи (shop_ID)

Обязательная настройка.

Shop_ID из раздела Точки продажи ЛК «Alfabank». 
<add key="shop_id" value="32565" />
2 Логин

Обязательная настройка.

Login из раздела Параметры авторизации ЛК «Alfabank». 
<add key="login" value="megatec" />
3 Пароль

Обязательная настройка.

Password из раздела Параметры авторизации ЛК «Alfabank». 
<add key="password" value="ХХХХХХХХХХ" />
4 Настройка, определяющая язык окна платежной формы «Alfabank».

Обязательная настройка.

  • ru - русский язык
  • en - английский язык
 
<add key="language" value="ru" />
5 Ссылка на платежный шлюз

Ссылка на платежный шлюз 

<add key="paymentSystemLoginURL" value="https://ws.egopay.ru/order/v2/" />
6 Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для агентств)

Для корректной работы настройки – в путевке должно быть выбрано лицо, заключающее договор (представитель агентства).

Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется запятой). Комиссия указывается в процентах. 

<add key="addAgencyComission" value="15,8" />
7 Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для частных лиц)

Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется запятой). Комиссия указывается в процентах. 

<add key="addPersonalComission" value="17,4" />
8 Настройка, определяющая пользователя ПК «Мастер-Тур», к которому будет привязываться оплата.

Обязательная настройка.

Ключ пользователя, к которому привязывается оплата (Поле US_KEY из таблицы [UserList]). 
<add key="masterTourUser" value="0" />
9 Настройка, определяющая отдел, к которому будет привязываться оплата.

Обязательная настройка.

Ключ отдела (кассы), к которому привязывается оплата (Поле PDP_KEY из таблицы [PrtDeps]). 
<add key="departmentKey" value="0" />
10 Настройка, включающая расчет через Мастер финанс.
  • false - расчет через мастер финанс не включен;
  • true - расчет через мастер финанс включен.
 
<add key="AddPaymentsToMasterFinance" value="false"/>
11 Настройка, определяющая тип операции при проведении платежа.

Обязательная настройка.

Ключ операции (Поле PO_ID из таблицы [PaymentOperations]). 
<add key="PaymentOperationId" value="6" />
12 Настройка, определяющая тип операции при проведении платежа для комиссий. Ключ операции (Поле PO_ID из таблицы [PaymentOperations]). 
<add key="paymentOperationCommissionId" value="" />
13 Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками NewDogovorServiceSvKey и NewDogovorServicePartnerKey. Ключ услуги (Поле SL_KEY из таблицы [ServiceList]).

Название услуги комиссии в путевке берется из этого параметра 

<add key="NewDogovorServiceServiceListKey" value="450" />
14 Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками NewDogovorServiceServiceListKey и NewDogovorServicePartnerKey. Ключ класса услуги (Поле SV_KEY из таблицы [Service]).

Название услуги комиссии в путевке берется из этого параметра 

<add key="NewDogovorServiceSvKey" value="1055" />
15 Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками NewDogovorServiceServiceListKey и NewDogovorServiceSvKey. Ключ класса услуги (Поле PR_KEY из таблицы [Partners]). 
<add key="NewDogovorServicePartnerKey" value="12921" />
16 Настройка, определяющая адрес электронной почты по умолчанию. Используется в том случае, если не указан адрес электронной почты главного туриста. 
<add key="defaultEmail" value="" />


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

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

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