Платежные web-сервисы: Сервис интеграции с платежной системой PayOnline (оплата картой в личном кабинете) — различия между версиями
| [досмотренная версия] | [досмотренная версия] |
Tarasov (обсуждение | вклад) (→Настройки приложения «Система онлайн платежей») |
Achkasov (обсуждение | вклад) |
||
| Строка 1: | Строка 1: | ||
| + | Версия статьи от {{REVISIONDAY}}-{{REVISIONMONTH}}-{{REVISIONYEAR}}. Для перехода на версию статьи, соответствующую используемой Вами версии программы, нажмите ссылку в таблице | ||
| + | |||
| + | <table style="color:black; background-color:#ffffcc;" cellpadding="10" cellspacing="0" border="1"> | ||
| + | <tr> | ||
| + | <td> | ||
| + | Более ранние версии:<BR> | ||
| + | [http://wiki.megatec.ru/index.php?title=Мастер-Web:Дополнительный_модуль_Интеграция_с_платежной_системой_PayOnline&stableid=8064 До 2009.2.12 включительно]<BR> | ||
| + | </td> | ||
| + | </tr> | ||
| + | </table> | ||
| + | <BR> | ||
| + | |||
==Введение== | ==Введение== | ||
Данный модуль реализует возможность оплаты путевок через систему электронных платежей PayOnline. | Данный модуль реализует возможность оплаты путевок через систему электронных платежей PayOnline. | ||
| Строка 566: | Строка 578: | ||
<p class=Basic0 style='text-indent:0cm'><span lang=EN-US style='mso-ansi-language: | <p class=Basic0 style='text-indent:0cm'><span lang=EN-US style='mso-ansi-language: | ||
EN-US'><add key="<b style='mso-bidi-font-weight:normal'>HashPasswordForCookie</b>" | EN-US'><add key="<b style='mso-bidi-font-weight:normal'>HashPasswordForCookie</b>" | ||
| + | value="<b style='mso-bidi-font-weight:normal'><i style='mso-bidi-font-style: | ||
| + | normal'><span style='color:blue'>true</span></i></b>" /> </span></p> | ||
| + | </td> | ||
| + | </tr> | ||
| + | |||
| + | <tr style='mso-yfti-irow:238;height:83.8pt'> | ||
| + | <td width=46 valign=top style='width:34.25pt;border-top:none;border-left: | ||
| + | solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none; | ||
| + | mso-border-top-alt:solid black .5pt;mso-border-top-alt:solid black .5pt; | ||
| + | mso-border-left-alt:solid black .5pt;mso-border-bottom-alt:solid black .5pt; | ||
| + | padding:0cm 5.4pt 0cm 5.4pt;height:83.8pt'> | ||
| + | <p class=Tabletext0 style='layout-grid-mode:char'><span lang=EN-US | ||
| + | style='mso-ansi-language:EN-US'>13 </span></p> | ||
| + | </td> | ||
| + | <td width=138 valign=top style='width:103.65pt;border-top:none;border-left: | ||
| + | solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none; | ||
| + | mso-border-top-alt:solid black .5pt;mso-border-top-alt:solid black .5pt; | ||
| + | mso-border-left-alt:solid black .5pt;mso-border-bottom-alt:solid black .5pt; | ||
| + | padding:0cm 5.4pt 0cm 5.4pt;height:83.8pt'> | ||
| + | <p class=MsoNormal><span style='font-size:10.0pt;font-family:"Arial","sans-serif"; | ||
| + | mso-bidi-font-family:"Times New Roman"'>Настройка, включающая экран редактирования суммы к оплате. | ||
| + | <br></span></p> | ||
| + | </td> | ||
| + | <td width=204 valign=top style='width:153.0pt;border-top:none;border-left: | ||
| + | solid black 1.0pt;border-bottom:solid black 1.0pt;border-right:none; | ||
| + | mso-border-top-alt:solid black .5pt;mso-border-top-alt:solid black .5pt; | ||
| + | mso-border-left-alt:solid black .5pt;mso-border-bottom-alt:solid black .5pt; | ||
| + | padding:0cm 5.4pt 0cm 5.4pt;height:83.8pt'> | ||
| + | <p class=MsoNormal style='text-align:justify'><span style='font-size:10.0pt; | ||
| + | font-family:"Arial","sans-serif";mso-bidi-font-family:"Times New Roman"'>- <b | ||
| + | style='mso-bidi-font-weight:normal'>true</b> - экран корректировки суммы к оплате отображается; </span></p> | ||
| + | <p class=MsoNormal style='text-align:justify'><span style='font-size:10.0pt; | ||
| + | font-family:"Arial","sans-serif";mso-bidi-font-family:"Times New Roman"'>- <b | ||
| + | style='mso-bidi-font-weight:normal'>false</b> или <b style='mso-bidi-font-weight: | ||
| + | normal'>отсутствие настройки</b> - экран корректировки суммы к оплате не отображается.</span></p> | ||
| + | </td> | ||
| + | <td width=257 valign=top style='width:192.5pt;border:solid black 1.0pt; | ||
| + | border-top:none;mso-border-top-alt:solid black .5pt;mso-border-alt:solid black .5pt; | ||
| + | padding:0cm 5.4pt 0cm 5.4pt;height:83.8pt'> | ||
| + | <p class=Basic0 style='text-indent:0cm'><span lang=EN-US style='mso-ansi-language: | ||
| + | EN-US'><add key="<b style='mso-bidi-font-weight:normal'>allowCustomAmount</b>" | ||
value="<b style='mso-bidi-font-weight:normal'><i style='mso-bidi-font-style: | value="<b style='mso-bidi-font-weight:normal'><i style='mso-bidi-font-style: | ||
normal'><span style='color:blue'>true</span></i></b>" /> </span></p> | normal'><span style='color:blue'>true</span></i></b>" /> </span></p> | ||
| Строка 598: | Строка 651: | ||
<BR> | <BR> | ||
[[Файл:775.PNG]]<BR> | [[Файл:775.PNG]]<BR> | ||
| − | Для оплаты путевки через систему электронных платежей PayOnline необходимо нажать ссылку «Оплатить» для нужной путевки, после чего пользователь попадает в экран, в котором указывается номер заказа и сумма платежа. Для оплаты необходимо нажать на «Оплатить с банковской карты». | + | Для оплаты путевки через систему электронных платежей PayOnline необходимо нажать ссылку «Оплатить» для нужной путевки, после чего пользователь попадает в экран, в котором указывается номер заказа и сумма платежа. |
| + | |||
| + | Сумма к оплате выводится в национальной валюте. При необходимости, она конвертируется по соответствующему курсу. | ||
| + | |||
| + | Для оплаты необходимо нажать на «Оплатить с банковской карты». | ||
<BR> | <BR> | ||
[[Файл:776.PNG]]<BR> | [[Файл:776.PNG]]<BR> | ||
Версия 17:23, 23 июля 2012
Версия статьи от 23-07-2012. Для перехода на версию статьи, соответствующую используемой Вами версии программы, нажмите ссылку в таблице
|
Более ранние версии: |
Содержание
Введение
Данный модуль реализует возможность оплаты путевок через систему электронных платежей 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).
- 2. В открывшемся окне выбрать Администрирование (Administrative Tools).
- 3. Запустить Internet Information Services (IIS) Manager.
- 4. В открывшемся дереве каталогов выбрать Web Sites – Default Web Site. В открывшемся списке найти папку, для которой нужно создать виртуальный каталог, кликнуть по ней правой кнопкой мыши и зайти в Свойства (Properties).
- 5. В открывшемся окне, в закладке Directory нужно нажать кнопку «Create», а затем кнопку «ОК».
Подключение к базе данных ПК «Мастер-Тур»
В файле 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» доступна в экранах «Список заявок» и «Информация о заказе. Адрес экрана «Список заявок»: http: //ip-адрес сервера/MasterWeb/OrderList.aspx. Адрес экрана «Информация о заказе»: http: //ip-адрес сервера/MasterWeb/OrderInfo.aspx.
Настройки ПК Мастер-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"/> |
Настройки приложения «Система онлайн платежей»
Настройки задаются в секции <basic/> файла web.config приложения «Система онлайн платежей».
|
№ |
Описание |
Значение |
Настройка |
|
1 |
Ключ сайта |
Merchant ID сайта в системе PayOnline |
<add key="merchantId " value="2898"/> |
|
2 |
Ключ |
Security key в Параметрах интеграции сайта в системе PayOnline |
<add key="privateSecurityKey
" value="469634ff-9ef9-4c7b-8cfd-cf3dd7337d18 "/> |
|
3 |
Настройка, определяющая валюту, в которой будет совершаться плажет через систему PayOnline |
- Contract - оплата в валюте путевки - Tour - оплата в валюте тура - National – оплата в национальной валюте - DefinedBySettings - оплата в валюте определенной настройкой currency |
<add key=""currencyToPay" value="Contract"/> |
|
4 |
Настройка, определяющая код валюты, в которой будет совершаться платеж через платежную систему PayOnline при значении DefinedBySettings настройки currencyToPay |
Код валюты (Поле RA_CODE из таблицы Rates) Код валюты из МТ должен быть сопоставлен с кодом валюты в системе PayOnline. Данное сопоставление задается в секции currency Map, в качестве параметра key указывается код валюты из МТ, в качестве параметра value задается код валюты в PayOnline, например: <currencyMap> <add key="рб" value="RUB"/> <add key="$" value="USD"/> <add key="EU" value="EUR"/> </currencyMap>
|
<add key="currency" value="рб"/> |
|
5 |
Настройка, определяющая тип операции при проведении платежа |
Ключ операции (Поле PO_ID из таблицы PaymentOperations) |
<add key="kindOfPay" value="6"/> |
|
6 |
Настройка, определяющая пользователя, к которому будет привязываться оплата |
Ключ пользователя, к которому привязывается оплата (Поле US_KEY из таблицы Dup_user) |
<add key="masterTourUser" value="80"/> |
|
7 |
Настройка, определяющая партнера, к которому будет привязываться оплата |
Ключ филиала, к которому привязывается оплата (Поле PR_KEY из талбицы Partners) |
<add key="filialKey" value="1"/> |
|
8 |
Настройка, определяющая отдел, к которому будет привязываться оплата |
Ключ отдела (кассы) (Поле PDP_KEY из таблицы PrtDeps), к которому привязывается оплата |
<add key="departmentKey" value="2"/> |
|
9 |
Настройка, определяющая курс валют на какую дату должен подбираться для пересчета суммы к оплате |
OrderDate — дата оформления заявки; Today — курс на текущую дату; ConfirmDate — курс на дату подтверждения заявки (если подтверждения путевки еще не было, либо курс на дату подтверждения не заведен, то будет отображаться курс на текущую дату); |
<add key="courseExchangeDate" value="OrderDate"/> |
|
10 |
Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для агентств) |
Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется запятой) |
<add key="addAgencyComission " value="3,627"/> |
|
11 |
Настройка, позволяющая задавать размер комиссии, которая будет включена в сумму оплаты (для частных лиц) |
Значение комиссии, которую необходимо включить в сумму платежа (целая часть отделяется запятой) |
<add key="addPersonalComission " value="5"/> |
|
12 |
Настройка, включающая механизм хэширования пароля пользователя, сохраняемого в файлах cookie, что позволяет усилить безопасность ПК "Мастер-Web". По умолчанию хэширование включено. Значение настройки должно совпадать со значением в файле web.config ПК "Мастер-Web".
|
- false - хэширование пароля в файлах cookie выключено; - true или отсутствие настройки - хэширование пароля в файлах cookie включено. |
<add key="HashPasswordForCookie" value="true" /> |
|
13 |
Настройка, включающая экран редактирования суммы к оплате.
|
- true - экран корректировки суммы к оплате отображается; - false или отсутствие настройки - экран корректировки суммы к оплате не отображается. |
<add key="allowCustomAmount" value="true" /> |
Подготовка данных
Оплату можно произвести по путевкам, статус которых указан в настройке paymentsStatuses. Для возможности оплаты через платёжную систему PayOnline тип платёжной операции (PaymentOperation), ключ которой указан в настройке kindOfPay, должен иметь бланки и иметь признак «Приходный» (PO_Type is null or PO_Type = 0).
Работа в системе
Поиск путевки
Список заявок, забронированных в базе данных туроператора, доступен по адресу: http: //ip-адрес сервера Мастер-Веб/MasterWebStandard/OrderList.aspx. Экран «Список заказов» доступен только для зарегистрированных и авторизованных в системе пользователей.
После ввода имени пользователя и пароля загрузится список заявок, оформленных на покупателя/агентство, указанного в поле «Партнер в БД МТ» при регистрации пользователя в Системе администрирования ПК Мастер-Веб, который сопоставлен имени текущего пользователя.
В этом экране пользователь может наложить ограничения на отбор заявок по:
- Номеру заявки в базе данных туроператора
- По стране
- Дате оформления заказа
- Периоду дат начала тура
- Заявки, имеющие в составе тура услугу «Виза»
- Неоплаченные или не полностью оплаченные заявки.
Оплата путевки
Оплата доступна только для путевок имеющих статус, ключ которого указан в настройке paymentsStatuses.
Оплата путевок доступна в экранах «Список заявок» и «Информация о заказе».
Экран «Список заявок» доступен по адресу: http: //ip-адрес сервера Мастер-Веб/MasterWebStandard/OrderList.aspx.
Экран «Информация о заказе» доступен по адресу: http: //ip-адрес сервера Мастер-Веб/MasterWebStandard/OrderInfo.aspx.
Для оплаты путевки через систему электронных платежей PayOnline необходимо нажать ссылку «Оплатить» для нужной путевки, после чего пользователь попадает в экран, в котором указывается номер заказа и сумма платежа.
Сумма к оплате выводится в национальной валюте. При необходимости, она конвертируется по соответствующему курсу.
Для оплаты необходимо нажать на «Оплатить с банковской карты».
Далее пользователь попадает в экран для ввода персональных данных:
В данном экране необходимо заполнить информацию, необходимую для проведения оплаты путевки. После того, как все поля заполнены, нужно нажать на кнопку «Оплатить», по нажатию которой загрузится экран «Информация о платеже»:
Для того чтобы вернуться к списку заявок нужно нажать на кнопку «Завершить».
При успешном проведении платежа в базе автоматически создается проводка и у путевки прописывается сумма оплаты. Также в истории путевки добавляется запись об оплате через платежную систему PayOnline.
