Платежные web-сервисы: Сервис интеграции с платежной системой Tinkoff (Т-Банк) (оплата картой в личном кабинете) — различия между версиями

Материал из Megatec
Перейти к: навигация, поиск
[непроверенная версия][досмотренная версия]
(→‎Настройки приложения «Система онлайн платежей»)
(→‎Настройки приложения «Система онлайн платежей»)
 
(не показаны 4 промежуточные версии 2 участников)
Строка 1: Строка 1:
 
Версия статьи от {{REVISIONDAY}}-{{REVISIONMONTH}}-{{REVISIONYEAR}}
 
Версия статьи от {{REVISIONDAY}}-{{REVISIONMONTH}}-{{REVISIONYEAR}}
−
[[Файл: mb_030.png|left|Предупреждение]] <BR> Начиная с релиза 15.8 после 01.06.2023 работа с отдельными платежными шлюзами не поддерживается. Для работы необходимо использовать новую версию приложения [[Платежные web-сервисы:EntryPoint|EntryPoint (оплата картой в личном кабинете с выбором системы оплаты)]] с поддержкой Uniteller, Sberbank, Tinkoff, Alfabank, Assist, PayOnline, WebPay без установки сторонних библиотек и развертывания отдельных сервисов.<br />
+
[[Файл: mb_030.png|left|Предупреждение]] <BR> Начиная с релиза 15.8 после 01.06.2023 работа с отдельными платежными шлюзами не поддерживается. Для работы необходимо использовать новую версию приложения [[Платежные web-сервисы:EntryPoint|EntryPoint (оплата картой в личном кабинете с выбором системы оплаты)]] с поддержкой Uniteller, Sberbank, Tinkoff (Т-Банк), Alfabank, Assist, PayOnline, WebPay без установки сторонних библиотек и развертывания отдельных сервисов.<br />
 
<br><br />
 
<br><br />
 
==Введение==
 
==Введение==
 
[[Файл: mb_030.png|left|Предупреждение]] <BR> Перед началом работы с платежными системами необходимо удостовериться в соответствии оборудования и программного обеспечения [[Мастер-Тур(15):Системно-аппаратные требования|системно-аппаратным требованиям]]. Если версия операционной системы не соответствует рекомендуемой, то работа с платежными сервисами не гарантирована в связи с ограничениями протоколов безопасности операционной системы.<br />
 
[[Файл: mb_030.png|left|Предупреждение]] <BR> Перед началом работы с платежными системами необходимо удостовериться в соответствии оборудования и программного обеспечения [[Мастер-Тур(15):Системно-аппаратные требования|системно-аппаратным требованиям]]. Если версия операционной системы не соответствует рекомендуемой, то работа с платежными сервисами не гарантирована в связи с ограничениями протоколов безопасности операционной системы.<br />
 
<br><br />
 
<br><br />
−
Данный модуль реализует возможность оплаты путевок через систему электронных платежей '''«Tinkoff»'''.<br />
+
Данный модуль реализует возможность оплаты путевок через систему электронных платежей '''«Tinkoff» (Т-Банк)'''.<br />
−
Широкое распространение «Tinkoff» позволяет предоставить возможность онлайн оплаты большому количеству пользователей. Особенно полезным данный модуль может быть туристическим компаниям, ориентированным на работу с частными клиентами.
+
Широкое распространение «Tinkoff (Т-Банк)» позволяет предоставить возможность онлайн оплаты большому количеству пользователей. Особенно полезным данный модуль может быть туристическим компаниям, ориентированным на работу с частными клиентами.
  
 
==Установка==  
 
==Установка==  
−
Для установки дополнительного модуля '''Сервис интеграции с платежной системой «Tinkoff»''' нужно создать директорию '''Tinkoff''' в каталоге <code>C:/inetpub/wwwroot</code> (корневом каталоге '''IIS''')  и выложить туда распакованные файлы из архива<br />
+
Для установки дополнительного модуля '''Сервис интеграции с платежной системой «Tinkoff (Т-Банк)»''' нужно создать директорию '''Tinkoff (Т-Банк)''' в каталоге <code>C:/inetpub/wwwroot</code> (корневом каталоге '''IIS''')  и выложить туда распакованные файлы из архива<br />
 
