Платежные web-сервисы: Сервис интеграции с платежной системой (оплата через терминалы) — различия между версиями
[досмотренная версия] | [непроверенная версия] |
Biryukov (обсуждение | вклад) (→Введение) |
Achkasov (обсуждение | вклад) |
||
Строка 7: | Строка 7: | ||
[http://wiki.megatec.ru/index.php?title=Мастер-Web:_Дополнительный_модуль_Сервис_для_интеграции_с_платежной_системой_(Прием_наличных_через_платежный_терминал)&oldid=8105 До 2009.2.15 включительно]<br /> | [http://wiki.megatec.ru/index.php?title=Мастер-Web:_Дополнительный_модуль_Сервис_для_интеграции_с_платежной_системой_(Прием_наличных_через_платежный_терминал)&oldid=8105 До 2009.2.15 включительно]<br /> | ||
[http://wiki.megatec.ru/index.php?title=Мастер-Web:Дополнительный_модуль_Сервис_для_интеграции_с_платежной_системой_(Прием_наличных_через_платежный_терминал)&stableid=11202 До 2009.2.19 включительно]<br /> | [http://wiki.megatec.ru/index.php?title=Мастер-Web:Дополнительный_модуль_Сервис_для_интеграции_с_платежной_системой_(Прием_наличных_через_платежный_терминал)&stableid=11202 До 2009.2.19 включительно]<br /> | ||
+ | [http://wiki.megatec.ru/index.php?title=Мастер-Web:Дополнительный_модуль_Сервис_для_интеграции_с_платежной_системой_(Прием_наличных_через_платежный_терминал)&stableid=14113 До 2009.2.20.13 включительно]<br /> | ||
</td> | </td> | ||
</tr> | </tr> | ||
Строка 24: | Строка 25: | ||
Для установки '''Сервиса для интеграции с платежной системой''' нужно создать директорию '''Finance''' в каталоге <code>c:/inetpub/wwwroot/</code> (корневом каталоге '''IIS''') и выложить туда распакованные файлы из архива <code>mw-finance-2007.2.XX.XXXX.zip</code> | Для установки '''Сервиса для интеграции с платежной системой''' нужно создать директорию '''Finance''' в каталоге <code>c:/inetpub/wwwroot/</code> (корневом каталоге '''IIS''') и выложить туда распакованные файлы из архива <code>mw-finance-2007.2.XX.XXXX.zip</code> | ||
В управлении '''IIS''' необходимо создать виртуальный каталог для папки '''Finance'''. | В управлении '''IIS''' необходимо создать виртуальный каталог для папки '''Finance'''. | ||
+ | |||
===Создание виртуального каталога=== | ===Создание виртуального каталога=== | ||
По умолчанию корневым каталогом '''IIS''' является <code>C:/Inetpub/wwwroot</code>. Для создания виртуального каталога для приложения находящегося в этом каталоге нужно выполнить следующие действия:<br /> | По умолчанию корневым каталогом '''IIS''' является <code>C:/Inetpub/wwwroot</code>. Для создания виртуального каталога для приложения находящегося в этом каталоге нужно выполнить следующие действия:<br /> | ||
Строка 38: | Строка 40: | ||
[[Файл: am_748.png|x500px|Добавить приложение]]<br /> | [[Файл: am_748.png|x500px|Добавить приложение]]<br /> | ||
<br /> | <br /> | ||
+ | |||
===Подключение к базе данных ПК «Мастер-Тур»=== | ===Подключение к базе данных ПК «Мастер-Тур»=== | ||
В файле <code>web.config</code>, расположенном в папке '''Finance''' пропишите необходимые параметры подключения (<span style="color:red">красным цветом</span> выделены значения, которые необходимо ввести). | В файле <code>web.config</code>, расположенном в папке '''Finance''' пропишите необходимые параметры подключения (<span style="color:red">красным цветом</span> выделены значения, которые необходимо ввести). | ||
Строка подключения к базе данных ПК «Мастер-Тур»:<br /> | Строка подключения к базе данных ПК «Мастер-Тур»:<br /> | ||
<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> | <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> | ||
+ | |||
==Настройка== | ==Настройка== | ||
После установки ''сервис для интеграции'' (например «Сервис для интеграции с платежной системой Название_Системы») доступен по адресу<br /> | После установки ''сервис для интеграции'' (например «Сервис для интеграции с платежной системой Название_Системы») доступен по адресу<br /> | ||
<code><nowiki>http://ip-адрес сервера Мастер-Веб/Finance/FinanceService.asmx</nowiki></code>. | <code><nowiki>http://ip-адрес сервера Мастер-Веб/Finance/FinanceService.asmx</nowiki></code>. | ||
+ | |||
===Настройки в файле WEB.CONFIG=== | ===Настройки в файле WEB.CONFIG=== | ||
Дополнительные настройки, задаются в файле <code>web.config</code>, находящемся в папке '''Finance'''. | Дополнительные настройки, задаются в файле <code>web.config</code>, находящемся в папке '''Finance'''. | ||
− | {| | + | {| 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 />Тип платежной операции так же может задаваться в настройке '''SYSPaymentOperationId''' в таблице ''SystemSettings''. В таком случае в настройке '''PaymentOperationId''' задается название настройки из таблицы ''SystemSettings''. | |
− | + | Обязательная настройка. | |
− | | | + | | '''Идентификатор (PO_Id) типа операции из таблицы PaymentOperations.'''<br /><br />'''Либо название настройки SYSPaymentOperationId из таблицы SystemSettings.''' |
− | |- | + | |<syntaxhighlight lang="xml" enclose="div"> |
− | | | + | <add key="PaymentOperationId" value="1" /> |
− | + | </syntaxhighlight> | |
− | + | ||
+ | |- style="vertical-align:text-top" | ||
+ | |||
+ | | 2 | ||
+ | | Определяет время действия ''идентификатора аутентифации'' ('''token'''). | ||
+ | | '''Время действия (в минутах).''' | ||
+ | |<syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="TokenExpireTime" value="10</span>" /> | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | |||
+ | | 3 | ||
+ | | Включение режима ''записи нового платежа'' в систему '''«Мастер-Финанс»'''. При этом в ПК «Мастер-Тур» платежи ''не сохраняются''. | ||
+ | | '''true''' - включена запись платежей в «Мастер-Финанс»; | ||
'''false''' или '''отсутствие настройки''' - выключает запись платежей в «Мастер-Финанс». | '''false''' или '''отсутствие настройки''' - выключает запись платежей в «Мастер-Финанс». | ||
− | | | + | |<syntaxhighlight lang="xml" enclose="div"> |
− | |- | + | <add key="AddPaymentsToMasterFinance" value="true"/> |
− | | | + | </syntaxhighlight> |
− | + | ||
− | + | |- style="vertical-align:text-top" | |
− | | | + | |
− | |- | + | | 4 |
− | | | + | | Определяет ''тип платежной системы'' при сохранении платежей в систему '''«Мастер-Финанс»''' (столбец '''DP_PAYMENTSSYS''' таблицы '''FIN_DOGOVOR_PAID'''). |
− | + | | '''Название платежной системы.''' | |
− | + | |<syntaxhighlight lang="xml" enclose="div"> | |
+ | <add key="PaymentSystem" value="TourPay"/> | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | |||
+ | | 5 | ||
+ | | Настройка, определяющая ''дату'', на которую должен ''подбираться курс валют'' для пересчета ''суммы к оплате''. | ||
+ | | '''orderdate''' — дата ''оформления заявки'';<br /> | ||
'''today''' — курс на ''текущую дату'';<br /> | '''today''' — курс на ''текущую дату'';<br /> | ||
'''confirmdate''' — курс на ''дату подтверждения заявки'' (если ''подтверждения'' путевки еще ''не было'', либо курс на ''дату подтверждения не заведен'', то будет ''отображаться'' курс на ''текущую дату'');<br /> | '''confirmdate''' — курс на ''дату подтверждения заявки'' (если ''подтверждения'' путевки еще ''не было'', либо курс на ''дату подтверждения не заведен'', то будет ''отображаться'' курс на ''текущую дату'');<br /> | ||
'''fixationdate''' — курс на ''дату фиксации''. | '''fixationdate''' — курс на ''дату фиксации''. | ||
− | | | + | |<syntaxhighlight lang="xml" enclose="div"> |
− | |- | + | <add key="courseExchangeDate" value="orderdate"/> |
− | | | + | </syntaxhighlight> |
− | + | ||
− | + | |- style="vertical-align:text-top" | |
+ | |||
+ | | 6 | ||
+ | | Настройка, позволяющая включить механизм [[#Логирование|логирования]]. | ||
+ | | '''true''' — система логирования ''включена''; | ||
'''false''' или '''отсутствие настройки''' — логирование ''выключено''. | '''false''' или '''отсутствие настройки''' — логирование ''выключено''. | ||
− | | | + | |<syntaxhighlight lang="xml" enclose="div"> |
− | |- | + | <add key="UseLog" value="true"/> |
− | | | + | </syntaxhighlight> |
− | + | ||
− | + | |- style="vertical-align:text-top" | |
+ | |||
+ | | 7 | ||
+ | | Настройка определяющая ''филиал'', с которым будет ''создан платеж''. | ||
+ | | '''Reservation''' — филиал ''путевки''; | ||
'''CurrentUser''' или '''отсутствие настройки''' — филиал ''пользователя, от имени которого работает сервис''. | '''CurrentUser''' или '''отсутствие настройки''' — филиал ''пользователя, от имени которого работает сервис''. | ||
− | | | + | |<syntaxhighlight lang="xml" enclose="div"> |
+ | <add key="PaymentFilialSource" value="CurrentUser"/> | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | |||
+ | | 8 | ||
+ | | Настройка определяющая '''типы платежей''', при которых разрешена '''оплата путевки через сервис'''. | ||
+ | | '''Типы платежей''' - поле '''PT_KEY''' из таблицы <code>'''[Paymenttype]'''</code> (через запятую). | ||
+ | |<syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="allowedPaymentTypes" value="4"/> | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | |- style="vertical-align:text-top" | ||
+ | |||
+ | | 9 | ||
+ | | Настройка, указывающая что в качестве '''лица''', от которого '''принята оплата''' надо всегда использовать '''представителя агентства''' ('''DUP_USER'''). | ||
+ | | '''true''' - в качестве лица, от которого принята оплата всегда указывается ФИО представителя агентства (поле '''US_FULLNAME''' из таблицы <code>'''[DUP_USER]'''</code>. | ||
+ | '''false''' или '''отсутствии настройки''' - работает стандартный механизм выбора лица, от которого принят платеж. | ||
+ | |<syntaxhighlight lang="xml" enclose="div"> | ||
+ | <add key="useDupUserAsPayer" value="true"/> | ||
+ | </syntaxhighlight> | ||
|} | |} | ||
Строка 127: | Строка 183: | ||
===Аутентификация (метод GetUserToken)=== | ===Аутентификация (метод GetUserToken)=== | ||
Метод возвращает строку - ''идентификатор аутентификации'', который используется для ''подтверждения авторизации'' при вызове методов web-сервисов. | Метод возвращает строку - ''идентификатор аутентификации'', который используется для ''подтверждения авторизации'' при вызове методов web-сервисов. | ||
+ | |||
====Сигнатура метода==== | ====Сигнатура метода==== | ||
<code>public TokenResult GetUserToken(string userLogin, string userPassword)</code> | <code>public TokenResult GetUserToken(string userLogin, string userPassword)</code> | ||
+ | |||
====Описание принимаемых методом параметров==== | ====Описание принимаемых методом параметров==== | ||
* '''userLogin''' - ''имя пользователя'' on-line системы бронирования ПК «Мастер-Web»; | * '''userLogin''' - ''имя пользователя'' on-line системы бронирования ПК «Мастер-Web»; | ||
* '''userPassword''' - ''пароль'' пользователя on-line системы бронирования ПК «Мастер-Web». | * '''userPassword''' - ''пароль'' пользователя on-line системы бронирования ПК «Мастер-Web». | ||
+ | |||
====Возвращаемые значения==== | ====Возвращаемые значения==== | ||
Метод возвращает результат своей работы в виде класса '''TokenResult'''. Корректность результата проверяется значением поля '''ErrorCode''' данного класса: | Метод возвращает результат своей работы в виде класса '''TokenResult'''. Корректность результата проверяется значением поля '''ErrorCode''' данного класса: | ||
Строка 137: | Строка 196: | ||
* '''2''' – внутренняя ошибка; | * '''2''' – внутренняя ошибка; | ||
* '''5''' - неправильный логин или пароль. | * '''5''' - неправильный логин или пароль. | ||
− | Описание класса | + | |
− | + | Описание класса: | |
+ | |||
+ | {| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse" | ||
+ | |||
+ | |- style="background-color:#F2F2F2" | ||
+ | |- style="vertical-align:text-top" | ||
+ | |||
+ | | <syntaxhighlight lang="cpp"> | ||
+ | public class TokenResult | ||
{ | { | ||
public int ErrorCode; | public int ErrorCode; | ||
public string Token; | public string Token; | ||
− | } | + | }</syntaxhighlight> |
− | + | |} | |
− | + | <br /> | |
− | |||
* '''ErrorCode''' - код результата; | * '''ErrorCode''' - код результата; | ||
* '''Token''' - идентификатор аутентификации. | * '''Token''' - идентификатор аутентификации. | ||
Строка 174: | Строка 240: | ||
* '''4''' - путевка уже оплачена; | * '''4''' - путевка уже оплачена; | ||
* '''6''' - некорректный или устаревший идентификатор аутентификации(token). | * '''6''' - некорректный или устаревший идентификатор аутентификации(token). | ||
+ | * '''8''' - запрещено создавать платеж по путевке, так есть платежи с типами, не указанными в настройке '''allowedPayments'''. | ||
+ | Описание класса: | ||
+ | |||
+ | {| border="1" cellpadding="8" style="background-color:#F9F9F9; border:#AAAAAA; border-collapse:collapse" | ||
+ | |||
+ | |- style="background-color:#F2F2F2" | ||
+ | |- style="vertical-align:text-top" | ||
− | + | | <syntaxhighlight lang="cpp"> | |
− | + | public class AmountSum | |
{ | { | ||
public double Amount | public double Amount | ||
Строка 186: | Строка 259: | ||
public DateTime BeginTourDate | public DateTime BeginTourDate | ||
public DateTime EndTourDate | public DateTime EndTourDate | ||
− | }</ | + | } |
− | + | </syntaxhighlight> | |
+ | |} | ||
+ | <br /> | ||
* '''Amount''' - сумма к оплате в валюте тура; | * '''Amount''' - сумма к оплате в валюте тура; | ||
* '''RateCode''' - iso-код валюты тура; | * '''RateCode''' - iso-код валюты тура; | ||
Строка 197: | Строка 272: | ||
* '''EndTourDate''' - дата окончания тура. | * '''EndTourDate''' - дата окончания тура. | ||
* '''MainTouristFIO''' - фамилия и инициалы главного туриста. | * '''MainTouristFIO''' - фамилия и инициалы главного туриста. | ||
− | |||
===Проведение платежа по заявке (метод CreatePayment)=== | ===Проведение платежа по заявке (метод CreatePayment)=== |
Версия 12:48, 21 мая 2014
Версия статьи от 21-05-2014. Для перехода на версию статьи, соответствующую используемой Вами версии программы, нажмите ссылку в таблице ниже:
Более ранние версии: |
Содержание
Введение
Данный модуль предназначен для проверки заявки и проведения платежа через платежную систему в базу туроператора. Модуль совместим со следующими платежными системами:
- TourPay
- PayTravel
Ссылка на тестовый сервис
С работой тестового сервиса для интеграции с платежной системой вы можете ознакомиться на нашем демо-сервере.
Установка
Для установки Сервиса для интеграции с платежной системой нужно создать директорию 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 | Определяет тип платежной операции. Тип платежной операции так же может задаваться в настройке SYSPaymentOperationId в таблице SystemSettings. В таком случае в настройке PaymentOperationId задается название настройки из таблицы SystemSettings. Обязательная настройка. |
Идентификатор (PO_Id) типа операции из таблицы PaymentOperations. Либо название настройки SYSPaymentOperationId из таблицы SystemSettings. |
<add key="PaymentOperationId" value="1" />
|
2 | Определяет время действия идентификатора аутентифации (token). | Время действия (в минутах). | <add key="TokenExpireTime" value="10</span>" />
|
3 | Включение режима записи нового платежа в систему «Мастер-Финанс». При этом в ПК «Мастер-Тур» платежи не сохраняются. | true - включена запись платежей в «Мастер-Финанс»;
false или отсутствие настройки - выключает запись платежей в «Мастер-Финанс». |
<add key="AddPaymentsToMasterFinance" value="true"/>
|
4 | Определяет тип платежной системы при сохранении платежей в систему «Мастер-Финанс» (столбец DP_PAYMENTSSYS таблицы FIN_DOGOVOR_PAID). | Название платежной системы. | <add key="PaymentSystem" value="TourPay"/>
|
5 | Настройка, определяющая дату, на которую должен подбираться курс валют для пересчета суммы к оплате. | orderdate — дата оформления заявки; today — курс на текущую дату; |
<add key="courseExchangeDate" value="orderdate"/>
|
6 | Настройка, позволяющая включить механизм логирования. | true — система логирования включена;
false или отсутствие настройки — логирование выключено. |
<add key="UseLog" value="true"/>
|
7 | Настройка определяющая филиал, с которым будет создан платеж. | Reservation — филиал путевки;
CurrentUser или отсутствие настройки — филиал пользователя, от имени которого работает сервис. |
<add key="PaymentFilialSource" value="CurrentUser"/>
|
8 | Настройка определяющая типы платежей, при которых разрешена оплата путевки через сервис. | Типы платежей - поле PT_KEY из таблицы [Paymenttype] (через запятую).
|
<add key="allowedPaymentTypes" value="4"/>
|
9 | Настройка, указывающая что в качестве лица, от которого принята оплата надо всегда использовать представителя агентства (DUP_USER). | true - в качестве лица, от которого принята оплата всегда указывается ФИО представителя агентства (поле US_FULLNAME из таблицы [DUP_USER] .
false или отсутствии настройки - работает стандартный механизм выбора лица, от которого принят платеж. |
<add key="useDupUserAsPayer" value="true"/>
|
Подготовка данных
Проверка заявок и проведение платежа через платежную систему в базу туроператора осуществляется по оформленным путевкам. У путевки должен быть зафиксирован курс валюты, т.е. в истории путевки должно присутствовать сообщение "Фиксация курса".
Логирование
Для детализации ошибок, которые могут возникнуть при работе web-сервиса (например, когда методы web-сервиса возвращают значение ErrorCode 2) можно включить логирование.
В секции <configSections>
надо добавить строку:
<section name="log4net" type="log4net.Config.Log4NetConfigurationSectionHandler, log4net" />
Далее (после секции <configSections>
) прописывается секция <log4net>
:
<log4net>
<appender name="ExceptionLogger" type="log4net.Appender.FileAppender">
<param name="File" value="C:\\MasterTourLogs\\ExceptionLogger.txt" />
<param name="AppendToFile" value="true" />
<layout type="log4net.Layout.PatternLayout">
<param name="ConversionPattern" value="%date [%thread] %-5level [%ndc] - %message %newline %exception" />
</layout>
</appender>
<logger name="ExceptionLogger">
<param name="Threshold" value="ALL" />
<appender-ref ref="ExceptionLogger" />
</logger>
</log4net>
Красным цветом выделен путь к файлу лога. Здесь может быть указан произвольный путь.
Работа в системе
Аутентификация (метод GetUserToken)
Метод возвращает строку - идентификатор аутентификации, который используется для подтверждения авторизации при вызове методов web-сервисов.
Сигнатура метода
public TokenResult GetUserToken(string userLogin, string userPassword)
Описание принимаемых методом параметров
- userLogin - имя пользователя on-line системы бронирования ПК «Мастер-Web»;
- userPassword - пароль пользователя on-line системы бронирования ПК «Мастер-Web».
Возвращаемые значения
Метод возвращает результат своей работы в виде класса TokenResult. Корректность результата проверяется значением поля ErrorCode данного класса:
- 0 - результат корректный;
- 2 – внутренняя ошибка;
- 5 - неправильный логин или пароль.
Описание класса:
public class TokenResult
{
public int ErrorCode;
public string Token;
}
|
- ErrorCode - код результата;
- Token - идентификатор аутентификации.
Проверка заявки (метод CheckReservation)
Описание метода
Данный метод предназначен для проверки наличия заявки в БД и определения ее стоимости.
Сигнатура метода
public AmountSum CheckReservation(string userToken, string dgCode)
Описание принимаемых методом параметров
- userToken - идентификатор аутентификации, полученный при вызове метода GetUserToken;
- dgCode - строковая переменная, представляющая собой код проверяемой путевки.
Возвращаемые значения
Метод возвращает результат своей работы в виде класса AmountSum. Корректность результата проверяется значением поля ErrorCode данного класса:
- 0 – результат корректный, в полях возвращены корректные значения;
- 1 – заявка не найдена в БД;
- 2 – внутренняя ошибка;
- 3 - заявка была аннулирована;
- 4 - путевка уже оплачена;
- 6 - некорректный или устаревший идентификатор аутентификации(token).
- 8 - запрещено создавать платеж по путевке, так есть платежи с типами, не указанными в настройке allowedPayments.
Описание класса:
public class AmountSum
{
public double Amount
public string RateCode
public double NationalCurrencyPrice
public string NationalRateCode
public int ErrorCode
public int FilialKey
public DateTime BeginTourDate
public DateTime EndTourDate
}
|
- Amount - сумма к оплате в валюте тура;
- RateCode - iso-код валюты тура;
- NationalCurrencyPrice - сумма к оплате в национальной валюте;
- NationalRateCode - iso-код национальной валюты;
- ErrorCode - код результата;
- FilialKey - ключ филиала, который создал заявку;
- BeginTourDate - дата начала тура;
- EndTourDate - дата окончания тура.
- MainTouristFIO - фамилия и инициалы главного туриста.
Проведение платежа по заявке (метод CreatePayment)
Описание метода
Данный метод предназначен для создания платежа по путевке в финансовом блоке ПК «Мастер-Тур».
Сигнатура метода
public int CreatePayment(string userToken, DateTime date, Decimal sum, string currencyIsoCode, string reservationCode, string paymentId)
Описание принимаемых методом параметров
- userToken - идентификатор аутентифкации;
- date – дата проведения платежа;
- sum – сумма платежа;
- currencyIsoCode – ISO-код валюты, в которой осуществляется платеж;
- reservationCode – номер путевки;
- paymentId – идентификатор платежа во внешней системе.
Возвращаемые значения
Данный метод возвращает целочисленное значение обозначающее результат выполнения операции:
- 0 – операция выполнена успешно, платеж проведен;
- 1 – заявка не найдена в БД;
- 2 – внутренняя ошибка при создании платежа;
- 3 - заявка была аннулирована;
- 4 - путевка уже оплачена;
- 6 - некорректный или устаревший идентификатор аутентификации(token).
- 7 - платеж с таким идентификатором уже существует.
При этом в БД создается платеж по выбранной путевке.