Платежные web-сервисы: Сервис интеграции с платежной системой Alfabank (оплата картой в личном кабинете)
Версия статьи от 29-03-2023.
|
Поддерживаемые версии ПК «Мастер-Тур»: |
Содержание
Введение
Данный модуль реализует возможность оплаты путевок через систему электронных платежей «Alfabank».
Установка
Для установки дополнительного модуля Сервис интеграции с платежной системой «Alfabank» нужно создать директорию Alfabank в каталоге C:/inetpub/wwwroot (корневом каталоге IIS) и выложить туда распакованные файлы из архива
payments-alfabank-XX.X.X.XXXXX.zip.
Устанавливать дополнительный модуль необходимо в том же домене, где расположено основное приложение ПК «Мастер-Web».
Начиная с релиза 15.8, если используется дополнительный модуль Выбор платежной системы (оплата картой в личном кабинете), то необходимо скопировать файл Megatec.MasterWeb.PaymentSystem.Alfabank.dll из /Payments/bin/ и разместить в папке /EntryPoint/bin/.
В управлении IIS необходимо создать виртуальный каталог для папки Alfabank.
Создание виртуального каталога
По умолчанию корневым каталогом IIS является C:/Inetpub/wwwroot. Для создания виртуального каталога для приложения находящегося в этом каталоге нужно выполнить следующие действия:
1 Зайти в Пуск (Start) → Настройки (Settings) → Панель управления (Control Panel) → Администрирование (Administrative Tools)
2 Диспетчер служб IIS
3 В открывшемся дереве каталогов выбрать Web Sites – Default Web Site. В открывшемся списке найти папку, для которой нужно создать виртуальный каталог, кликнуть по ней правой кнопкой мыши и выбрать Преобразовать в приложение
4 В открывшемся окне нужно нажать кнопку ОК
Подключение к базе данных ПК «Мастер-Тур»
В файле web.config, расположенном в папке Alfabank пропишите необходимые параметры подключения (красным цветом выделены значения, которые необходимо ввести).
Строка подключения к базе данных ПК «Мастер-Тур»:
<add key = "connectionString" value = "Data Source=ip-адрес сервера базы данных ПК «Мастер-Тур»;Initial Catalog=название базы данных ПК «Мастер-Тур»;User ID=логин пользователя ПК «Мастер-Тур»;Password=пароль пользователя ПК «Мастер-Тур»"/>
Настройка
После установки Сервис интеграции с платежной системой Alfabank доступен в экранах «Список заявок» и «Информация о заказе».
Настройки ПК «Мастер-Web»
Настройки задаются в секции <appSettings> файла web.config основного приложения ПК «Мастер-Web».
| № | Описание | Значение | Настройка |
|---|---|---|---|
| 1 | Включение дополнительного модуля Система онлайн платежей.
Обязательная настройка. |
Путь к приложению «Система онлайн платежей». | <add key="paymentsLink" value="http://localhost/Alfabank" />
|
| 2 | Настройка, определяющая статусы путевок, при которых доступна возможность оплаты через систему электронных платежей «Alfabank».
Обязательная настройка. |
Ключи статусов из таблицы [Order_Status], при которых доступна оплата через «Alfabank».
|
<add key="paymentsStatuses" value="7,33" />
|
| 3 | Настройка, позволяющая выводить предупреждающее сообщение о снятии комиссии при оплате. |
|
<add key="askUserBeforePayment" value="true" />
|
| 4 | Настройка, включающая механизм хэширования пароля пользователя, сохраняемого в файлах cookie, что позволяет усилить безопасность ПК «Мастер-Web».
По умолчанию хэширование включено. |
|
<add key="HashPasswordForCookie" value="true" />
|
| 5 | Настройка, определяющая партнеров в базе ПК «Мастер-Тур», которым разрешено осуществлять оплату путёвок онлайн.
|
|
<add key="allowedPaymentPartnerKeys" value="10764"/>
|
| 6 | Настройка, позволяющая производить оплату в новой вкладке браузера. Внимание! Настройка обрабатывается, начиная с релиза 9222SP0.
|
|
<add key="OpenPaymentInNewWindow" value="true" />
|
| 7 | Настройка интервала опроса платежной системы для проверки статуса незавершенных платежей. |
Реализовано начиная с релиза 15.8 Интервал опроса платежной системы в минутах для проверки статуса незавершенных платежей. При отсутствии настройки или указании значения меньше 3 опрос осуществляется раз в 3 минуты. Опрос осуществляется через указанное количество минут до времени указанного в настройке "TimeInMinuteForCheckStatePayments" |
<add key ="TimeoutInMinuteForPollPaymentSystem" value="3"/>
|
| 8 | Настройка задержки проверки статуса платежа на платежной системе. |
Реализовано начиная с релиза 15.8 Отсрочка проверки статуса платежа с момента перехода на платежный шлюз, если платеж сразу не прошел в системе банка. Если по истечении этого времени статус платежа на стороне банка не станет оплаченным, то платеж в ПК "Мастер-Тур" не отобразится. При отсутствии настройки или указании значения меньше 10 отсрочка составляет 10 минут. |
<add key ="TimeInMinuteForCheckStatePayments" value="10"/>
|
Настройки приложения «Система онлайн платежей Alfabank»
Настройки задаются в секции <settings> файла web.config приложения Система онлайн платежей Alfabank.
| № | Описание | Значение | Настройка |
|---|---|---|---|
| 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».
Обязательная настройка. |
|
<add key="language" value="ru" />
|
| 5 | Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для агентств) |
Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется запятой). Комиссия указывается в процентах. |
<add key="addAgencyComission" value="15,8" />
|
| 6 | Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для частных лиц) |
Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется запятой). Комиссия указывается в процентах. |
<add key="addPersonalComission" value="17,4" />
|
| 7 | Настройка, определяющая пользователя ПК «Мастер-Тур», к которому будет привязываться оплата.
Обязательная настройка. |
Ключ пользователя, к которому привязывается оплата (Поле US_KEY из таблицы [UserList]).
|
<add key="masterTourUser" value="0" />
|
| 8 | Настройка, определяющая отдел, к которому будет привязываться оплата.
Обязательная настройка. |
Ключ отдела (кассы), к которому привязывается оплата (Поле PDP_KEY из таблицы [PrtDeps]).
|
<add key="departmentKey" value="0" />
|
| 9 | Настройка, включающая расчет через Мастер финанс. |
|
<add key="AddPaymentsToMasterFinance" value="false"/>
|
| 10 | Настройка, определяющая тип операции при проведении платежа.
Обязательная настройка. |
Ключ операции (Поле PO_ID из таблицы [PaymentOperations]).
|
<add key="PaymentOperationId" value="6" />
|
| 11 | Настройка, определяющая тип операции при проведении платежа для комиссий. | Ключ операции (Поле PO_ID из таблицы [PaymentOperations]).
|
<add key="paymentOperationCommissionId" value="" />
|
| 12 | Настройка, задающая услугу, которая добавится в путевку при наличии комиссии, и стоимость которой будет равна сумме комиссии. Работает вместе с настройками NewDogovorServiceSvKey и NewDogovorServicePartnerKey.
Обрабатывается с релиза 15.8. |
Ключ услуги (Поле SL_KEY из таблицы [ServiceList]).
|
<add key="NewDogovorServiceServiceListKey" value="450" />
|
| 13 | Настройка, задающая класс для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками NewDogovorServiceServiceListKey и NewDogovorServicePartnerKey.
Обрабатывается с релиза 15.8. |
Ключ класса услуги (Поле SV_KEY из таблицы [Service]).
|
<add key="NewDogovorServiceSvKey" value="1055" />
|
| 14 | Настройка, задающая партнера, которая будет являться поставщиком для услуги, добавляемой в путевку при наличии комиссии. Работает вместе с настройками NewDogovorServiceServiceListKey и NewDogovorServiceSvKey.
Обрабатывается с релиза 15.8. |
Ключ класса услуги (Поле PR_KEY из таблицы [Partners]).
|
<add key="NewDogovorServicePartnerKey" value="12921" />
|
| 15 | Настройка, определяющая адрес электронной почты по умолчанию. | Используется в том случае, если не указан адрес электронной почты главного туриста. | <add key="defaultEmail" value="" />
|
Настройки задаются в секции <appSettings> файла web.config приложения Система онлайн платежей Alfabank
| № | Описание | Значение | Настройка |
|---|---|---|---|
| 1 | Имя текущей установленной службы.
Внимание! Настройка обрабатывается только в версии Мастер-Тур 15. |
Наименование службы, к которой может обращаться текущий клиент (по значению настройки acceptableServices в MasterTourService). По умолчанию настройка не заполнена. Значение настройки должно быть явно задано. |
<add key="acceptableServices" value=""/>
|
| 2 | Настройка, включающая экран редактирования суммы к оплате. Текст с правилами оплаты и фиксации курса можно отредактировать в файле Payment.aspx платежного приложения. После изменения файла требуется перезагрузить пул приложения. |
|
<add key="allowCustomAmount" value="true" />
|
Начиная с релиза 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"/>.
Подготовка данных
Работа в системе
Поиск путевки
Список заявок, забронированных в базе данных туроператора, доступен в экране «Список заказов» по адресу: http://ip-адрес сервера Мастер-Веб/MasterWebStandard/OrderList.aspx.
Экран «Список заказов» доступен только для зарегистрированных и авторизованных в системе пользователей.
После ввода имени пользователя и пароля загрузится список заявок, оформленных на покупателя/агентство, указанного в поле «Партнер в БД МТ» при регистрации пользователя в Системе администрирования ПК «Мастер-Web», который сопоставлен имени текущего пользователя.
|
Для отбора путевок можно использовать фильтры:
- Поиск по номеру заявки;
- Поиск по фамилии туриста;
- Поиск по статусу документов на визу;
- Поиск по стране;
- Поиск по дате заявки;
- Дата тура с... и Дата тура по...;
- Путевки с наличием услуги «Виза»;
- Путевки с задолженностями.
Оплата путевки
Оплата доступна только для путевок имеющих статус, ключ которого указан в настройке paymentsStatuses.
Оплата путевок доступна в экранах «Список заявок» и «Информация о заказе».
Экран Список заказов доступен по адресу: http://ip-адрес сервера Мастер-Веб/MasterWebStandard/OrderList.aspx.
|
Экран Информация о заказе доступен по адресу: http://ip-адрес сервера Мастер-Веб/MasterWebStandard/OrderInfo.aspx.
|
Для оплаты путевки через систему электронных платежей «Alfabank» необходимо нажать ссылку Оплатить в экране Список заявок для нужной путевки или кнопку Оплатить on-line в экране Информация о заказе.
Для оплаты путевки необходимо ввести данные банковской карты, с помощью которой производится оплата:
|
После того, как все поля заполнены, нужно нажать на кнопку Оплатить.
При успешном проведении платежа в базе автоматически создается проводка и у путевки прописывается сумма оплаты. В истории путевки добавляется запись об оплате через платежную систему «Alfabank».
Оплата путевки по QR коду
Для оплаты путевки через систему электронных платежей «Alfabank» необходимо нажать ссылку Оплатить для нужной путевки или кнопку Оплатить on-line в экране Информация о заказе.
Произойдет переход к выбору платежных систем в котором необходимо выбрать кнопку с подписью «СБП».
После нажатия выйдет окно с QR кодом и надписью "Оплатить по ссылке", который необходимо отсканировать платежным приложением банка и оплатить.
Также имеется возможность перейти по надписи "Оплатить по ссылке", откроется окно оплаты с QR - кодом.
После оплаты по QR коду переход на страницу, с которой совершалась оплата, невозможен в связи с функционалом работы Системы Быстрых Платежей.
Подключение к интернет-эквайрингу от Альфа-Банк
Для подключения услуг Интернет-эквайринга в АО «Альфа-Банк» для работы с ПК "Мастер-Тур" необходимо выполнить описанные ниже действия.
У организации уже открыт расчетный счет в Альфа-Банке
- Зайти в Интернет Банк через мобильное приложение или через официальный сайт Банка https://alfabank.ru/ и подать заявку на подключение Интернет-эквайринга.
Или
- обратиться к курирующему менеджеру Банка для заведения заявки на Интернет-эквайринг.
При заполнении заявки, указать: Подключение Интернет-эквайринга необходимо реализовать через платежный шлюз IPS.
У организации еще нет расчетного счета в Альфа-Банке
- На сайте Банка по ссылке https://alfabank.ru/sme/payservice/internet-acquiring/ подать заявку на подключение Интернет-эквайринга, параллельно с которым будет инициировано открытие расчетного счета для организации в Альфа-Банке.
При заполнении заявки, указать: Подключение Интернет-эквайринга необходимо реализовать через платежный шлюз IPS.