<code>payments-tinkoff-X.X.XX.XXXXX.zip</code>.<br>Устанавливать дополнительный модуль необходимо в том же домене, где расположено основное приложение ПК «Мастер-Web».<br />Начиная с релиза '''15.5''', если используется [[Платежные web-сервисы: Выбор платежной системы (оплата картой в личном кабинете)|дополнительный модуль Выбор платежной системы (оплата картой в личном кабинете)]], то необходимо скопировать файл <code>Megatec.MasterWeb.PaymentSystem.Tinkoff.dll</code> из '''<code>/Tinkoff/bin/</code>''' и разместить в папке '''<code>/EntryPoint/bin/</code>'''.<br>
 
<code>payments-tinkoff-X.X.XX.XXXXX.zip</code>.<br>Устанавливать дополнительный модуль необходимо в том же домене, где расположено основное приложение ПК «Мастер-Web».<br />Начиная с релиза '''15.5''', если используется [[Платежные web-сервисы: Выбор платежной системы (оплата картой в личном кабинете)|дополнительный модуль Выбор платежной системы (оплата картой в личном кабинете)]], то необходимо скопировать файл <code>Megatec.MasterWeb.PaymentSystem.Tinkoff.dll</code> из '''<code>/Tinkoff/bin/</code>''' и разместить в папке '''<code>/EntryPoint/bin/</code>'''.<br>
−
В '''управлении IIS''' необходимо создать ''виртуальный каталог'' для папки '''Tinkoff'''.
+
В '''управлении IIS''' необходимо создать ''виртуальный каталог'' для папки '''T-Bank'''.
  
 
===Создание виртуального каталога===
 
===Создание виртуального каталога===
Строка 29: Строка 29:
  
 
===Подключение к базе данных ПК «Мастер-Тур»===
 
===Подключение к базе данных ПК «Мастер-Тур»===
−
В файле <code>web.config</code>, расположенном в папке '''Tinkoff''' пропишите необходимые параметры подключения (<span style="color:red">красным цветом</span> выделены значения, которые необходимо ввести).
+
В файле <code>web.config</code>, расположенном в папке '''T-Bank''' пропишите необходимые параметры подключения (<span style="color:red">красным цветом</span> выделены значения, которые необходимо ввести).
 
Строка подключения к базе данных ПК «Мастер-Тур»:<br />
 
Строка подключения к базе данных ПК «Мастер-Тур»:<br />
 
<code><add key = "connectionString" value = "Data Source=<span style="color:red">ip-адрес сервера базы данных ПК «Мастер-Тур»</span>;Initial Catalog=<span style="color:red">название базы данных ПК «Мастер-Тур»</span>;User ID=<span style="color:red">логин пользователя ПК «Мастер-Тур»</span>;Password=<span style="color:red">пароль пользователя ПК «Мастер-Тур»</span>"/></code>
 
<code><add key = "connectionString" value = "Data Source=<span style="color:red">ip-адрес сервера базы данных ПК «Мастер-Тур»</span>;Initial Catalog=<span style="color:red">название базы данных ПК «Мастер-Тур»</span>;User ID=<span style="color:red">логин пользователя ПК «Мастер-Тур»</span>;Password=<span style="color:red">пароль пользователя ПК «Мастер-Тур»</span>"/></code>
  
 
==Настройка==  
 
