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

Материал из Megatec
Перейти к: навигация, поиск
Строка 5: Строка 5:
 
<td>
 
<td>
 
Более ранние версии:<BR>
 
Более ранние версии:<BR>
[http://wiki.megatec.ru/index.php?title=Мастер-Web:Дополнительный_модуль_Интеграция_с_платежной_системой_PayOnline&stableid=8064 До 2009.2.12 включительно]<BR>
+
[http://wiki.megatec.ru/index.php?title=Мастер-Web:Дополнительный_модуль_Интеграция_с_платежной_системой_PayOnline&stableid=8064 До 2009.2.12 включительно]<br />
 
</td>
 
</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
<BR>
+
<br />
  
 
==Введение==
 
==Введение==
Данный модуль реализует возможность оплаты путевок через систему электронных платежей PayOnline.
+
Данный модуль реализует возможность оплаты путевок через ''систему электронных платежей'' '''«PayOnline»'''.
PayOnline - это мультибанковская система платежей по пластиковым и виртуальным картам через интернет, позволяющая в реальном времени производить авторизацию и обработку транзакций.
+
«PayOnline» - это мультибанковская система платежей по пластиковым и виртуальным картам через интернет, позволяющая в реальном времени производить авторизацию и обработку транзакций.
 +
 
 
==Установка==  
 
==Установка==  
Для установки Надстройки «Интеграция с платежной системой PayOnline» нужно создать директорию Payments в каталоге c:/inetpub/wwwroot (корневом каталоге IIS)  и выложить туда распакованные файлы из архива payments-payonline-2007.2.XX.XXXX.zip.
+
Для установки дополнительного модуля '''Интеграция с платежной системой PayOnline''' нужно создать директорию '''Payments''' в каталоге <code>C:/inetpub/wwwroot</code> (корневом каталоге '''IIS''')  и выложить туда распакованные файлы из архива<br />
В управлении IIS необходимо создать виртуальный каталог для папки Payments.
+
<code>payments-payonline-2007.2.XX.XXXX.zip</code>.<br />
 +
В '''управлении IIS''' необходимо создать ''виртуальный каталог'' для папки '''Payments'''.
 +
 
 
===Создание виртуального каталога===
 
===Создание виртуального каталога===
По умолчанию корневым каталогом IIS является C:/Inetpub/wwwroot. Для создания виртуального каталога для приложения находящегося в этом каталоге нужно выполнить следующие действия:
+
По умолчанию корневым каталогом '''IIS''' является <code>C:/Inetpub/wwwroot</code>. Для создания виртуального каталога для приложения находящегося в этом каталоге нужно выполнить следующие действия:<br />
*1. Зайти в Пуск (Start) Настройки (Settings) Панель управления (Control Panel).
+
1 Зайти в '''Пуск''' ('''Start''') &rarr; '''Настройки''' ('''Settings''') &rarr; '''Панель управления''' ('''Control Panel''') &rarr; '''Администрирование''' ('''Administrative Tools''')
<BR>
+
[[Файл: am_745.png|x500px|Панель управления]]<br />
[[Файл:768.PNG]]<BR>
+
<br />
 +
2 '''Диспетчер служб IIS'''<br />
 +
[[Файл: am_746.png|x500px|Администрирование - Диспетчер служб IIS]]<br />
 +
<br />
 +
3 В открывшемся дереве каталогов выбрать '''Web Sites – Default Web Site'''. В открывшемся списке найти ''папку'', для которой нужно создать ''виртуальный каталог'', кликнуть по ней правой кнопкой мыши и выбрать '''Преобразовать в приложение'''<br />
 +
[[Файл: am_747.png|x500px|Преобразовать в приложение]]<br />
 +
<br />
 +
4 В открывшемся окне нужно нажать кнопку '''ОК'''<br />
 +
[[Файл: am_748.png|x500px|Добавить приложение]]<br />
 +
<br />
  
*2. В открывшемся окне выбрать Администрирование (Administrative Tools).
 
<BR>
 
[[Файл:769.PNG]]<BR>
 
*3. Запустить Internet Information Services (IIS) Manager.
 
<BR>
 
[[Файл:770.PNG]]<BR>
 
*4. В открывшемся дереве каталогов выбрать Web Sites – Default Web Site. В открывшемся списке найти папку, для которой нужно создать виртуальный каталог, кликнуть по ней правой кнопкой мыши и зайти в Свойства (Properties).
 
<BR>
 
[[Файл:771.PNG]]<BR>
 
*5. В открывшемся окне, в закладке Directory нужно нажать кнопку «Create», а затем кнопку «ОК».
 
<BR>
 
[[Файл:772.PNG]]<BR>
 
 
===Подключение к базе данных ПК «Мастер-Тур»===
 
===Подключение к базе данных ПК «Мастер-Тур»===
В файле web.config, расположенном в папке Payments пропишите необходимые параметры подключения (курсивом выделены значения, которые необходимо ввести).
+
В файле <code>web.config</code>, расположенном в папке '''Payments''' пропишите необходимые параметры подключения (<span style="color:red">красным цветом</span> выделены значения, которые необходимо ввести).
Строка подключения к базе данных ПК «Мастер-Тур»:
+
Строка подключения к базе данных ПК «Мастер-Тур»:<br />
*1. <add key = "connectionString" value = "Data Source=ip-адрес сервера базы данных ПК Мастер-тур;Initial Catalog=название базы данных ПК Мастер-тур;User ID=логин пользователя ПК Мастер-тур;Password=пароль пользователя ПК Мастер-тур"/>
+
# <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>
*2. <add key = "connectionStringShort" value = "Data Source= ip-адрес сервера базы данных ПК Мастер-Тур;Initial Catalog= название базы данных ПК Мастер-Тур"/>  
+
# <code><add key = "connectionStringShort" value = "Data Source=<span style="color:red">ip-адрес сервера базы данных ПК «Мастер-Тур»</span>;Initial Catalog=<span style="color:red">название базы данных ПК «Мастер-Тур»</span>"/></code>
 +
 
 
==Настройка==  
 
==Настройка==  
После установки надстройка «Интеграция с платежной системой PayOnline» доступна в экранах «Список заявок» и «Информация о заказе. Адрес экрана «Список заявок»: http: //ip-адрес сервера/MasterWeb/OrderList.aspx.  Адрес экрана «Информация о заказе»: http: //ip-адрес сервера/MasterWeb/OrderInfo.aspx.  
+
После установки надстройка '''Интеграция с платежной системой PayOnline''' доступна в экранах [[Мастер-Web:«Список заявок»|«Список заявок»]] и [[Мастер-Web:«Информация о заказе»|«Информация о заказе»]].
===Настройки ПК Мастер-Web===
+
 
Настройки задаются в секции <appSettings/> файла web.config основного приложения ПК Мастер-Web.
+
Скриншот 1
 +
 
 +
Скриншот 2
 +
 
 +
===Настройки ПК «Мастер-Web»===
 +
Настройки задаются в секции <code><appSettings></code> файла <code>web.config</code> основного приложения ПК «Мастер-Web».
 +
 
 +
 
 +
{| class="wikitable"
 +
! scope="col" width="50px" | №
 +
! scope="col" width="400px" | Описание
 +
! scope="col" width="250px" | Значение
 +
! scope="col" width="400px" | Настройка
 +
|-
 +
| '''1'''
 +
|| Включение дополнительного модуля '''Система онлайн платежей'''.
 +
Обязательная настройка.
 +
|| - '''Путь к приложению «Система онлайн платежей»'''.
 +
|| <add key="'''paymentsLink'''" value="<span style="color:blue">'''<nowiki>http://somesite/Payments</nowiki>'''</span>" />
 +
|-
 +
| '''2'''
 +
|| Настройка, определяющая '''статусы путевок''', при которых '''доступна возможность оплаты''' через систему электронных платежей «PayOnline».
 +
Обязательная настройка.
 +
|| - '''ключи статусов''' из таблицы <code>'''[Order_Status]'''</code>, при которых ''доступна оплата'' через «PayOnline».
 +
|| <add key="'''paymentsStatuses'''" value="<span style="color:blue">'''7,37'''</span>" />
 +
|-
 +
| '''3'''
 +
|| Настройка, позволяющая '''выводить предупреждающее сообщение''' о ''снятии комиссии при оплате''.
 +
|| – '''true''' — сообщение ''отображается'';
 +
– '''false''' или '''отусутствие настройки''' — сообщение ''не отображается''.
 +
|| <add key="'''askUserBeforePayment'''" value="<span style="color:blue">'''true'''</span>" />
 +
|-
 +
| '''4'''
 +
|| Настройка, определяющая '''дату''', на которую будет '''подбираться курс валют''' для пересчета '''суммы к оплате'''.
 +
|| - '''OrderDate''' — дата ''оформления заявки'';
 +
- '''Today''' — курс на ''текущую дату'';<br />
 +
- '''ConfirmDate''' — курс на ''дату подтверждения заявки'' (если ''подтверждения'' путевки еще ''не было'', либо курс на дату подтверждения ''не заведен'', то будет отображаться курс на ''текущую дату'').
 +
|| <add key="'''courseExchangeDate'''" value="<span style="color:blue">'''OrderDate'''</span>" />
 +
|-
 +
| '''4'''
 +
|| Настройка, определяющая '''дату''', на которую будет '''подбираться курс валют''' для пересчета '''суммы к оплате'''.
 +
|| - '''OrderDate''' — дата ''оформления заявки'';
 +
- '''Today''' — курс на ''текущую дату'';<br />
 +
- '''ConfirmDate''' — курс на ''дату подтверждения заявки'' (если ''подтверждения'' путевки еще ''не было'', либо курс на дату подтверждения ''не заведен'', то будет отображаться курс на ''текущую дату'').
 +
|| <add key="'''courseExchangeDate'''" value="<span style="color:blue">'''OrderDate'''</span>" />
 +
|}
 +
 
 +
 
 +
<!--
 
<table class=MsoNormalTable border=1 cellspacing=0 cellpadding=0 width=643
 
<table class=MsoNormalTable border=1 cellspacing=0 cellpadding=0 width=643
 
  style='width:482.4pt;border-collapse:collapse;border:none'>
 
  style='width:482.4pt;border-collapse:collapse;border:none'>
Строка 662: Строка 711:
 
</table>
 
</table>
  
 +
-->
 
==Подготовка данных==
 
==Подготовка данных==
 
Оплату можно произвести по путевкам, статус которых указан в настройке paymentsStatuses.
 
Оплату можно произвести по путевкам, статус которых указан в настройке paymentsStatuses.

Версия 17:42, 19 декабря 2013

Версия статьи от 19-12-2013. Для перехода на версию статьи, соответствующую используемой Вами версии программы, нажмите ссылку в таблице

Более ранние версии:
До 2009.2.12 включительно


Введение

Данный модуль реализует возможность оплаты путевок через систему электронных платежей «PayOnline». «PayOnline» - это мультибанковская система платежей по пластиковым и виртуальным картам через интернет, позволяющая в реальном времени производить авторизацию и обработку транзакций.

Установка

Для установки дополнительного модуля Интеграция с платежной системой PayOnline нужно создать директорию Payments в каталоге C:/inetpub/wwwroot (корневом каталоге IIS) и выложить туда распакованные файлы из архива
payments-payonline-2007.2.XX.XXXX.zip.
В управлении IIS необходимо создать виртуальный каталог для папки Payments.

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

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

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

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

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

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

В файле web.config, расположенном в папке Payments пропишите необходимые параметры подключения (красным цветом выделены значения, которые необходимо ввести). Строка подключения к базе данных ПК «Мастер-Тур»:

  1. <add key = "connectionString" value = "Data Source=ip-адрес сервера базы данных ПК «Мастер-Тур»;Initial Catalog=название базы данных ПК «Мастер-Тур»;User ID=логин пользователя ПК «Мастер-Тур»;Password=пароль пользователя ПК «Мастер-Тур»"/>
  2. <add key = "connectionStringShort" value = "Data Source=ip-адрес сервера базы данных ПК «Мастер-Тур»;Initial Catalog=название базы данных ПК «Мастер-Тур»"/>

Настройка

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

Скриншот 1
Скриншот 2

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

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


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

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

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

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

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

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

<add key="askUserBeforePayment" value="true" />
4 Настройка, определяющая дату, на которую будет подбираться курс валют для пересчета суммы к оплате. - OrderDate — дата оформления заявки;

- Today — курс на текущую дату;
- ConfirmDate — курс на дату подтверждения заявки (если подтверждения путевки еще не было, либо курс на дату подтверждения не заведен, то будет отображаться курс на текущую дату).

<add key="courseExchangeDate" value="OrderDate" />
4 Настройка, определяющая дату, на которую будет подбираться курс валют для пересчета суммы к оплате. - OrderDate — дата оформления заявки;

- Today — курс на текущую дату;
- ConfirmDate — курс на дату подтверждения заявки (если подтверждения путевки еще не было, либо курс на дату подтверждения не заведен, то будет отображаться курс на текущую дату).

<add key="courseExchangeDate" value="OrderDate" />


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

Оплату можно произвести по путевкам, статус которых указан в настройке paymentsStatuses. Для возможности оплаты через платёжную систему PayOnline тип платёжной операции (PaymentOperation), ключ которой указан в настройке kindOfPay, должен иметь бланки и иметь признак «Приходный» (PO_Type is null or PO_Type = 0).

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

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

Список заявок, забронированных в базе данных туроператора, доступен по адресу: http: //ip-адрес сервера Мастер-Веб/MasterWebStandard/OrderList.aspx. Экран «Список заказов» доступен только для зарегистрированных и авторизованных в системе пользователей. После ввода имени пользователя и пароля загрузится список заявок, оформленных на покупателя/агентство, указанного в поле «Партнер в БД МТ» при регистрации пользователя в Системе администрирования ПК Мастер-Веб, который сопоставлен имени текущего пользователя.
773.PNG
В этом экране пользователь может наложить ограничения на отбор заявок по:

  • Номеру заявки в базе данных туроператора
  • По стране
  • Дате оформления заказа
  • Периоду дат начала тура
  • Заявки, имеющие в составе тура услугу «Виза»
  • Неоплаченные или не полностью оплаченные заявки.

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

Оплата доступна только для путевок имеющих статус, ключ которого указан в настройке paymentsStatuses. Оплата путевок доступна в экранах «Список заявок» и «Информация о заказе». Экран «Список заявок» доступен по адресу: http: //ip-адрес сервера Мастер-Веб/MasterWebStandard/OrderList.aspx.
774.PNG
Экран «Информация о заказе» доступен по адресу: http: //ip-адрес сервера Мастер-Веб/MasterWebStandard/OrderInfo.aspx.
775.PNG
Для оплаты путевки через систему электронных платежей PayOnline необходимо нажать ссылку «Оплатить» для нужной путевки, после чего пользователь попадает в экран, в котором указывается номер заказа и сумма платежа.

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

Для оплаты необходимо нажать на «Оплатить с банковской карты».
776.PNG
Далее пользователь попадает в экран для ввода персональных данных:
777.PNG
В данном экране необходимо заполнить информацию, необходимую для проведения оплаты путевки. После того, как все поля заполнены, нужно нажать на кнопку «Оплатить», по нажатию которой загрузится экран «Информация о платеже»:
778.PNG
Для того чтобы вернуться к списку заявок нужно нажать на кнопку «Завершить».
При успешном проведении платежа в базе автоматически создается проводка и у путевки прописывается сумма оплаты. Также в истории путевки добавляется запись об оплате через платежную систему PayOnline.