Платежные web-сервисы: Сервис интеграции с платежной системой Alfabank (оплата картой в личном кабинете) — различия между версиями
[досмотренная версия] | [досмотренная версия] |
Kiriy (обсуждение | вклад) |
Kiriy (обсуждение | вклад) (→Настройки ПК «Мастер-Web») |
||
(не показано 6 промежуточных версий этого же участника) | |||
Строка 55: | Строка 55: | ||
Обязательная настройка.<br> | Обязательная настройка.<br> | ||
<font style="color:red">'''Внимание!'''</font> Путь к приложению обязательно должен содержать ссылку на приложение из внешней сети. В противном случае, она не будет работать. | <font style="color:red">'''Внимание!'''</font> Путь к приложению обязательно должен содержать ссылку на приложение из внешней сети. В противном случае, она не будет работать. | ||
− | | '''Путь к приложению «Система онлайн платежей»'''. | + | | '''Путь к приложению '''«Система онлайн платежей»'''. |
|<syntaxhighlight lang="xml" enclose="div"> | |<syntaxhighlight lang="xml" enclose="div"> | ||
<add key="paymentsLink" value="http://localhost/Alfabank" /> | <add key="paymentsLink" value="http://localhost/Alfabank" /> | ||
Строка 107: | Строка 107: | ||
|- style="vertical-align:text-top" | |- style="vertical-align:text-top" | ||
+ | |} | ||
+ | ===Настройки приложения «Система онлайн платежей Alfabank»=== | ||
− | + | Настройки задаются в секции <code><settings></code> файла <code>web.config</code> приложения '''Система онлайн платежей Alfabank'''.<br /> | |
− | |||
− | |||
− | Настройки задаются в секции <code><settings></code> файла <code>web.config</code> приложения '''Система онлайн платежей Alfabank'''. | ||
{| 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" | ||
Строка 210: | Строка 209: | ||
| 9 | | 9 | ||
+ | | Настройка, включающая расчет через Мастер финанс. | ||
+ | | | ||
+ | * '''false''' - расчет через мастер финанс не включен; | ||
+ | * '''true''' - расчет через мастер финанс включен. | ||
+ | |<syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="isMasterFinance" value="false"/> | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | |||
+ | | 10 | ||
| Настройка, определяющая '''тип операции при проведении платежа'''. | | Настройка, определяющая '''тип операции при проведении платежа'''. | ||
Обязательная настройка. | Обязательная настройка. | ||
Строка 219: | Строка 229: | ||
|- style="vertical-align:text-top" | |- style="vertical-align:text-top" | ||
− | | | + | | 11 |
+ | | Настройка, определяющая '''тип операции при проведении платежа для комиссий'''. | ||
+ | | '''Ключ операции''' (Поле '''PO_ID''' из таблицы <code>'''[PaymentOperations]'''</code>). | ||
+ | |<syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="paymentOperationCommissionId" value="" /> | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | |||
+ | | 12 | ||
+ | | Настройка, определяющая '''адрес электронной почты по умолчанию'''. | ||
+ | |Используется в том случае, если не указан адрес электронной почты главного туриста. | ||
+ | |<syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="defaultEmail" value="" /> | ||
+ | |||
+ | </syntaxhighlight> | ||
+ | |||
+ | |}<br /> | ||
+ | |||
+ | Настройки задаются в секции <code><appSettings></code> файла <code>web.config</code> приложения '''Система онлайн платежей Alfabank'''<br /> | ||
+ | |||
+ | {| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse" | ||
+ | |||
+ | |- style="background-color:#F2F2F2" | ||
+ | |||
+ | ! width="2%" | № | ||
+ | ! width="28%" | Описание | ||
+ | ! width="35%" | Значение | ||
+ | ! width="35%" | Настройка | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | |||
+ | | 1 | ||
| Настройка, '''включающая экран редактирования суммы к оплате'''.<br> | | Настройка, '''включающая экран редактирования суммы к оплате'''.<br> | ||
Текст с правилами оплаты и фиксации курса можно отредактировать в файле ''Payment.aspx'' платежного приложения. После изменения файла требуется перезагрузить пул приложения.<br> | Текст с правилами оплаты и фиксации курса можно отредактировать в файле ''Payment.aspx'' платежного приложения. После изменения файла требуется перезагрузить пул приложения.<br> | ||
Строка 230: | Строка 272: | ||
|- style="vertical-align:text-top" | |- style="vertical-align:text-top" | ||
− | |} | + | |}<br /> |
==Подготовка данных== | ==Подготовка данных== | ||
Строка 244: | Строка 286: | ||
{| border="1" style="border-collapse:collapse" | {| border="1" style="border-collapse:collapse" | ||
|- | |- | ||
− | |[[Файл:JK | + | |[[Файл:JK 454.png|1400px|Экран «Список заказов»]] |
|- | |- | ||
|}<br /> | |}<br /> | ||
Строка 257: | Строка 299: | ||
* '''Путевки с наличием услуги «Виза»'''; | * '''Путевки с наличием услуги «Виза»'''; | ||
* '''Путевки с задолженностями'''. | * '''Путевки с задолженностями'''. | ||
+ | |||
+ | ===Оплата путевки=== | ||
+ | |||
+ | [[Файл: am_063.png|left|Предупреждение]]<br /> | ||
+ | Оплата доступна '''только''' для путевок '''имеющих статус''', '''ключ''' которого [[#Настройки ПК «Мастер-Web»|указан в настройке paymentsStatuses]]. | ||
+ | <br /> | ||
+ | |||
+ | Оплата путевок доступна в экранах [[Мастер-Web:Руководство пользователя. Работа в системе online бронирования#Просмотр списка забронированных туров («OrderList.aspx»)|«Список заявок»]] и [[Мастер-Web:Руководство пользователя. Работа в системе online бронирования#Просмотр подробной информации о заказе («OrderInfo.aspx»)|«Информация о заказе»]]. | ||
+ | |||
+ | Экран '''Список заказов''' доступен по адресу: <code><nowiki>http://ip-адрес сервера Мастер-Веб/MasterWebStandard/OrderList.aspx</nowiki></code>.<br /> | ||
+ | |||
+ | {| border="1" style="border-collapse:collapse" | ||
+ | |- | ||
+ | |[[Файл:JK 455.png|1400px|Оплата путевок в экране "Список заказов"]] | ||
+ | |- | ||
+ | |}<br /> | ||
+ | |||
+ | Экран '''Информация о заказе''' доступен по адресу: <code><nowiki>http://ip-адрес сервера Мастер-Веб/MasterWebStandard/OrderInfo.aspx</nowiki></code>.<br /> | ||
+ | |||
+ | {| border="1" style="border-collapse:collapse" | ||
+ | |- | ||
+ | |[[Файл:JK 456.png|Оплата путевок в экране "Информация о заказе"]] | ||
+ | |- | ||
+ | |}<br /> | ||
+ | |||
+ | |||
+ | Для оплаты путевки через '''систему электронных платежей «Alfabank»''' необходимо нажать ссылку '''Оплатить''' в экране '''Список заявок''' для нужной путевки или кнопку '''Оплатить on-line''' в экране '''Информация о заказе'''. | ||
+ | |||
+ | Для оплаты путевки необходимо ввести '''данные банковской карты''', с помощью которой производится оплата: | ||
+ | |||
+ | {| border="1" style="border-collapse:collapse" | ||
+ | |- | ||
+ | |[[Файл:JK 457.png|600px|Вод данных банковской карты]] | ||
+ | |- | ||
+ | |}<br /> | ||
+ | |||
+ | |||
+ | После того, как '''все поля заполнены''', нужно нажать на кнопку '''Оплатить'''. | ||
+ | |||
+ | При '''успешном''' проведении платежа в базе '''автоматически создается проводка''' и у путевки '''прописывается сумма оплаты'''. В [[Мастер-Тур:Работа с группой путевок#История путевки|истории путевки]] добавляется запись об '''оплате через платежную систему «Alfabank»'''. | ||
+ | |||
+ | [[Category:Платежные web-сервисы]] |
Версия 08:55, 11 августа 2022
Версия статьи от 11-08-2022.
Поддерживаемые версии ПК «Мастер-Тур»: |
Содержание
Введение
Данный модуль реализует возможность оплаты путевок через систему электронных платежей «Alfabank».
Установка
Для установки дополнительного модуля Сервис интеграции с платежной системой «Alfabank» нужно создать директорию Alfabank в каталоге C:/inetpub/wwwroot
(корневом каталоге IIS) и выложить туда распакованные файлы из архива
payments-alfabank-XX.X.X.XXXXX.zip
.
Устанавливать дополнительный модуль необходимо в том же домене, где расположено основное приложение ПК «Мастер-Web».
Начиная с релиза 15.5, если используется дополнительный модуль Выбор платежной системы (оплата картой в личном кабинете), то необходимо скопировать файл 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"/>
|
Настройки приложения «Система онлайн платежей 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="false" />
|
6 | Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для частных лиц) |
|
<add key="addPersonalComission" value="false" />
|
7 | Настройка, определяющая пользователя ПК «Мастер-Тур», к которому будет привязываться оплата.
Обязательная настройка. |
Ключ пользователя, к которому привязывается оплата (Поле US_KEY из таблицы [UserList] ).
|
<add key="masterTourUser" value="0" />
|
8 | Настройка, определяющая отдел, к которому будет привязываться оплата.
Обязательная настройка. |
Ключ отдела (кассы), к которому привязывается оплата (Поле PDP_KEY из таблицы [PrtDeps] ).
|
<add key="departmentKey" value="0" />
|
9 | Настройка, включающая расчет через Мастер финанс. |
|
<add key="isMasterFinance" value="false"/>
|
10 | Настройка, определяющая тип операции при проведении платежа.
Обязательная настройка. |
Ключ операции (Поле PO_ID из таблицы [PaymentOperations] ).
|
<add key="PaymentOperationId" value="6" />
|
11 | Настройка, определяющая тип операции при проведении платежа для комиссий. | Ключ операции (Поле PO_ID из таблицы [PaymentOperations] ).
|
<add key="paymentOperationCommissionId" value="" />
|
12 | Настройка, определяющая адрес электронной почты по умолчанию. | Используется в том случае, если не указан адрес электронной почты главного туриста. | <add key="defaultEmail" value="" />
|
Настройки задаются в секции <appSettings>
файла web.config
приложения Система онлайн платежей Alfabank
№ | Описание | Значение | Настройка |
---|---|---|---|
1 | Настройка, включающая экран редактирования суммы к оплате. Текст с правилами оплаты и фиксации курса можно отредактировать в файле Payment.aspx платежного приложения. После изменения файла требуется перезагрузить пул приложения. |
|
<add key="allowCustomAmount" value="true" />
|
Подготовка данных
Работа в системе
Поиск путевки
Список заявок, забронированных в базе данных туроператора, доступен в экране «Список заказов» по адресу: http://ip-адрес сервера Мастер-Веб/MasterWebStandard/OrderList.aspx
.
Экран «Список заказов» доступен только для зарегистрированных и авторизованных в системе пользователей.
После ввода имени пользователя и пароля загрузится список заявок, оформленных на покупателя/агентство, указанного в поле «Партнер в БД МТ» при регистрации пользователя в Системе администрирования ПК «Мастер-Web», который сопоставлен имени текущего пользователя.
Для отбора путевок можно использовать фильтры:
- Поиск по номеру заявки;
- Поиск по фамилии туриста;
- Поиск по статусу документов на визу;
- Поиск по стране;
- Поиск по дате заявки;
- Дата тура с... и Дата тура по...;
- Путевки с наличием услуги «Виза»;
- Путевки с задолженностями.
Оплата путевки
Оплата доступна только для путевок имеющих статус, ключ которого указан в настройке paymentsStatuses.
Оплата путевок доступна в экранах «Список заявок» и «Информация о заказе».
Экран Список заказов доступен по адресу: http://ip-адрес сервера Мастер-Веб/MasterWebStandard/OrderList.aspx
.
Экран Информация о заказе доступен по адресу: http://ip-адрес сервера Мастер-Веб/MasterWebStandard/OrderInfo.aspx
.
Для оплаты путевки через систему электронных платежей «Alfabank» необходимо нажать ссылку Оплатить в экране Список заявок для нужной путевки или кнопку Оплатить on-line в экране Информация о заказе.
Для оплаты путевки необходимо ввести данные банковской карты, с помощью которой производится оплата:
После того, как все поля заполнены, нужно нажать на кнопку Оплатить.
При успешном проведении платежа в базе автоматически создается проводка и у путевки прописывается сумма оплаты. В истории путевки добавляется запись об оплате через платежную систему «Alfabank».