==Настройка==  
−
После установки надстройка '''Сервис интеграции с платежной системой Tinkoff''' доступна в экранах [[Мастер-Web:Руководство пользователя. Работа в системе online бронирования#Просмотр списка забронированных туров|«Список заявок»]] и [[Мастер-Web:Руководство пользователя. Работа в системе online бронирования#Просмотр подробной информации о заказе|«Информация о заказе»]].
+
После установки надстройка '''Сервис интеграции с платежной системой Tinkoff (Т-Банк)''' доступна в экранах [[Мастер-Web:Руководство пользователя. Работа в системе online бронирования#Просмотр списка забронированных туров|«Список заявок»]] и [[Мастер-Web:Руководство пользователя. Работа в системе online бронирования#Просмотр подробной информации о заказе|«Информация о заказе»]].
  
 
===Настройки ПК «Мастер-Web»===
 
===Настройки ПК «Мастер-Web»===
Строка 62: Строка 62:
  
 
| 2
 
| 2
−
| Настройка, определяющая '''статусы путевок''', при которых '''доступна возможность оплаты''' через систему электронных платежей «Tinkoff».
+
| Настройка, определяющая '''статусы путевок''', при которых '''доступна возможность оплаты''' через систему электронных платежей «Tinkoff (Т-Банк)».
 
Обязательная настройка.
 
Обязательная настройка.
−
| '''Ключи статусов''' из таблицы <code>'''[Order_Status]'''</code>, при которых ''доступна оплата'' через «Tinkoff».
+
| '''Ключи статусов''' из таблицы <code>'''[Order_Status]'''</code>, при которых ''доступна оплата'' через «Tinkoff (Т-Банк)».
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
 
<add key="paymentsStatuses" value="7,37" />
 
<add key="paymentsStatuses" value="7,37" />
Строка 123: Строка 123:
  
 
===Настройки приложения «Система онлайн платежей»===
 
===Настройки приложения «Система онлайн платежей»===
−
[[Файл: mb_030.png|left|Предупреждение]] <BR> Начиная с релиза 15.9 в приложении [[Платежные web-сервисы:EntryPoint|EntryPoint (оплата картой в личном кабинете с выбором системы оплаты)]] для Tinkoff разделили шлюзы для оплаты с карты и по QR коду, давая возможность тонкой настройки каждого шлюза отдельно.<br />
+
[[Файл: mb_030.png|left|Предупреждение]] <BR> Начиная с релиза 15.9 в приложении [[Платежные web-сервисы:EntryPoint|EntryPoint (оплата картой в личном кабинете с выбором системы оплаты)]] для Tinkoff (Т-Банк) разделили шлюзы для оплаты с карты и по QR коду, давая возможность тонкой настройки каждого шлюза отдельно.<br />
−
Настройки задаются в секции <code><Tinkoff></code> или <code><TinkoffQR></code> файла <code>web.config</code> приложения '''Система онлайн платежей''' в зависимости от настраиваемого шлюза.
+
Настройки задаются в секции <code><Tinkoff></code> или <code><TinkoffQR></code> файла <code>web.config</code> приложения '''Система онлайн платежей''' в зависимости от настраиваемого шлюза.<br /><br />
  
 
{| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse"
 
{| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse"
Строка 140: Строка 140:
 
| '''Адрес платежной службы'''
 
| '''Адрес платежной службы'''
 
Обязательная настройка.
 
Обязательная настройка.
−
| Адрес сервиса оплаты через карту банка «Tinkoff».
+
| Адрес сервиса оплаты через карту банка «Tinkoff (Т-Банк)».
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
 
<add key="LoginUrl" value="https://securepay.tinkoff.ru/v2/Init"/>
 
<add key="LoginUrl" value="https://securepay.tinkoff.ru/v2/Init"/>
Строка 152: Строка 152:
 
| '''Адрес для оплаты по QR коду'''
 
| '''Адрес для оплаты по QR коду'''
 
Обязательная настройка.
 
Обязательная настройка.
−
| Адрес сервиса оплаты через карту банка «Tinkoff» по QR коду.
+
| Адрес сервиса оплаты через карту банка «Tinkoff (Т-Банк)» по QR коду.
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
 
<add key="QRCodeUrl" value="https://securepay.tinkoff.ru/v2/GetQr"/>
 
<add key="QRCodeUrl" value="https://securepay.tinkoff.ru/v2/GetQr"/>
Строка 182: Строка 182:
 
| '''Идентификатор терминала'''
 
| '''Идентификатор терминала'''
 
Обязательная настройка.
 
Обязательная настройка.
−
| Параметр '''Терминал''' из раздела Терминалы в л/к сервиса «Tinkoff».
+
| Параметр '''Терминал''' из раздела Терминалы в л/к сервиса «Tinkoff (Т-Банк)».
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
 
<add key="TerminalKey" value="1587990738"/>
 
<add key="TerminalKey" value="1587990738"/>
Строка 192: Строка 192:
 
| '''Пароль терминала'''
 
| '''Пароль терминала'''
 
Обязательная настройка.
 
Обязательная настройка.
−
| Параметр '''Пароль''' из раздела Терминалы в л/к сервиса «Tinkoff».
+
| Параметр '''Пароль''' из раздела Терминалы в л/к сервиса «Tinkoff (Т-Банк)».
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
 
<add key="TerminalPassword" value="cn5du3jxcfbmwtyuii"/>
 
<add key="TerminalPassword" value="cn5du3jxcfbmwtyuii"/>
Строка 200: Строка 200:
  
 
| 7
 
| 7
−
| Настройка, определяющая '''язык''' окна платежной формы «Tinkoff».
+
| Настройка, определяющая '''язык''' окна платежной формы «Tinkoff (Т-Банк)».
 
Обязательная настройка.
 
Обязательная настройка.
 
|  
 
|  
Строка 404: Строка 404:
  
 
| 1
 
| 1
−
| Настройка, определяющая '''дату''', на которую будет '''подбираться курс валют''' для пересчета '''суммы к оплате'''.
+
| '''Платежный метод'''
−
| * '''~/Content/logos/logoTinkoff.png''' путь до лого платежного шлюза;
+
Обязательная настройка.
−
* '''code"''' — код определяющий какому шлюзу оплаты принадлежит эта настройка (для Tinkoff это значение по умолчанию равно "12", для TinkoffQR равно "20");
+
| способ оплаты в платежной системе «Tinkoff (Т-Банк)».
−
* '''name''' — имя задаваемое для шлюза;
+
*'''code="1"''' – идентификатор платежного метода, должен быть уникальным. Используется в других секциях, для ссылки на данный метод оплаты;
−
* '''maximumAmount''' - максимальная устанавливаемая сумма.
+
*'''name="Tinkoff"''' – название платежной системы (если не задана ссылка на логотип, то отображается кнопка с наименованием данного поля);
−
* '''skipDescriptionPage''' - пропустить страницу описания( значения могут быть false и true)
+
*'''paymentSystem="Tinkoff"''' – название платежной системы.  
−
* '''paymentSystem''' - название платежной системы.
+
*'''LogoLink''' – расположение логотипа способа оплаты;
 +
*'''maximumAmount''' – максимальный размер платежа;
 +
*'''skipDescriptionPage''' – отображать экран редактирования оплаты или сразу выполнять платеж с текущими значениями.
 +
**Если значение '''skipDescriptionPage=true''', то сразу происходит переход к оплате.
 +
**Если значение '''skipDescriptionPage=false''', то происходит переход на страницу редактирования суммы к оплате, а уже из нее переход к оплате на платежный шлюз.
 +
*'''displayWindowWithEditingRequestData''' – настройка включающая проверку e-mail и телефона плательщика, при отсутствии выводит модальное окно с просьбой ввести e-mail и телефон плательщика. после ввода данных отправлять на оплату.
 +
**'''false''' – проверка не проводится
 +
**'''true''' – проверка проводится
 
|<syntaxhighlight lang="xml" enclose="div">
 
|<syntaxhighlight lang="xml" enclose="div">
 
<add code="12" name="Платформа Tinkoff" logoLink="~/Content/logos/logoTinkoff.png"
 
<add code="12" name="Платформа Tinkoff" logoLink="~/Content/logos/logoTinkoff.png"
−
    maximumAmount="1000000"
+
    maximumAmount="1000000"
−
    skipDescriptionPage="false" paymentSystem="Tinkoff" />
+
    skipDescriptionPage="false" displayWindowWithEditingRequestData="true" paymentSystem="Tinkoff" />
 
</syntaxhighlight>
 
</syntaxhighlight>
−
|- style="vertical-align:text-top"
 
 
|}
 
|}
 +
<br />
  
 
  Начиная с релиза 15.8 появилась возможность добавления услуги комиссии от оплаты через платежный шлюз в путевку и формирования ПКО различным образом.
 
  Начиная с релиза 15.8 появилась возможность добавления услуги комиссии от оплаты через платежный шлюз в путевку и формирования ПКО различным образом.
Строка 430: Строка 437:
 
==Подготовка данных==
 
==Подготовка данных==
 
Оплату можно произвести по путевкам, '''статус''' которых указан в настройке '''paymentsStatuses'''.<br />
 
Оплату можно произвести по путевкам, '''статус''' которых указан в настройке '''paymentsStatuses'''.<br />
−
В разделе '''Терминалы''' л/к «Tinkoff» в настройке '''Ссылка для уведомлений''' необходимо указать URL-адрес уведомления магазина в формате: ''somesite/Tinkoff/Payment.aspx?action=reply''.
+
В разделе '''Терминалы''' л/к «Tinkoff (Т-Банк)» в настройке '''Ссылка для уведомлений''' необходимо указать URL-адрес уведомления магазина в формате: ''somesite/Tinkoff/Payment.aspx?action=reply''.
  
 
==Работа в системе==
 
==Работа в системе==
Строка 473: Строка 480:
 
<br />
 
<br />
  
−
Для оплаты путевки через '''систему электронных платежей «Tinkoff»''' необходимо нажать ссылку '''Оплатить''' для нужной путевки или кнопку '''Оплатить on-line''' в экране '''Информация о заказе'''.
+
Для оплаты путевки через '''систему электронных платежей «Tinkoff (Т-Банк)»''' необходимо нажать ссылку '''Оплатить''' для нужной путевки или кнопку '''Оплатить on-line''' в экране '''Информация о заказе'''.
  
 
Для оплаты путевки необходимо ввести '''данные банковской карты''', с помощью которой производится оплата:
 
Для оплаты путевки необходимо ввести '''данные банковской карты''', с помощью которой производится оплата:
Строка 482: Строка 489:
 
После того, как '''все поля заполнены''', нужно нажать на кнопку '''Оплатить'''.
 
После того, как '''все поля заполнены''', нужно нажать на кнопку '''Оплатить'''.
  
−
При '''успешном''' проведении платежа в базе '''автоматически создается проводка''' и у путевки '''прописывается сумма оплаты'''. На указанную электронную почту приходят квитанции об оплате, в л/к «Tinkoff» в разделе '''Операции''' со статусом ''Подтвержден'' появляются данные о проведенном платеже, включая номер путевки. Также в [[Мастер-Тур:Работа с группой путевок#История путевки|истории путевки]] добавляется запись об '''оплате через платежную систему «Tinkoff»'''.
+
При '''успешном''' проведении платежа в базе '''автоматически создается проводка''' и у путевки '''прописывается сумма оплаты'''. На указанную электронную почту приходят квитанции об оплате, в л/к «Tinkoff (Т-Банк)» в разделе '''Операции''' со статусом ''Подтвержден'' появляются данные о проведенном платеже, включая номер путевки. Также в [[Мастер-Тур:Работа с группой путевок#История путевки|истории путевки]] добавляется запись об '''оплате через платежную систему «Tinkoff (Т-Банк)»'''.
  
 
[[Category:Платежные web-сервисы]]
 
[[Category:Платежные web-сервисы]]
Строка 489: Строка 496:
  
 
[[Файл: am_063.png|left|Предупреждение]]<br />
 
[[Файл: am_063.png|left|Предупреждение]]<br />
−
Оплата доступна только после включения в личном кабинете «Tinkoff» приема оплат по QR коду.<br />
+
Оплата доступна только после включения в личном кабинете «Tinkoff (Т-Банк)» приема оплат по QR коду.<br />
 
На текущий момент оплата доступна если используется [[Платежные web-сервисы: Выбор платежной системы (оплата картой в личном кабинете)|дополнительный модуль Выбор платежной системы (оплата картой в личном кабинете)]].<br />
 
На текущий момент оплата доступна если используется [[Платежные web-сервисы: Выбор платежной системы (оплата картой в личном кабинете)|дополнительный модуль Выбор платежной системы (оплата картой в личном кабинете)]].<br />
 
Частичная оплата при оплате по QR-коду не предусмотрена в связи с ограничением системы быстрых платежей.
 
Частичная оплата при оплате по QR-коду не предусмотрена в связи с ограничением системы быстрых платежей.
 
<br ><br />
 
<br ><br />
−
Для оплаты путевки через '''систему электронных платежей «Tinkoff»''' необходимо нажать ссылку '''Оплатить''' для нужной путевки или кнопку '''Оплатить on-line''' в экране '''Информация о заказе'''.<br />
+
Для оплаты путевки через '''систему электронных платежей «Tinkoff (Т-Банк)»''' необходимо нажать ссылку '''Оплатить''' для нужной путевки или кнопку '''Оплатить on-line''' в экране '''Информация о заказе'''.<br />
−
Произойдет переход к выбору платежных систем в котором необходимо выбрать кнопку с логотипом «Tinkoff» и подписью «Оплата по QR».<br />
+
Произойдет переход к выбору платежных систем в котором необходимо выбрать кнопку с логотипом «Tinkoff (Т-Банк) оплата по QR».<br />
 
[[Файл: Ea_173.png|x500px|QR]]<br />
 
[[Файл: Ea_173.png|x500px|QR]]<br />
 
<br />
 
<br />
Строка 501: Строка 508:
 
[[Файл: am_063.png|left|Предупреждение]]<br />
 
[[Файл: am_063.png|left|Предупреждение]]<br />
 
После оплаты по QR коду переход на страницу, с которой совершалась оплата, невозможен в связи с функционалом работы Системы Быстрых Платежей.<br />
 
После оплаты по QR коду переход на страницу, с которой совершалась оплата, невозможен в связи с функционалом работы Системы Быстрых Платежей.<br />
 +
 
==Ошибка SecureChannelFailure==
 
==Ошибка SecureChannelFailure==
 
Появление такой ошибки может быть вызвано невозможностью установить TLS соединение, которое используется для передачи данных от платежной системы. Вызвано некорректными настройками брандмауэра/firewall или некорректными настройками сервера. В случае обнаружения закрытого канала TLS необходимо обратиться к администратору вашей интернет-сети.
 
Появление такой ошибки может быть вызвано невозможностью установить TLS соединение, которое используется для передачи данных от платежной системы. Вызвано некорректными настройками брандмауэра/firewall или некорректными настройками сервера. В случае обнаружения закрытого канала TLS необходимо обратиться к администратору вашей интернет-сети.

Текущая версия на 19:36, 2 октября 2024

Версия статьи от 2-10-2024

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


Начиная с релиза 15.8 после 01.06.2023 работа с отдельными платежными шлюзами не поддерживается. Для работы необходимо использовать новую версию приложения EntryPoint (оплата картой в личном кабинете с выбором системы оплаты) с поддержкой Uniteller, Sberbank, Tinkoff (Т-Банк), Alfabank, Assist, PayOnline, WebPay без установки сторонних библиотек и развертывания отдельных сервисов.



Введение

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


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



Данный модуль реализует возможность оплаты путевок через систему электронных платежей «Tinkoff» (Т-Банк).
Широкое распространение «Tinkoff (Т-Банк)» позволяет предоставить возможность онлайн оплаты большому количеству пользователей. Особенно полезным данный модуль может быть туристическим компаниям, ориентированным на работу с частными клиентами.

Установка

Для установки дополнительного модуля Сервис интеграции с платежной системой «Tinkoff (Т-Банк)» нужно создать директорию Tinkoff (Т-Банк) в каталоге C:/inetpub/wwwroot (корневом каталоге IIS) и выложить туда распакованные файлы из архива
payments-tinkoff-X.X.XX.XXXXX.zip.
Устанавливать дополнительный модуль необходимо в том же домене, где расположено основное приложение ПК «Мастер-Web».
Начиная с релиза 15.5, если используется дополнительный модуль Выбор платежной системы (оплата картой в личном кабинете), то необходимо скопировать файл Megatec.MasterWeb.PaymentSystem.Tinkoff.dll из /Tinkoff/bin/ и разместить в папке /EntryPoint/bin/.
В управлении IIS необходимо создать виртуальный каталог для папки T-Bank.

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

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

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

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

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

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

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

Настройка

После установки надстройка Сервис интеграции с платежной системой Tinkoff (Т-Банк) доступна в экранах «Список заявок» и «Информация о заказе».

Настройки ПК «Мастер-Web»

Настройки задаются в секции <appSettings> файла web.config основного приложения ПК «Мастер-Web».

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

Обязательная настройка.
Внимание! Путь к приложению обязательно должен содержать ссылку на приложение из внешней сети. В противном случае, она не будет работать.

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

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

Ключи статусов из таблицы [Order_Status], при которых доступна оплата через «Tinkoff (Т-Банк)». 
<add key="paymentsStatuses" value="7,37" />
3 Настройка, позволяющая выводить предупреждающее сообщение о снятии комиссии при оплате.
  • true — сообщение отображается;
  • false или отсутствие настройки — сообщение не отображается.
 
<add key="askUserBeforePayment" value="true" />
4 Настройка, включающая механизм хэширования пароля пользователя, сохраняемого в файлах cookie, что позволяет усилить безопасность ПК «Мастер-Web».

По умолчанию хэширование включено.
Важно!
Если данная настройка прописана в файле web.config основного приложения, то она должна быть прописана и в платежном сервисе с тем же значением.

  • false или отсутствие настройки - хэширование пароля в файлах cookie выключено;
  • true - хэширование пароля в файлах cookie включено.
 
<add key="HashPasswordForCookie" value="true" />
5 Настройка, определяющая партнеров в базе ПК «Мастер-Тур», которым разрешено осуществлять оплату путёвок онлайн.

  • Ключи партнеров таблицы [tbl_Partners], которым разрешена онлайн-оплата путёвок;
  • пустое значение или отсутствие настройки – онлайн-оплата путёвок доступна всем партнёрам.
 
<add key="allowedPaymentPartnerKeys" value="10764"/>
6 Настройка, позволяющая производить оплату в новой вкладке браузера.

Внимание! Настройка обрабатывается, начиная с релиза 9222SP0.
Важно!
Если данная настройка прописана в файле web.config основного приложения, то она должна быть прописана и в платежном сервисе с тем же значением.

  • false или отсутствие настройки - оплата производится в текущей вкладке браузера;
  • true - оплата производится в новой вкладке браузера.
 
<add key="OpenPaymentInNewWindow" value="true" />

Настройки приложения «Система онлайн платежей»

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


Начиная с релиза 15.9 в приложении EntryPoint (оплата картой в личном кабинете с выбором системы оплаты) для Tinkoff (Т-Банк) разделили шлюзы для оплаты с карты и по QR коду, давая возможность тонкой настройки каждого шлюза отдельно.

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

№ Описание Значение Настройка
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 Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками NewDogovorServiceSvKey и NewDogovorServicePartnerKey.

Обрабатывается с релиза 15.8.

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

Обрабатывается с релиза 15.8.

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

Обрабатывается с релиза 15.8.

Ключ класса услуги (Поле PR_KEY из таблицы [Partners]). 
<add key="NewDogovorServicePartnerKey" value="12921" />


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

№ Описание Значение Настройка
1 Имя текущей установленной службы. Наименование службы, к которой может обращаться текущий клиент (по значению настройки acceptableServices в MasterTourService). По умолчанию настройка не заполнена. Значение настройки должно быть явно задано.
 
<add key="acceptableServices" value=""/>
2 Включение режима записи нового платежа в систему «Мастер-Финанс». При этом в ПК «Мастер-Тур» платежи не сохраняются.
  • true - включена запись платежей в «Мастер-Финанс»;
  • false или отсутствие настройки - выключает запись платежей в «Мастер-Финанс».
 
<add key="AddPaymentsToMasterFinance" value="true" />
3 Настройка, определяющая дату, на которую будет подбираться курс валют для пересчета суммы к оплате.
  • FixationDate или отсутствие настройки - курс на дату последней фиксации путевки на момент совершения платежа, а если путевка не зафиксирована, то на дату совершения платежа;
  • ConfirmDate — курс на дату последнего подтверждения заявки (если подтверждения путевки еще не было, либо курс на дату подтверждения не заведен, то будет отображаться курс на момент совершения платежа);
  • OrderDate — дата оформления заявки;
  • PaymentDate - курс на дату совершения платежа.
 
<add key="courseExchangeDate" value="FixationDate" />



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

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



Начиная с релиза 15.8 появилась возможность добавления услуги комиссии от оплаты через платежный шлюз в путевку и формирования ПКО различным образом.

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

Предполагаются 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"/>.

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

Оплату можно произвести по путевкам, статус которых указан в настройке paymentsStatuses.
В разделе Терминалы л/к «Tinkoff (Т-Банк)» в настройке Ссылка для уведомлений необходимо указать URL-адрес уведомления магазина в формате: somesite/Tinkoff/Payment.aspx?action=reply.

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

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

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

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


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


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

Экран «Список заказов»

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

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

Оплата путевки

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


Оплата доступна только для путевок имеющих статус, ключ которого указан в настройке paymentsStatuses.


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

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

Оплата путевок в экране «Список заказов»

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

Оплата путевок в экране «Информация о заказе»

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

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

Ввод данных банковской карты

После того, как все поля заполнены, нужно нажать на кнопку Оплатить.

При успешном проведении платежа в базе автоматически создается проводка и у путевки прописывается сумма оплаты. На указанную электронную почту приходят квитанции об оплате, в л/к «Tinkoff (Т-Банк)» в разделе Операции со статусом Подтвержден появляются данные о проведенном платеже, включая номер путевки. Также в истории путевки добавляется запись об оплате через платежную систему «Tinkoff (Т-Банк)».

Оплата путевки по QR коду

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


Оплата доступна только после включения в личном кабинете «Tinkoff (Т-Банк)» приема оплат по QR коду.
На текущий момент оплата доступна если используется дополнительный модуль Выбор платежной системы (оплата картой в личном кабинете).
Частичная оплата при оплате по QR-коду не предусмотрена в связи с ограничением системы быстрых платежей.

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

После выбора произойдет переход на страницу с QR кодом, который необходимо отсканировать платежным приложением банка и оплатить.
СБП

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


После оплаты по QR коду переход на страницу, с которой совершалась оплата, невозможен в связи с функционалом работы Системы Быстрых Платежей.

Ошибка 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
Источник — «http://wiki.megatec.ru/index.php?title=Платежные_web-сервисы:_Сервис_интеграции_с_платежной_системой_Tinkoff_(Т-Банк)_(оплата_картой_в_личном_кабинете)&oldid=31709»