Платежные web-сервисы: Сервис интеграции с платежной системой (оплата через терминалы) — различия между версиями
[досмотренная версия] | [досмотренная версия] |
(Новая страница: «==Введение== Данный модуль предназначен для проверки заявки и проведения платежа через сис...») |
|||
Строка 6: | Строка 6: | ||
===Создание виртуального каталога=== | ===Создание виртуального каталога=== | ||
По умолчанию корневым каталогом IIS является C:/Inetpub/wwwroot. Для создания виртуального каталога для приложения находящегося в этом каталоге нужно выполнить следующие действия: | По умолчанию корневым каталогом IIS является C:/Inetpub/wwwroot. Для создания виртуального каталога для приложения находящегося в этом каталоге нужно выполнить следующие действия: | ||
− | *1. Зайти в Пуск (Start) – Настройки (Settings) – Панель управления (Control Panel) – Администрирование (Administrative Tools). | + | *1. Зайти в Пуск (Start) – Настройки (Settings) – Панель управления (Control Panel) – Администрирование (Administrative Tools) |
+ | <BR> | ||
+ | [[Файл:848.PNG]]<BR> | ||
+ | *2. Диспетчер служб IIS | ||
+ | <BR> | ||
+ | [[Файл:849.PNG]]<BR> | ||
+ | *3. В открывшемся дереве каталогов выбрать Web Sites – Default Web Site. В открывшемся списке найти папку, для которой нужно создать виртуальный каталог, кликнуть по ней правой кнопкой мыши и выбрать Преобразовать в приложение | ||
+ | <BR> | ||
+ | [[Файл:850.PNG]]<BR> | ||
+ | *4. В открывшемся окне нужно нажать кнопку «ОК» | ||
+ | <BR> | ||
+ | [[Файл:851.PNG]]<BR> | ||
+ | ===Подключение к базе данных ПК «Мастер-Тур»=== | ||
+ | В файле web.config, расположенном в папке Finance пропишите необходимые параметры подключения (курсивом выделены значения, которые необходимо ввести). | ||
+ | Строка подключения к базе данных ПК «Мастер-Тур»: | ||
+ | <add key = "connectionString" value = "Data Source=ip-адрес сервера базы данных ПК Мастер-тур;Initial Catalog=название базы данных ПК Мастер-тур;User ID=логин пользователя ПК Мастер-тур;Password=пароль пользователя ПК Мастер-тур"/> | ||
+ | ==Настройка== | ||
+ | После установки «Сервис для интеграции с системой Контакт» доступен по адресу http://ip- адрес сервера Мастер-Веб/Finance/FinanceService.asmx. | ||
+ | ===Настройки в файле WEB.CONFIG=== | ||
+ | Дополнительные настройки, задаются в файле web.config, находящемся в папке Finance. | ||
+ | <table class=MsoNormalTable border=0 cellspacing=0 cellpadding=0 width=645 | ||
+ | style='width:483.9pt;margin-left:-.75pt;border-collapse:collapse'> | ||
+ | <tr> | ||
+ | <td width=46 valign=top style='width:34.25pt;border:solid black 1.0pt; | ||
+ | border-right:none;padding:0cm 5.4pt 0cm 5.4pt'> | ||
+ | <p class=TitleTable style='layout-grid-mode:char'>№</p> | ||
+ | </td> | ||
+ | <td width=138 valign=top style='width:103.65pt;border:solid black 1.0pt; | ||
+ | border-right:none;padding:0cm 5.4pt 0cm 5.4pt'> | ||
+ | <p class=TitleTable style='layout-grid-mode:char'>Описание</p> | ||
+ | </td> | ||
+ | <td width=204 valign=top style='width:153.0pt;border:solid black 1.0pt; | ||
+ | border-right:none;padding:0cm 5.4pt 0cm 5.4pt'> | ||
+ | <p class=TitleTable style='layout-grid-mode:char'>Значение</p> | ||
+ | </td> | ||
+ | <td width=257 valign=top style='width:193.0pt;border:solid black 1.0pt; | ||
+ | padding:0cm 5.4pt 0cm 5.4pt'> | ||
+ | <p class=TitleTable style='layout-grid-mode:char'>Настройка</p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <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; | ||
+ | padding:0cm 5.4pt 0cm 5.4pt'> | ||
+ | <p class=Tabletext style='layout-grid-mode:char'>1</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; | ||
+ | padding:0cm 5.4pt 0cm 5.4pt'> | ||
+ | <p class=Tabletext style='layout-grid-mode:char'>Определение названия | ||
+ | настройки, определяющей тип платежной операции, в реестре настроек | ||
+ | туроператора</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; | ||
+ | padding:0cm 5.4pt 0cm 5.4pt'> | ||
+ | <p class=Tabletext style='layout-grid-mode:char'><b>Название настройки в реестре | ||
+ | настроек туроператора</b></p> | ||
+ | </td> | ||
+ | <td width=257 valign=top style='width:193.0pt;border:solid black 1.0pt; | ||
+ | border-top:none;padding:0cm 5.4pt 0cm 5.4pt'> | ||
+ | <p class=MsoNormal style='layout-grid-mode:char'><span lang=EN-US><add key="<b>PaymentOperationId | ||
+ | </b>" value="<b><i><span style='color:blue'>SYSPaymentOperationId</span></i></b>"/></span></p> | ||
+ | </td> | ||
+ | </tr> | ||
+ | </table> | ||
+ | ==Подготовка данных== | ||
+ | Проверка заявок и проведение платежа через систему Контакт в базу туроператора осуществляется по оформленным путевкам. | ||
+ | ==Работа в системе== | ||
+ | ===Проверка заявки (метод CheckReservation)=== | ||
+ | |||
+ | ====Описание метода==== | ||
+ | |||
+ | Данный метод предназначен для проверки наличия заявки в БД и определения ее стоимости. | ||
+ | |||
+ | ====Сигнатура метода==== | ||
+ | |||
+ | public AmountSum CheckReservation(string dgCode) | ||
+ | |||
+ | ====Описание принимаемых методом параметров==== | ||
+ | |||
+ | *dgCode - строковая переменная, представляющая собой код проверяемой путевки. | ||
+ | |||
+ | ====Возвращаемые значения==== | ||
+ | |||
+ | Метод возвращает результат своей работы в виде класса AmountSum. Корректность результата проверяется значением поля ErrorCode данного класса: | ||
+ | |||
+ | ** 0 – результат корректный, в полях возвращены корректные значения; | ||
+ | ** 1 – заявка не найдена в БД. | ||
+ | |||
+ | Ниже приводится описание класса. | ||
+ | <nowiki>public class AmountSum | ||
+ | { | ||
+ | public double Amount | ||
+ | public string RateCode | ||
+ | public double NationalCurrencyPrice | ||
+ | public string NationalRateCode | ||
+ | public int ErrorCode | ||
+ | }</nowiki> | ||
+ | |||
+ | * Amount - сумма к оплате в валюте тура | ||
+ | * RateCode - iso-код валюты тура | ||
+ | * NationalCurrencyPrice - сумма к оплате в национальной валюте | ||
+ | * NationalRateCode - iso-код национальной валюты | ||
+ | * ErrorCode - код результата. | ||
+ | ===Проведение платежа по заявке (метод CreatePayment)=== | ||
+ | |||
+ | ====Описание метода=== | ||
+ | |||
+ | Данный метод предназначен для создания платежа по путевке в финансовом блоке ПК Мастер-Тур. | ||
+ | |||
+ | ====Сигнатура метода==== | ||
+ | |||
+ | public int CreatePayment(DateTime date, double sum, string currencyIsoCode, string reservationCode, string paymentId) | ||
+ | ====Описание принимаемых методом параметров==== | ||
+ | |||
+ | * date – дата проведения платежа | ||
+ | * sum – сумма платежа | ||
+ | * currencyIsoCode – ISO-код валюты, в которой осуществляется платеж | ||
+ | * reservationCode – номер путевки | ||
+ | * paymentId – идентификатор платежа во внешней системе | ||
+ | |||
+ | ====Возвращаемые значения==== | ||
+ | |||
+ | Данный метод возвращает целочисленное значение обозначающее результат выполнения операции: | ||
+ | * 0 – операция выполнена успешно, платеж проведен; | ||
+ | * 1 – заявка не найдена в БД; | ||
+ | * 2 – внутренняя ошибка при создании платежа. | ||
+ | |||
+ | При этом в БД создается платеж по выбранной путевке. | ||
+ | |||
[[Category:Мастер-Web_Дополнительные_модули]] | [[Category:Мастер-Web_Дополнительные_модули]] |
Версия 15:03, 1 ноября 2011
Содержание
Введение
Данный модуль предназначен для проверки заявки и проведения платежа через систему Контакт в базу туроператора.
Установка
Для установки Сервиса для интеграции с системой Контакт нужно создать директорию Finance в каталоге c:/inetpub/wwwroot/ (корневом каталоге IIS) и выложить туда распакованные файлы из архива mw-finance-2007.2.XX.XXXX.zip. В управлении IIS необходимо создать виртуальный каталог для папки Finance.
Создание виртуального каталога
По умолчанию корневым каталогом IIS является C:/Inetpub/wwwroot. Для создания виртуального каталога для приложения находящегося в этом каталоге нужно выполнить следующие действия:
- 1. Зайти в Пуск (Start) – Настройки (Settings) – Панель управления (Control Panel) – Администрирование (Administrative Tools)
- 2. Диспетчер служб IIS
- 3. В открывшемся дереве каталогов выбрать Web Sites – Default Web Site. В открывшемся списке найти папку, для которой нужно создать виртуальный каталог, кликнуть по ней правой кнопкой мыши и выбрать Преобразовать в приложение
- 4. В открывшемся окне нужно нажать кнопку «ОК»
Подключение к базе данных ПК «Мастер-Тур»
В файле web.config, расположенном в папке Finance пропишите необходимые параметры подключения (курсивом выделены значения, которые необходимо ввести). Строка подключения к базе данных ПК «Мастер-Тур»: <add key = "connectionString" value = "Data Source=ip-адрес сервера базы данных ПК Мастер-тур;Initial Catalog=название базы данных ПК Мастер-тур;User ID=логин пользователя ПК Мастер-тур;Password=пароль пользователя ПК Мастер-тур"/>
Настройка
После установки «Сервис для интеграции с системой Контакт» доступен по адресу http://ip- адрес сервера Мастер-Веб/Finance/FinanceService.asmx.
Настройки в файле WEB.CONFIG
Дополнительные настройки, задаются в файле web.config, находящемся в папке Finance.
№ |
Описание |
Значение |
Настройка |
1 |
Определение названия настройки, определяющей тип платежной операции, в реестре настроек туроператора |
Название настройки в реестре настроек туроператора |
<add key="PaymentOperationId " value="SYSPaymentOperationId"/> |
Подготовка данных
Проверка заявок и проведение платежа через систему Контакт в базу туроператора осуществляется по оформленным путевкам.
Работа в системе
Проверка заявки (метод CheckReservation)
Описание метода
Данный метод предназначен для проверки наличия заявки в БД и определения ее стоимости.
Сигнатура метода
public AmountSum CheckReservation(string dgCode)
Описание принимаемых методом параметров
- dgCode - строковая переменная, представляющая собой код проверяемой путевки.
Возвращаемые значения
Метод возвращает результат своей работы в виде класса AmountSum. Корректность результата проверяется значением поля ErrorCode данного класса:
- 0 – результат корректный, в полях возвращены корректные значения;
- 1 – заявка не найдена в БД.
Ниже приводится описание класса.
public class AmountSum { public double Amount public string RateCode public double NationalCurrencyPrice public string NationalRateCode public int ErrorCode }
- Amount - сумма к оплате в валюте тура
- RateCode - iso-код валюты тура
- NationalCurrencyPrice - сумма к оплате в национальной валюте
- NationalRateCode - iso-код национальной валюты
- ErrorCode - код результата.
Проведение платежа по заявке (метод CreatePayment)
=Описание метода
Данный метод предназначен для создания платежа по путевке в финансовом блоке ПК Мастер-Тур.
Сигнатура метода
public int CreatePayment(DateTime date, double sum, string currencyIsoCode, string reservationCode, string paymentId)
Описание принимаемых методом параметров
- date – дата проведения платежа
- sum – сумма платежа
- currencyIsoCode – ISO-код валюты, в которой осуществляется платеж
- reservationCode – номер путевки
- paymentId – идентификатор платежа во внешней системе
Возвращаемые значения
Данный метод возвращает целочисленное значение обозначающее результат выполнения операции:
- 0 – операция выполнена успешно, платеж проведен;
- 1 – заявка не найдена в БД;
- 2 – внутренняя ошибка при создании платежа.
При этом в БД создается платеж по выбранной путевке.