Платежные web-сервисы: Сервис интеграции с платежной системой (оплата через терминалы)

Введение

Данный модуль предназначен для проверки заявки и проведения платежа через платежную систему в базу туроператора. Модуль совместим со следующими платежными системами:

• TourPay
• Контакт
• Лидер

Установка

Для установки Сервиса для интеграции с платежной системой нужно создать директорию 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 – внутренняя ошибка при создании платежа;
• 3 - заявка была аннулирована;
• 4 - путевка уже оплачена;
• 5 - неправильный логин или пароль;
• 6 - некорректный или устаревший идентификатор авторизации (token).

При этом в БД создается платеж по выбранной путевке.