Центр поддержки системы бронирования - Вклад участника [ru]

Баланс компаний

2020-06-03T11:17:27Z

Мария Горшенева: /* Способы работы с балансом компаний */

[[Категория:Способы оплаты]]
[[Категория:Модули]]
[[Категория:Встроенные модули]]
[[Категория:Настройки]]
[[Категория:Решения для B2B]]

'''Баланс компаний''' — модуль [http://www.nemo-ibe.com системы онлайн-бронирования {{NameSystem}}] для работы агентств со счетами субагентов.

==Назначение==

{{NameSystem}} поддерживает работу юридических лиц с системой счетов. С использованием модуля субагент или корпоративный клиент может оплачивать авиабилеты списанием суммы со счета (баланса компании).

==Способы работы с балансом компаний==

В системе Nemo Travel есть два способа работы с балансом компании:
* внутренний учёт баланса компании в Nemo Travel
* работа с балансом собственной системы учёта агента по API посредством инструмента Midoffice API Toolkit: описан в документации по следующей ссылке: https://docs.nemo.travel/ru/nemo-backoffice-api/midoffice_api_toolkit

==Принцип работы внутреннего учёта баланса {{NameSystem}}==

Система счетов реализована за счет внутренних таблиц модуля. Система счетов '''не''' функционирует как работающий по протоколу с системой платежный шлюз. <br>Такая реализация платежного метода не обеспечивает достаточной защиты данных.

{{Attention|Механизмов защиты от злоупотреблений по счету в {{NameSystem}} нет. Агентству необходимо самостоятельно поддерживать внутри компании организационные меры по контролю счетов.}}

В стандартном режиме оплатить заказ с баланса компании может только менеджер или эксперт субагентства. Однако, в системе также допускается оплата с баланса компании обычному пользователю при выполнении одного из условий:
* На агентство подключен модуль '''Перераспределение средств'''. Ознакомиться с возможностями модуля можно в статье [[Перераспределение средств]].
* Задать счет на группу. Важно учесть, что группа, которой назначается счет, должна быть импортированной точкой продажи и размещаться на B2B сервере. Если помимо пользователей в группе содержатся субагентства, то счет на субагентство задается отдельно.

=== Просмотр информации о балансе компаний ===
====В Личном кабинете====
Информация о состоянии баланса компаний для менеджера корневого агентства и для менеджеров субагентств отображается в [[Личный кабинет#Финансы|личном кабинете]] в разделе '''Финансы'''.

Вкладка ''Финансы'' в личном кабинете доступна:
* менеджеру корневого агентства,
* экспертам корневого агентства,
* менеджерам субагентств, у которых заведен счет.

Раздел состоит из двух подразделов:
* '''Текущее состояние баланса''' - отображает информацию о компаниях, актуальной сумме на их балансе и размере доступного овердрафта. В этом разделе:
** ''менеджеру и эксперту агентства'' отображаются текущие суммы на балансе компании и доступный овердрафт всех своих субагентов
** ''менеджеру субагентства'' отображается текущая сумма баланса компании и доступного овердрафта только для его агентства.
* '''История операций''' - содержит историю операций по изменению, пополнению и списанию средств с баланса компании в обратном хронологическом порядке. В этом разделе:
** ''менеджеру и эксперту агентства'' отображаются все движения средств на балансе всех своих субагентов
** ''менеджеру субагентства'' отображаются все движения средств на балансе его агентства.

Подробную информацию о работе в личном кабинете {{NameSystem}} см. в статье [[Личный кабинет#Финансы|Личный кабинет]].

{|-valign="center"
|[[Файл:История операций в личном кабинете2.jpg|thumb|left|1060px|История операций в личном кабинете]]
|}
{|-valign="center"
|[[Файл:Подробная информация о текущем состоянии баланса компании2.jpg|thumb|left|650px|Подробная информация о текущем состоянии баланса компании]]
|}

====В панели администрирования====
''Менеджер и эксперт '''корневого агентства''''' может просматривать текущее состояние баланса компаний и историю операций по счетам всех своих субагентов в разделе '''Финансы и платежи → Баланс компаний → История операций'''. В зависимости от выбранного объекта применения настроек в таблице отображается информация о всех действиях по счету этого объекта. Если выбрана определенная компания, то в верхней части формы появляется кнопка '''Редактировать''' для перехода на страницу редактирования баланса и доступного овердрафта данной компании.

{| class="wikitable"
|-
|[[Файл:История операций2.jpg|1300px|История операций]]
|-
|История операций
|}

=== Управление счетами субагентов ===
Менеджер управляет счетами своих субагентов в разделе '''Финансы и платежи → Баланс компаний → Управление счетами'''.

Данные, отображаемые на странице, зависят от выбранного пользователя в поле ''Пользователь'':
* '''для корневого агентства''' на странице отображается таблица со всеми текущими счетами субагентств,
* '''для выбранной компании''' на странице отображается форма редактирования состояния счета данной компании.

==== Управление счетом всех компаний агентства====
Чтобы управлять счетами сразу всех своих субагентов без переключения по пользователям, в поле ''Пользователь'' выберите корневое агентство.

На странице отобразится таблица '''Управление счетами''', в которой содержатся данные по счетам субагентств с возможностью редактирования данных в таблице.

Таблица содержит данные по состоянию баланса и доступного овердрафта каждого субагента агентства. <br>
В таблице можно редактировать следующие данные:
* ''Баланс'',
* ''Доступный овердрафт'',
* ''Доступ к оплате с баланса компании''.

Значения столбцов:
* {{Setting|ID}} — идентификатор компании субагента. По этому столбцу можно отсортировать строки таблицы.
* {{Setting|Название компании субагента}} — в столбце доступно поле для поиска записей указанного агентства.
* {{Setting|Баланс}} — баланс субагентства. Изменение значения ячейки заменяет текущую сумму баланса субагента на введенную сумму.
* {{Setting|Доступный овердрафт}} — лимит овердрафта агентства (максимально допустимый "минус" у баланса). Если для субагента установлено значение "0", доступный овердрафт не установлен для данной компании, оплата заказов по овердрафту запрещена.
* {{Setting|Доступ к оплате с баланса компании}} — включает доступ субагентства к оплате с баланса компании. Если опция выключена, оплата заказов с баланса для компании запрещена.
* {{Setting|Редактирование}} — ссылка на страницу '''Управление балансом компаний'''.

{| class="wikitable"
|-
|[[Файл:Управление счетами2.jpg|700px|]]
|-
|Управление счетами
|}

====Управление балансом компаний====
Данный способ редактирования данных о балансе компании удобен менеджеру, когда пополнение баланса компании осуществляется в присутствии представителя компании. На странице отображается информация только по выбранной компании, информация об остальных компаниях остаётся закрыта.

В информационном поле, подсвеченным желтым цветом, отображается текущее значение баланса выбранного субагента: ''Баланс компании: <СУММА В ВАЛЮТЕ>''

Чтобы добавить счет или изменить лимит овердрафта субагента:
# Перейдите на страницу управления балансом компании субагента одним из способов:
#* в '''таблице управления счетами''' всего агентства нажмите кнопку ''Управление'',
#* выберите компанию в поле '''Пользователь'''
# Введите сумму, на которую необходимо пополнить (или уменьшить) баланс компании субагента, и/или установите доступный овердрафт в заданной валюте.
# При необходимости добавьте примечание в поле ''Комментарий к изменению состояния счета''. Примечание отображается в ''Истории операций'' в качестве комментария к данной операции.
# Нажмите кнопку '''Сохранить'''. В текущем окне в информационном поле, подсвеченным желтым цветом, появится новое значение баланса компании: ''Баланс компании: <СУММА В ВАЛЮТЕ>''

=====Параметры управления балансом компании=====
* {{Setting|Пополнить баланс на}} - сумма и валюта, на которую будет увеличен или уменьшен баланс компании субагента:
** положительное значение суммы - баланс компании субагента будет увеличен на заданную сумму,
** отрицательное значение суммы - баланс компании субагента будет уменьшен на заданную сумму.
* {{Setting|Доступный овердрафт}} - сумма и валюта, максимально допустимый "минус" у баланса. Когда баланс субагента исчерпан, он дополнительно сможет оформлять заказы на общую сумму в пределах доступного овердрафта.
* {{Setting|Сальдо корпоративного клиента из СОФИ}} - подробнее см. ниже раздел данной статьи [[Депозит#Интеграция сальдо клиента из СОФИ|Интеграция сальдо клиента из СОФИ]]
* {{Setting|Сумма распределенных счетов может превышать сумму баланса субагентства}} - позволяет установить для пользователя субагенства баланс, превышающий реальный баланс компании субагенства. В данном случае пользователь сможет оплатить перелет, только если на счету субагенства хватает средств на оплату данного перелета. Иначе пользователю будет выведено сообщение с просьбой обратиться в агентство. Настройка актуальна только при подключенном модуле [[Перераспределение средств]].
* {{Setting|Комментарий к изменению состояния счета}} - текстовый комментарий в произвольной форме, который станет виден субагенту в личном кабинете в разделе ''История операций''.
* {{Setting|Разрешить указание данных платежного поручения}} - опция включает возможность оплаты Аэроэкспресса(Sirena) по платежному поручению. На этапе оплаты с баланса компании агент или сотрудник агентства указывает дополнительные параметры, а именно: номер платежного поручения и наименование организации. Эти данные при оплате Аэроэкспресса направляются в GDS Sirena. Также эти данные отправляются в GDS Sirena при выписке билета.
Возможные значения опции:
# Нет - опция выключена;
# Да - дополнительные поля не являются обязательными, поэтому при отсутствии данных в GDS Sirena эта информация не передаётся (если в настройках задан суффикс - то передастся он).
# Обязательно - дополнительные поля обязательны к заполнению. {{Attention|При оплате с баланса компании заказов в других GDS (кроме Sirena) поля номера платежного поручения и наименование организации также будут обязательны к заполнению. Чтобы выписка билетов проходила успешно рекомендуется создать разные Платежные Шлюзы в зависимости от поставщика, настраивается в фильтрации ПШ.}}

* {{Setting|Суффикс для формы оплаты}} - двухбуквенный код передается в ГРС Sirena на этапе выписки заказа, при этом заказ должен быть оплачен с баланса компании. Суффиксы присваиваются корпоративным клиентам на стороне поставщика. Суффикс отображается в форме оплаты на МК поставщика. Данные платежного поручения будут отправлены поставщику, только если поле "Суффикс для формы оплаты" не заполнено.
{| class="wikitable"
|-
|[[Файл:Форма редактирования баланса компании2.jpg]]
|-
|Форма редактирования баланса компании
|}

== Автопополнение кредитного лимита ==
У каждого заказа, оплаченного с баланса компании, в таблице заказов личного кабинета в столбце '''Форма оплаты''' есть кнопка ''«Погасить кредит» / «Погашено»''. Менеджер и эксперт корневого агентства может вернуть на баланс компании сумму, равную стоимости конкретного заказа.
Чтобы зачислить на счет компании сумму, равную стоимости заказа, менеджер агентства должен выполнить следующие действия:
[[Файл:Таблица заказов ссылка на погашение кредита.jpg|thumb|480px|left|Таблица заказов - ссылка на погашение кредита]]
# Зайдите в '''Личный кабинет''' и откройте вкладку '''Заказы'''.
# Настройте в таблице вывод столбца ''Форма оплаты''.
# Найдите заказ, стоимость которого должна быть зачислена в счет оплаты кредита компании.
# Нажмите на ссылку '''Погасить кредит'''.
# Подтвердите операцию во всплывающем окне.
#* если сумма на балансе компании отрицательная, сумма будет зачислена в счет погашения кредита,
#* если сумма на балансе компании положительная, сумма будет зачислена на счет субагента.
# После успешного выполнения операции текст кнопки в столбце ''Форма оплаты'' меняется на ''Погашено'' и кнопка становится неактивной.

==Уведомление субагентов об изменении баланса компании и доступного овердрафта==

Каждый раз при пополнении, изменении баланса компании или доступного овердрафта субагента через разделы управления счетами, а также при импорте данных о балансе компании на электронный адрес субагента отправляется уведомление.

Уведомления отправляются на адрес, указанный в настройке '''Профили компании → Адрес электронной почты'''.<br>
Текст сообщений можно изменить в разделе [[Локализация|Языковые ресурсы]] через редактирование переменной.

===Уведомление об остатке на счете и по овердрафту===

Чтобы информировать клиента об остатке на счете и по овердрафту, достаточно включить две опции на форме редактирования баланса компании и доступного овердрафта:
*''Отправлять уведомление субагенту при остатке по овердрафту (%)'' — укажите процент от максимального овердрафта, по достижению которого на электронный адрес субагента отправляется нотификация, содержащая текущее значение баланса компании и доступного овердрафта.
*''Отправлять уведомление субагенту когда сумма на балансе меньше или равна'' — укажите значение баланса компании, по достижению которого на электронный адрес субагента будет направлено уведомление, содержащее текущее значение баланса компании и доступного овердрафта.
Параметры поддерживают только положительные числа, дробная часть отделяется точкой.

Текст сообщений можно изменить в разделе [[Языковые ресурсы]] через редактирование переменной.

== Возврат средств ==

При возврате ж/д билетов, оплаченных с баланса компании, субагент может вручную вернуть средства обратно на счет, при этом возвращается сумма, назначенная поставщиком, за вычетом сборов агентства за возврат.

===Автоматический возврат средств при аннуляции заказа===

Чтобы включить автоматический возврат средств у заказов имеющие статус ''оплачен, билеты еще не выписаны'', необходимо включить опцию '''Автоматически вернуть деньги после отмены заказа (только баланс компаний и МПС)''' для данного способа оплаты в разделе '''Финансы и платежи → Платежные методы → Управление шлюзами'''. <br>
Опция активирует автоматический возврат средств при аннуляции заказов, оплаченных через МПС (см. [[Сирена Трэвел#МПС (EgoPay)|МПС (EgoPay)]]) или с баланса компаний. <br>
{{Attention|Аннуляция должна быть запущена на стороне Nemo, из служебной информации, иначе автоматический возврат не произойдет, например, в случае аннуляции через терминал.}} <br>

Доступ к отмене оплаченного заказа имеет менеджер и эксперт главного агентства, а также менеджер и эксперты субагентств. Только под этими пользователями можно провести автоматический возврат средств при аннуляции заказа. Сделать это можно с помощью нажатия кнопки "'''Отменить выписку и снять места'''" в "Служебной информации". Остальным пользователям система автоматически предложит заполнить заявку на аннуляцию заказа, которую обработает менеджер или эксперт корневого агентства.

== Логирование данных ==
Чтобы найти детализированную информацию в виде логов по всем заказам, оплаченных с баланса компаний, в разделе '''Просмотр логов системы''' выставите фильтр '''''Платежный шлюз''''' на значение ''Баланс компании''. Подробную информацию см. в статье [[Логи системы]].

{| class="wikitable"
|-
|[[Файл:Поиск логов1.jpg|700px]]
|-
|Поиск логов
|}

== Интеграция сальдо клиента из СОФИ ==

В {{NameSystem}} можно обновлять значение баланса компании субагентов через СОФИ.

Этот способ полезен, если менеджеру не удобно для каждого клиента вручную корректировать баланс компании.

При корректировке баланса компании через СОФИ обновление происходит в двух местах:
* При оплате с баланса компании синхронизация пройдет автоматически, если это еще не было сделано вручную.
* Во вкладке ''Финансы'' в личном кабинете рядом с балансом компании и доступным овердрафтом находится строчка {{Setting|Последняя синхронизация}}, в которой указана дата. Если синхронизации не было, то вместо даты выводится «нет». Если с последней успешной синхронизации прошло менее 24 часов, то повторная синхронизация будет не доступна.

Менеджер агентства может обновить баланс компании любого субагентства, а менеджер субагентства — только своей компании.

Чтобы использовать интеграцию:
# У агентства должен быть подключен модуль {{Setting|Взаимодействие с СОФИ}}.
# Включите опцию {{Setting|Сальдо корпоративного клиента из СОФИ}} в разделе '''Финансы и платежи → Баланс компаний → Управление счетами'''.

Настройки, описанные ниже будут не доступны, если эта настройка не включена.

{{Attention|Для подключения опции необходимо обратиться к сотрудникам {{NameSystem}}.}}

Для успешной синхронизации у '''субагентства''' должны быть настроены:
* {{Setting|Код субагента в СОФИ}} в разделе '''Управление сайтом → Домены и протоколы'''.
* В разделе '''Для техподдержки → Устаревшие настройки → Реквизиты подключения''':
**Логин, пароль для доступа к сервису,
**WSDL адрес для запросов.

[[Файл:ЛК_Финансы_Депозит_СОФИ.jpg|750px|Для обновление депозита в личном кабинете необходимо использовать ссылку «Синхронизировать из СОФИ».]]

== См. также ==
* [[Перераспределение средств]]
* [[Импорт данных о балансе]]
* [[Лог]]
* [[Личный кабинет]]
* [[Пользователь#Группы в Nemo|Группы в {{NameSystem}}]]
* [[Валюта]]
* [[Интеграция сервиса приёма платежей с помощью Payment Gateway API|Универсальный протокол Payment Gateway API]]

Баланс компаний

2020-06-03T11:17:15Z

Мария Горшенева: /* Способы работы с балансом компаний */

[[Категория:Способы оплаты]]
[[Категория:Модули]]
[[Категория:Встроенные модули]]
[[Категория:Настройки]]
[[Категория:Решения для B2B]]

'''Баланс компаний''' — модуль [http://www.nemo-ibe.com системы онлайн-бронирования {{NameSystem}}] для работы агентств со счетами субагентов.

==Назначение==

{{NameSystem}} поддерживает работу юридических лиц с системой счетов. С использованием модуля субагент или корпоративный клиент может оплачивать авиабилеты списанием суммы со счета (баланса компании).

==Способы работы с балансом компаний==

В системе Nemo Travel есть два способа работы с балансом компании:
* внутренний учёт баланса компании в Nemo Travel
* работа с балансом собственной системы учёта агента по API посредством инструмента Midoffice API Toolkit: описан в документации по следующей ссылке: ссылке|https://docs.nemo.travel/ru/nemo-backoffice-api/midoffice_api_toolkit

==Принцип работы внутреннего учёта баланса {{NameSystem}}==

Система счетов реализована за счет внутренних таблиц модуля. Система счетов '''не''' функционирует как работающий по протоколу с системой платежный шлюз. <br>Такая реализация платежного метода не обеспечивает достаточной защиты данных.

{{Attention|Механизмов защиты от злоупотреблений по счету в {{NameSystem}} нет. Агентству необходимо самостоятельно поддерживать внутри компании организационные меры по контролю счетов.}}

В стандартном режиме оплатить заказ с баланса компании может только менеджер или эксперт субагентства. Однако, в системе также допускается оплата с баланса компании обычному пользователю при выполнении одного из условий:
* На агентство подключен модуль '''Перераспределение средств'''. Ознакомиться с возможностями модуля можно в статье [[Перераспределение средств]].
* Задать счет на группу. Важно учесть, что группа, которой назначается счет, должна быть импортированной точкой продажи и размещаться на B2B сервере. Если помимо пользователей в группе содержатся субагентства, то счет на субагентство задается отдельно.

=== Просмотр информации о балансе компаний ===
====В Личном кабинете====
Информация о состоянии баланса компаний для менеджера корневого агентства и для менеджеров субагентств отображается в [[Личный кабинет#Финансы|личном кабинете]] в разделе '''Финансы'''.

Вкладка ''Финансы'' в личном кабинете доступна:
* менеджеру корневого агентства,
* экспертам корневого агентства,
* менеджерам субагентств, у которых заведен счет.

Раздел состоит из двух подразделов:
* '''Текущее состояние баланса''' - отображает информацию о компаниях, актуальной сумме на их балансе и размере доступного овердрафта. В этом разделе:
** ''менеджеру и эксперту агентства'' отображаются текущие суммы на балансе компании и доступный овердрафт всех своих субагентов
** ''менеджеру субагентства'' отображается текущая сумма баланса компании и доступного овердрафта только для его агентства.
* '''История операций''' - содержит историю операций по изменению, пополнению и списанию средств с баланса компании в обратном хронологическом порядке. В этом разделе:
** ''менеджеру и эксперту агентства'' отображаются все движения средств на балансе всех своих субагентов
** ''менеджеру субагентства'' отображаются все движения средств на балансе его агентства.

Подробную информацию о работе в личном кабинете {{NameSystem}} см. в статье [[Личный кабинет#Финансы|Личный кабинет]].

{|-valign="center"
|[[Файл:История операций в личном кабинете2.jpg|thumb|left|1060px|История операций в личном кабинете]]
|}
{|-valign="center"
|[[Файл:Подробная информация о текущем состоянии баланса компании2.jpg|thumb|left|650px|Подробная информация о текущем состоянии баланса компании]]
|}

====В панели администрирования====
''Менеджер и эксперт '''корневого агентства''''' может просматривать текущее состояние баланса компаний и историю операций по счетам всех своих субагентов в разделе '''Финансы и платежи → Баланс компаний → История операций'''. В зависимости от выбранного объекта применения настроек в таблице отображается информация о всех действиях по счету этого объекта. Если выбрана определенная компания, то в верхней части формы появляется кнопка '''Редактировать''' для перехода на страницу редактирования баланса и доступного овердрафта данной компании.

{| class="wikitable"
|-
|[[Файл:История операций2.jpg|1300px|История операций]]
|-
|История операций
|}

=== Управление счетами субагентов ===
Менеджер управляет счетами своих субагентов в разделе '''Финансы и платежи → Баланс компаний → Управление счетами'''.

Данные, отображаемые на странице, зависят от выбранного пользователя в поле ''Пользователь'':
* '''для корневого агентства''' на странице отображается таблица со всеми текущими счетами субагентств,
* '''для выбранной компании''' на странице отображается форма редактирования состояния счета данной компании.

==== Управление счетом всех компаний агентства====
Чтобы управлять счетами сразу всех своих субагентов без переключения по пользователям, в поле ''Пользователь'' выберите корневое агентство.

На странице отобразится таблица '''Управление счетами''', в которой содержатся данные по счетам субагентств с возможностью редактирования данных в таблице.

Таблица содержит данные по состоянию баланса и доступного овердрафта каждого субагента агентства. <br>
В таблице можно редактировать следующие данные:
* ''Баланс'',
* ''Доступный овердрафт'',
* ''Доступ к оплате с баланса компании''.

Значения столбцов:
* {{Setting|ID}} — идентификатор компании субагента. По этому столбцу можно отсортировать строки таблицы.
* {{Setting|Название компании субагента}} — в столбце доступно поле для поиска записей указанного агентства.
* {{Setting|Баланс}} — баланс субагентства. Изменение значения ячейки заменяет текущую сумму баланса субагента на введенную сумму.
* {{Setting|Доступный овердрафт}} — лимит овердрафта агентства (максимально допустимый "минус" у баланса). Если для субагента установлено значение "0", доступный овердрафт не установлен для данной компании, оплата заказов по овердрафту запрещена.
* {{Setting|Доступ к оплате с баланса компании}} — включает доступ субагентства к оплате с баланса компании. Если опция выключена, оплата заказов с баланса для компании запрещена.
* {{Setting|Редактирование}} — ссылка на страницу '''Управление балансом компаний'''.

{| class="wikitable"
|-
|[[Файл:Управление счетами2.jpg|700px|]]
|-
|Управление счетами
|}

====Управление балансом компаний====
Данный способ редактирования данных о балансе компании удобен менеджеру, когда пополнение баланса компании осуществляется в присутствии представителя компании. На странице отображается информация только по выбранной компании, информация об остальных компаниях остаётся закрыта.

В информационном поле, подсвеченным желтым цветом, отображается текущее значение баланса выбранного субагента: ''Баланс компании: <СУММА В ВАЛЮТЕ>''

Чтобы добавить счет или изменить лимит овердрафта субагента:
# Перейдите на страницу управления балансом компании субагента одним из способов:
#* в '''таблице управления счетами''' всего агентства нажмите кнопку ''Управление'',
#* выберите компанию в поле '''Пользователь'''
# Введите сумму, на которую необходимо пополнить (или уменьшить) баланс компании субагента, и/или установите доступный овердрафт в заданной валюте.
# При необходимости добавьте примечание в поле ''Комментарий к изменению состояния счета''. Примечание отображается в ''Истории операций'' в качестве комментария к данной операции.
# Нажмите кнопку '''Сохранить'''. В текущем окне в информационном поле, подсвеченным желтым цветом, появится новое значение баланса компании: ''Баланс компании: <СУММА В ВАЛЮТЕ>''

=====Параметры управления балансом компании=====
* {{Setting|Пополнить баланс на}} - сумма и валюта, на которую будет увеличен или уменьшен баланс компании субагента:
** положительное значение суммы - баланс компании субагента будет увеличен на заданную сумму,
** отрицательное значение суммы - баланс компании субагента будет уменьшен на заданную сумму.
* {{Setting|Доступный овердрафт}} - сумма и валюта, максимально допустимый "минус" у баланса. Когда баланс субагента исчерпан, он дополнительно сможет оформлять заказы на общую сумму в пределах доступного овердрафта.
* {{Setting|Сальдо корпоративного клиента из СОФИ}} - подробнее см. ниже раздел данной статьи [[Депозит#Интеграция сальдо клиента из СОФИ|Интеграция сальдо клиента из СОФИ]]
* {{Setting|Сумма распределенных счетов может превышать сумму баланса субагентства}} - позволяет установить для пользователя субагенства баланс, превышающий реальный баланс компании субагенства. В данном случае пользователь сможет оплатить перелет, только если на счету субагенства хватает средств на оплату данного перелета. Иначе пользователю будет выведено сообщение с просьбой обратиться в агентство. Настройка актуальна только при подключенном модуле [[Перераспределение средств]].
* {{Setting|Комментарий к изменению состояния счета}} - текстовый комментарий в произвольной форме, который станет виден субагенту в личном кабинете в разделе ''История операций''.
* {{Setting|Разрешить указание данных платежного поручения}} - опция включает возможность оплаты Аэроэкспресса(Sirena) по платежному поручению. На этапе оплаты с баланса компании агент или сотрудник агентства указывает дополнительные параметры, а именно: номер платежного поручения и наименование организации. Эти данные при оплате Аэроэкспресса направляются в GDS Sirena. Также эти данные отправляются в GDS Sirena при выписке билета.
Возможные значения опции:
# Нет - опция выключена;
# Да - дополнительные поля не являются обязательными, поэтому при отсутствии данных в GDS Sirena эта информация не передаётся (если в настройках задан суффикс - то передастся он).
# Обязательно - дополнительные поля обязательны к заполнению. {{Attention|При оплате с баланса компании заказов в других GDS (кроме Sirena) поля номера платежного поручения и наименование организации также будут обязательны к заполнению. Чтобы выписка билетов проходила успешно рекомендуется создать разные Платежные Шлюзы в зависимости от поставщика, настраивается в фильтрации ПШ.}}

* {{Setting|Суффикс для формы оплаты}} - двухбуквенный код передается в ГРС Sirena на этапе выписки заказа, при этом заказ должен быть оплачен с баланса компании. Суффиксы присваиваются корпоративным клиентам на стороне поставщика. Суффикс отображается в форме оплаты на МК поставщика. Данные платежного поручения будут отправлены поставщику, только если поле "Суффикс для формы оплаты" не заполнено.
{| class="wikitable"
|-
|[[Файл:Форма редактирования баланса компании2.jpg]]
|-
|Форма редактирования баланса компании
|}

== Автопополнение кредитного лимита ==
У каждого заказа, оплаченного с баланса компании, в таблице заказов личного кабинета в столбце '''Форма оплаты''' есть кнопка ''«Погасить кредит» / «Погашено»''. Менеджер и эксперт корневого агентства может вернуть на баланс компании сумму, равную стоимости конкретного заказа.
Чтобы зачислить на счет компании сумму, равную стоимости заказа, менеджер агентства должен выполнить следующие действия:
[[Файл:Таблица заказов ссылка на погашение кредита.jpg|thumb|480px|left|Таблица заказов - ссылка на погашение кредита]]
# Зайдите в '''Личный кабинет''' и откройте вкладку '''Заказы'''.
# Настройте в таблице вывод столбца ''Форма оплаты''.
# Найдите заказ, стоимость которого должна быть зачислена в счет оплаты кредита компании.
# Нажмите на ссылку '''Погасить кредит'''.
# Подтвердите операцию во всплывающем окне.
#* если сумма на балансе компании отрицательная, сумма будет зачислена в счет погашения кредита,
#* если сумма на балансе компании положительная, сумма будет зачислена на счет субагента.
# После успешного выполнения операции текст кнопки в столбце ''Форма оплаты'' меняется на ''Погашено'' и кнопка становится неактивной.

==Уведомление субагентов об изменении баланса компании и доступного овердрафта==

Каждый раз при пополнении, изменении баланса компании или доступного овердрафта субагента через разделы управления счетами, а также при импорте данных о балансе компании на электронный адрес субагента отправляется уведомление.

Уведомления отправляются на адрес, указанный в настройке '''Профили компании → Адрес электронной почты'''.<br>
Текст сообщений можно изменить в разделе [[Локализация|Языковые ресурсы]] через редактирование переменной.

===Уведомление об остатке на счете и по овердрафту===

Чтобы информировать клиента об остатке на счете и по овердрафту, достаточно включить две опции на форме редактирования баланса компании и доступного овердрафта:
*''Отправлять уведомление субагенту при остатке по овердрафту (%)'' — укажите процент от максимального овердрафта, по достижению которого на электронный адрес субагента отправляется нотификация, содержащая текущее значение баланса компании и доступного овердрафта.
*''Отправлять уведомление субагенту когда сумма на балансе меньше или равна'' — укажите значение баланса компании, по достижению которого на электронный адрес субагента будет направлено уведомление, содержащее текущее значение баланса компании и доступного овердрафта.
Параметры поддерживают только положительные числа, дробная часть отделяется точкой.

Текст сообщений можно изменить в разделе [[Языковые ресурсы]] через редактирование переменной.

== Возврат средств ==

При возврате ж/д билетов, оплаченных с баланса компании, субагент может вручную вернуть средства обратно на счет, при этом возвращается сумма, назначенная поставщиком, за вычетом сборов агентства за возврат.

===Автоматический возврат средств при аннуляции заказа===

Чтобы включить автоматический возврат средств у заказов имеющие статус ''оплачен, билеты еще не выписаны'', необходимо включить опцию '''Автоматически вернуть деньги после отмены заказа (только баланс компаний и МПС)''' для данного способа оплаты в разделе '''Финансы и платежи → Платежные методы → Управление шлюзами'''. <br>
Опция активирует автоматический возврат средств при аннуляции заказов, оплаченных через МПС (см. [[Сирена Трэвел#МПС (EgoPay)|МПС (EgoPay)]]) или с баланса компаний. <br>
{{Attention|Аннуляция должна быть запущена на стороне Nemo, из служебной информации, иначе автоматический возврат не произойдет, например, в случае аннуляции через терминал.}} <br>

Доступ к отмене оплаченного заказа имеет менеджер и эксперт главного агентства, а также менеджер и эксперты субагентств. Только под этими пользователями можно провести автоматический возврат средств при аннуляции заказа. Сделать это можно с помощью нажатия кнопки "'''Отменить выписку и снять места'''" в "Служебной информации". Остальным пользователям система автоматически предложит заполнить заявку на аннуляцию заказа, которую обработает менеджер или эксперт корневого агентства.

== Логирование данных ==
Чтобы найти детализированную информацию в виде логов по всем заказам, оплаченных с баланса компаний, в разделе '''Просмотр логов системы''' выставите фильтр '''''Платежный шлюз''''' на значение ''Баланс компании''. Подробную информацию см. в статье [[Логи системы]].

{| class="wikitable"
|-
|[[Файл:Поиск логов1.jpg|700px]]
|-
|Поиск логов
|}

== Интеграция сальдо клиента из СОФИ ==

В {{NameSystem}} можно обновлять значение баланса компании субагентов через СОФИ.

Этот способ полезен, если менеджеру не удобно для каждого клиента вручную корректировать баланс компании.

При корректировке баланса компании через СОФИ обновление происходит в двух местах:
* При оплате с баланса компании синхронизация пройдет автоматически, если это еще не было сделано вручную.
* Во вкладке ''Финансы'' в личном кабинете рядом с балансом компании и доступным овердрафтом находится строчка {{Setting|Последняя синхронизация}}, в которой указана дата. Если синхронизации не было, то вместо даты выводится «нет». Если с последней успешной синхронизации прошло менее 24 часов, то повторная синхронизация будет не доступна.

Менеджер агентства может обновить баланс компании любого субагентства, а менеджер субагентства — только своей компании.

Чтобы использовать интеграцию:
# У агентства должен быть подключен модуль {{Setting|Взаимодействие с СОФИ}}.
# Включите опцию {{Setting|Сальдо корпоративного клиента из СОФИ}} в разделе '''Финансы и платежи → Баланс компаний → Управление счетами'''.

Настройки, описанные ниже будут не доступны, если эта настройка не включена.

{{Attention|Для подключения опции необходимо обратиться к сотрудникам {{NameSystem}}.}}

Для успешной синхронизации у '''субагентства''' должны быть настроены:
* {{Setting|Код субагента в СОФИ}} в разделе '''Управление сайтом → Домены и протоколы'''.
* В разделе '''Для техподдержки → Устаревшие настройки → Реквизиты подключения''':
**Логин, пароль для доступа к сервису,
**WSDL адрес для запросов.

[[Файл:ЛК_Финансы_Депозит_СОФИ.jpg|750px|Для обновление депозита в личном кабинете необходимо использовать ссылку «Синхронизировать из СОФИ».]]

== См. также ==
* [[Перераспределение средств]]
* [[Импорт данных о балансе]]
* [[Лог]]
* [[Личный кабинет]]
* [[Пользователь#Группы в Nemo|Группы в {{NameSystem}}]]
* [[Валюта]]
* [[Интеграция сервиса приёма платежей с помощью Payment Gateway API|Универсальный протокол Payment Gateway API]]

Баланс компаний

2020-06-03T11:16:56Z

Мария Горшенева: /* Способы работы с балансом компаний */

[[Категория:Способы оплаты]]
[[Категория:Модули]]
[[Категория:Встроенные модули]]
[[Категория:Настройки]]
[[Категория:Решения для B2B]]

'''Баланс компаний''' — модуль [http://www.nemo-ibe.com системы онлайн-бронирования {{NameSystem}}] для работы агентств со счетами субагентов.

==Назначение==

{{NameSystem}} поддерживает работу юридических лиц с системой счетов. С использованием модуля субагент или корпоративный клиент может оплачивать авиабилеты списанием суммы со счета (баланса компании).

==Способы работы с балансом компаний==

В системе Nemo Travel есть два способа работы с балансом компании:
* внутренний учёт баланса компании в Nemo Travel
* работа с балансом собственной системы учёта агента по API посредством инструмента Midoffice API Toolkit: описан в документации по следующей ссылке: [[ссылке|https://docs.nemo.travel/ru/nemo-backoffice-api/midoffice_api_toolkit]]

==Принцип работы внутреннего учёта баланса {{NameSystem}}==

Система счетов реализована за счет внутренних таблиц модуля. Система счетов '''не''' функционирует как работающий по протоколу с системой платежный шлюз. <br>Такая реализация платежного метода не обеспечивает достаточной защиты данных.

{{Attention|Механизмов защиты от злоупотреблений по счету в {{NameSystem}} нет. Агентству необходимо самостоятельно поддерживать внутри компании организационные меры по контролю счетов.}}

В стандартном режиме оплатить заказ с баланса компании может только менеджер или эксперт субагентства. Однако, в системе также допускается оплата с баланса компании обычному пользователю при выполнении одного из условий:
* На агентство подключен модуль '''Перераспределение средств'''. Ознакомиться с возможностями модуля можно в статье [[Перераспределение средств]].
* Задать счет на группу. Важно учесть, что группа, которой назначается счет, должна быть импортированной точкой продажи и размещаться на B2B сервере. Если помимо пользователей в группе содержатся субагентства, то счет на субагентство задается отдельно.

=== Просмотр информации о балансе компаний ===
====В Личном кабинете====
Информация о состоянии баланса компаний для менеджера корневого агентства и для менеджеров субагентств отображается в [[Личный кабинет#Финансы|личном кабинете]] в разделе '''Финансы'''.

Вкладка ''Финансы'' в личном кабинете доступна:
* менеджеру корневого агентства,
* экспертам корневого агентства,
* менеджерам субагентств, у которых заведен счет.

Раздел состоит из двух подразделов:
* '''Текущее состояние баланса''' - отображает информацию о компаниях, актуальной сумме на их балансе и размере доступного овердрафта. В этом разделе:
** ''менеджеру и эксперту агентства'' отображаются текущие суммы на балансе компании и доступный овердрафт всех своих субагентов
** ''менеджеру субагентства'' отображается текущая сумма баланса компании и доступного овердрафта только для его агентства.
* '''История операций''' - содержит историю операций по изменению, пополнению и списанию средств с баланса компании в обратном хронологическом порядке. В этом разделе:
** ''менеджеру и эксперту агентства'' отображаются все движения средств на балансе всех своих субагентов
** ''менеджеру субагентства'' отображаются все движения средств на балансе его агентства.

Подробную информацию о работе в личном кабинете {{NameSystem}} см. в статье [[Личный кабинет#Финансы|Личный кабинет]].

{|-valign="center"
|[[Файл:История операций в личном кабинете2.jpg|thumb|left|1060px|История операций в личном кабинете]]
|}
{|-valign="center"
|[[Файл:Подробная информация о текущем состоянии баланса компании2.jpg|thumb|left|650px|Подробная информация о текущем состоянии баланса компании]]
|}

====В панели администрирования====
''Менеджер и эксперт '''корневого агентства''''' может просматривать текущее состояние баланса компаний и историю операций по счетам всех своих субагентов в разделе '''Финансы и платежи → Баланс компаний → История операций'''. В зависимости от выбранного объекта применения настроек в таблице отображается информация о всех действиях по счету этого объекта. Если выбрана определенная компания, то в верхней части формы появляется кнопка '''Редактировать''' для перехода на страницу редактирования баланса и доступного овердрафта данной компании.

{| class="wikitable"
|-
|[[Файл:История операций2.jpg|1300px|История операций]]
|-
|История операций
|}

=== Управление счетами субагентов ===
Менеджер управляет счетами своих субагентов в разделе '''Финансы и платежи → Баланс компаний → Управление счетами'''.

Данные, отображаемые на странице, зависят от выбранного пользователя в поле ''Пользователь'':
* '''для корневого агентства''' на странице отображается таблица со всеми текущими счетами субагентств,
* '''для выбранной компании''' на странице отображается форма редактирования состояния счета данной компании.

==== Управление счетом всех компаний агентства====
Чтобы управлять счетами сразу всех своих субагентов без переключения по пользователям, в поле ''Пользователь'' выберите корневое агентство.

На странице отобразится таблица '''Управление счетами''', в которой содержатся данные по счетам субагентств с возможностью редактирования данных в таблице.

Таблица содержит данные по состоянию баланса и доступного овердрафта каждого субагента агентства. <br>
В таблице можно редактировать следующие данные:
* ''Баланс'',
* ''Доступный овердрафт'',
* ''Доступ к оплате с баланса компании''.

Значения столбцов:
* {{Setting|ID}} — идентификатор компании субагента. По этому столбцу можно отсортировать строки таблицы.
* {{Setting|Название компании субагента}} — в столбце доступно поле для поиска записей указанного агентства.
* {{Setting|Баланс}} — баланс субагентства. Изменение значения ячейки заменяет текущую сумму баланса субагента на введенную сумму.
* {{Setting|Доступный овердрафт}} — лимит овердрафта агентства (максимально допустимый "минус" у баланса). Если для субагента установлено значение "0", доступный овердрафт не установлен для данной компании, оплата заказов по овердрафту запрещена.
* {{Setting|Доступ к оплате с баланса компании}} — включает доступ субагентства к оплате с баланса компании. Если опция выключена, оплата заказов с баланса для компании запрещена.
* {{Setting|Редактирование}} — ссылка на страницу '''Управление балансом компаний'''.

{| class="wikitable"
|-
|[[Файл:Управление счетами2.jpg|700px|]]
|-
|Управление счетами
|}

====Управление балансом компаний====
Данный способ редактирования данных о балансе компании удобен менеджеру, когда пополнение баланса компании осуществляется в присутствии представителя компании. На странице отображается информация только по выбранной компании, информация об остальных компаниях остаётся закрыта.

В информационном поле, подсвеченным желтым цветом, отображается текущее значение баланса выбранного субагента: ''Баланс компании: <СУММА В ВАЛЮТЕ>''

Чтобы добавить счет или изменить лимит овердрафта субагента:
# Перейдите на страницу управления балансом компании субагента одним из способов:
#* в '''таблице управления счетами''' всего агентства нажмите кнопку ''Управление'',
#* выберите компанию в поле '''Пользователь'''
# Введите сумму, на которую необходимо пополнить (или уменьшить) баланс компании субагента, и/или установите доступный овердрафт в заданной валюте.
# При необходимости добавьте примечание в поле ''Комментарий к изменению состояния счета''. Примечание отображается в ''Истории операций'' в качестве комментария к данной операции.
# Нажмите кнопку '''Сохранить'''. В текущем окне в информационном поле, подсвеченным желтым цветом, появится новое значение баланса компании: ''Баланс компании: <СУММА В ВАЛЮТЕ>''

=====Параметры управления балансом компании=====
* {{Setting|Пополнить баланс на}} - сумма и валюта, на которую будет увеличен или уменьшен баланс компании субагента:
** положительное значение суммы - баланс компании субагента будет увеличен на заданную сумму,
** отрицательное значение суммы - баланс компании субагента будет уменьшен на заданную сумму.
* {{Setting|Доступный овердрафт}} - сумма и валюта, максимально допустимый "минус" у баланса. Когда баланс субагента исчерпан, он дополнительно сможет оформлять заказы на общую сумму в пределах доступного овердрафта.
* {{Setting|Сальдо корпоративного клиента из СОФИ}} - подробнее см. ниже раздел данной статьи [[Депозит#Интеграция сальдо клиента из СОФИ|Интеграция сальдо клиента из СОФИ]]
* {{Setting|Сумма распределенных счетов может превышать сумму баланса субагентства}} - позволяет установить для пользователя субагенства баланс, превышающий реальный баланс компании субагенства. В данном случае пользователь сможет оплатить перелет, только если на счету субагенства хватает средств на оплату данного перелета. Иначе пользователю будет выведено сообщение с просьбой обратиться в агентство. Настройка актуальна только при подключенном модуле [[Перераспределение средств]].
* {{Setting|Комментарий к изменению состояния счета}} - текстовый комментарий в произвольной форме, который станет виден субагенту в личном кабинете в разделе ''История операций''.
* {{Setting|Разрешить указание данных платежного поручения}} - опция включает возможность оплаты Аэроэкспресса(Sirena) по платежному поручению. На этапе оплаты с баланса компании агент или сотрудник агентства указывает дополнительные параметры, а именно: номер платежного поручения и наименование организации. Эти данные при оплате Аэроэкспресса направляются в GDS Sirena. Также эти данные отправляются в GDS Sirena при выписке билета.
Возможные значения опции:
# Нет - опция выключена;
# Да - дополнительные поля не являются обязательными, поэтому при отсутствии данных в GDS Sirena эта информация не передаётся (если в настройках задан суффикс - то передастся он).
# Обязательно - дополнительные поля обязательны к заполнению. {{Attention|При оплате с баланса компании заказов в других GDS (кроме Sirena) поля номера платежного поручения и наименование организации также будут обязательны к заполнению. Чтобы выписка билетов проходила успешно рекомендуется создать разные Платежные Шлюзы в зависимости от поставщика, настраивается в фильтрации ПШ.}}

* {{Setting|Суффикс для формы оплаты}} - двухбуквенный код передается в ГРС Sirena на этапе выписки заказа, при этом заказ должен быть оплачен с баланса компании. Суффиксы присваиваются корпоративным клиентам на стороне поставщика. Суффикс отображается в форме оплаты на МК поставщика. Данные платежного поручения будут отправлены поставщику, только если поле "Суффикс для формы оплаты" не заполнено.
{| class="wikitable"
|-
|[[Файл:Форма редактирования баланса компании2.jpg]]
|-
|Форма редактирования баланса компании
|}

== Автопополнение кредитного лимита ==
У каждого заказа, оплаченного с баланса компании, в таблице заказов личного кабинета в столбце '''Форма оплаты''' есть кнопка ''«Погасить кредит» / «Погашено»''. Менеджер и эксперт корневого агентства может вернуть на баланс компании сумму, равную стоимости конкретного заказа.
Чтобы зачислить на счет компании сумму, равную стоимости заказа, менеджер агентства должен выполнить следующие действия:
[[Файл:Таблица заказов ссылка на погашение кредита.jpg|thumb|480px|left|Таблица заказов - ссылка на погашение кредита]]
# Зайдите в '''Личный кабинет''' и откройте вкладку '''Заказы'''.
# Настройте в таблице вывод столбца ''Форма оплаты''.
# Найдите заказ, стоимость которого должна быть зачислена в счет оплаты кредита компании.
# Нажмите на ссылку '''Погасить кредит'''.
# Подтвердите операцию во всплывающем окне.
#* если сумма на балансе компании отрицательная, сумма будет зачислена в счет погашения кредита,
#* если сумма на балансе компании положительная, сумма будет зачислена на счет субагента.
# После успешного выполнения операции текст кнопки в столбце ''Форма оплаты'' меняется на ''Погашено'' и кнопка становится неактивной.

==Уведомление субагентов об изменении баланса компании и доступного овердрафта==

Каждый раз при пополнении, изменении баланса компании или доступного овердрафта субагента через разделы управления счетами, а также при импорте данных о балансе компании на электронный адрес субагента отправляется уведомление.

Уведомления отправляются на адрес, указанный в настройке '''Профили компании → Адрес электронной почты'''.<br>
Текст сообщений можно изменить в разделе [[Локализация|Языковые ресурсы]] через редактирование переменной.

===Уведомление об остатке на счете и по овердрафту===

Чтобы информировать клиента об остатке на счете и по овердрафту, достаточно включить две опции на форме редактирования баланса компании и доступного овердрафта:
*''Отправлять уведомление субагенту при остатке по овердрафту (%)'' — укажите процент от максимального овердрафта, по достижению которого на электронный адрес субагента отправляется нотификация, содержащая текущее значение баланса компании и доступного овердрафта.
*''Отправлять уведомление субагенту когда сумма на балансе меньше или равна'' — укажите значение баланса компании, по достижению которого на электронный адрес субагента будет направлено уведомление, содержащее текущее значение баланса компании и доступного овердрафта.
Параметры поддерживают только положительные числа, дробная часть отделяется точкой.

Текст сообщений можно изменить в разделе [[Языковые ресурсы]] через редактирование переменной.

== Возврат средств ==

При возврате ж/д билетов, оплаченных с баланса компании, субагент может вручную вернуть средства обратно на счет, при этом возвращается сумма, назначенная поставщиком, за вычетом сборов агентства за возврат.

===Автоматический возврат средств при аннуляции заказа===

Чтобы включить автоматический возврат средств у заказов имеющие статус ''оплачен, билеты еще не выписаны'', необходимо включить опцию '''Автоматически вернуть деньги после отмены заказа (только баланс компаний и МПС)''' для данного способа оплаты в разделе '''Финансы и платежи → Платежные методы → Управление шлюзами'''. <br>
Опция активирует автоматический возврат средств при аннуляции заказов, оплаченных через МПС (см. [[Сирена Трэвел#МПС (EgoPay)|МПС (EgoPay)]]) или с баланса компаний. <br>
{{Attention|Аннуляция должна быть запущена на стороне Nemo, из служебной информации, иначе автоматический возврат не произойдет, например, в случае аннуляции через терминал.}} <br>

Доступ к отмене оплаченного заказа имеет менеджер и эксперт главного агентства, а также менеджер и эксперты субагентств. Только под этими пользователями можно провести автоматический возврат средств при аннуляции заказа. Сделать это можно с помощью нажатия кнопки "'''Отменить выписку и снять места'''" в "Служебной информации". Остальным пользователям система автоматически предложит заполнить заявку на аннуляцию заказа, которую обработает менеджер или эксперт корневого агентства.

== Логирование данных ==
Чтобы найти детализированную информацию в виде логов по всем заказам, оплаченных с баланса компаний, в разделе '''Просмотр логов системы''' выставите фильтр '''''Платежный шлюз''''' на значение ''Баланс компании''. Подробную информацию см. в статье [[Логи системы]].

{| class="wikitable"
|-
|[[Файл:Поиск логов1.jpg|700px]]
|-
|Поиск логов
|}

== Интеграция сальдо клиента из СОФИ ==

В {{NameSystem}} можно обновлять значение баланса компании субагентов через СОФИ.

Этот способ полезен, если менеджеру не удобно для каждого клиента вручную корректировать баланс компании.

При корректировке баланса компании через СОФИ обновление происходит в двух местах:
* При оплате с баланса компании синхронизация пройдет автоматически, если это еще не было сделано вручную.
* Во вкладке ''Финансы'' в личном кабинете рядом с балансом компании и доступным овердрафтом находится строчка {{Setting|Последняя синхронизация}}, в которой указана дата. Если синхронизации не было, то вместо даты выводится «нет». Если с последней успешной синхронизации прошло менее 24 часов, то повторная синхронизация будет не доступна.

Менеджер агентства может обновить баланс компании любого субагентства, а менеджер субагентства — только своей компании.

Чтобы использовать интеграцию:
# У агентства должен быть подключен модуль {{Setting|Взаимодействие с СОФИ}}.
# Включите опцию {{Setting|Сальдо корпоративного клиента из СОФИ}} в разделе '''Финансы и платежи → Баланс компаний → Управление счетами'''.

Настройки, описанные ниже будут не доступны, если эта настройка не включена.

{{Attention|Для подключения опции необходимо обратиться к сотрудникам {{NameSystem}}.}}

Для успешной синхронизации у '''субагентства''' должны быть настроены:
* {{Setting|Код субагента в СОФИ}} в разделе '''Управление сайтом → Домены и протоколы'''.
* В разделе '''Для техподдержки → Устаревшие настройки → Реквизиты подключения''':
**Логин, пароль для доступа к сервису,
**WSDL адрес для запросов.

[[Файл:ЛК_Финансы_Депозит_СОФИ.jpg|750px|Для обновление депозита в личном кабинете необходимо использовать ссылку «Синхронизировать из СОФИ».]]

== См. также ==
* [[Перераспределение средств]]
* [[Импорт данных о балансе]]
* [[Лог]]
* [[Личный кабинет]]
* [[Пользователь#Группы в Nemo|Группы в {{NameSystem}}]]
* [[Валюта]]
* [[Интеграция сервиса приёма платежей с помощью Payment Gateway API|Универсальный протокол Payment Gateway API]]

Баланс компаний

2020-06-03T10:48:17Z

Мария Горшенева: /* Принцип работы */

[[Категория:Способы оплаты]]
[[Категория:Модули]]
[[Категория:Встроенные модули]]
[[Категория:Настройки]]
[[Категория:Решения для B2B]]

'''Баланс компаний''' — модуль [http://www.nemo-ibe.com системы онлайн-бронирования {{NameSystem}}] для работы агентств со счетами субагентов.

==Назначение==

{{NameSystem}} поддерживает работу юридических лиц с системой счетов. С использованием модуля субагент или корпоративный клиент может оплачивать авиабилеты списанием суммы со счета (баланса компании).

==Способы работы с балансом компаний==

В системе Nemo Travel есть два способа работы с балансом компании:
* внутренний учёт баланса компании в Nemo Travel
* работа с балансом собственной системы учёта агента по API посредством инструмента Midoffice API Toolkit: описан в документации по [[ссылке|https://docs.nemo.travel/ru/nemo-backoffice-api/midoffice_api_toolkit]]

==Принцип работы внутреннего учёта баланса {{NameSystem}}==

Система счетов реализована за счет внутренних таблиц модуля. Система счетов '''не''' функционирует как работающий по протоколу с системой платежный шлюз. <br>Такая реализация платежного метода не обеспечивает достаточной защиты данных.

{{Attention|Механизмов защиты от злоупотреблений по счету в {{NameSystem}} нет. Агентству необходимо самостоятельно поддерживать внутри компании организационные меры по контролю счетов.}}

В стандартном режиме оплатить заказ с баланса компании может только менеджер или эксперт субагентства. Однако, в системе также допускается оплата с баланса компании обычному пользователю при выполнении одного из условий:
* На агентство подключен модуль '''Перераспределение средств'''. Ознакомиться с возможностями модуля можно в статье [[Перераспределение средств]].
* Задать счет на группу. Важно учесть, что группа, которой назначается счет, должна быть импортированной точкой продажи и размещаться на B2B сервере. Если помимо пользователей в группе содержатся субагентства, то счет на субагентство задается отдельно.

=== Просмотр информации о балансе компаний ===
====В Личном кабинете====
Информация о состоянии баланса компаний для менеджера корневого агентства и для менеджеров субагентств отображается в [[Личный кабинет#Финансы|личном кабинете]] в разделе '''Финансы'''.

Вкладка ''Финансы'' в личном кабинете доступна:
* менеджеру корневого агентства,
* экспертам корневого агентства,
* менеджерам субагентств, у которых заведен счет.

Раздел состоит из двух подразделов:
* '''Текущее состояние баланса''' - отображает информацию о компаниях, актуальной сумме на их балансе и размере доступного овердрафта. В этом разделе:
** ''менеджеру и эксперту агентства'' отображаются текущие суммы на балансе компании и доступный овердрафт всех своих субагентов
** ''менеджеру субагентства'' отображается текущая сумма баланса компании и доступного овердрафта только для его агентства.
* '''История операций''' - содержит историю операций по изменению, пополнению и списанию средств с баланса компании в обратном хронологическом порядке. В этом разделе:
** ''менеджеру и эксперту агентства'' отображаются все движения средств на балансе всех своих субагентов
** ''менеджеру субагентства'' отображаются все движения средств на балансе его агентства.

Подробную информацию о работе в личном кабинете {{NameSystem}} см. в статье [[Личный кабинет#Финансы|Личный кабинет]].

{|-valign="center"
|[[Файл:История операций в личном кабинете2.jpg|thumb|left|1060px|История операций в личном кабинете]]
|}
{|-valign="center"
|[[Файл:Подробная информация о текущем состоянии баланса компании2.jpg|thumb|left|650px|Подробная информация о текущем состоянии баланса компании]]
|}

====В панели администрирования====
''Менеджер и эксперт '''корневого агентства''''' может просматривать текущее состояние баланса компаний и историю операций по счетам всех своих субагентов в разделе '''Финансы и платежи → Баланс компаний → История операций'''. В зависимости от выбранного объекта применения настроек в таблице отображается информация о всех действиях по счету этого объекта. Если выбрана определенная компания, то в верхней части формы появляется кнопка '''Редактировать''' для перехода на страницу редактирования баланса и доступного овердрафта данной компании.

{| class="wikitable"
|-
|[[Файл:История операций2.jpg|1300px|История операций]]
|-
|История операций
|}

=== Управление счетами субагентов ===
Менеджер управляет счетами своих субагентов в разделе '''Финансы и платежи → Баланс компаний → Управление счетами'''.

Данные, отображаемые на странице, зависят от выбранного пользователя в поле ''Пользователь'':
* '''для корневого агентства''' на странице отображается таблица со всеми текущими счетами субагентств,
* '''для выбранной компании''' на странице отображается форма редактирования состояния счета данной компании.

==== Управление счетом всех компаний агентства====
Чтобы управлять счетами сразу всех своих субагентов без переключения по пользователям, в поле ''Пользователь'' выберите корневое агентство.

На странице отобразится таблица '''Управление счетами''', в которой содержатся данные по счетам субагентств с возможностью редактирования данных в таблице.

Таблица содержит данные по состоянию баланса и доступного овердрафта каждого субагента агентства. <br>
В таблице можно редактировать следующие данные:
* ''Баланс'',
* ''Доступный овердрафт'',
* ''Доступ к оплате с баланса компании''.

Значения столбцов:
* {{Setting|ID}} — идентификатор компании субагента. По этому столбцу можно отсортировать строки таблицы.
* {{Setting|Название компании субагента}} — в столбце доступно поле для поиска записей указанного агентства.
* {{Setting|Баланс}} — баланс субагентства. Изменение значения ячейки заменяет текущую сумму баланса субагента на введенную сумму.
* {{Setting|Доступный овердрафт}} — лимит овердрафта агентства (максимально допустимый "минус" у баланса). Если для субагента установлено значение "0", доступный овердрафт не установлен для данной компании, оплата заказов по овердрафту запрещена.
* {{Setting|Доступ к оплате с баланса компании}} — включает доступ субагентства к оплате с баланса компании. Если опция выключена, оплата заказов с баланса для компании запрещена.
* {{Setting|Редактирование}} — ссылка на страницу '''Управление балансом компаний'''.

{| class="wikitable"
|-
|[[Файл:Управление счетами2.jpg|700px|]]
|-
|Управление счетами
|}

====Управление балансом компаний====
Данный способ редактирования данных о балансе компании удобен менеджеру, когда пополнение баланса компании осуществляется в присутствии представителя компании. На странице отображается информация только по выбранной компании, информация об остальных компаниях остаётся закрыта.

В информационном поле, подсвеченным желтым цветом, отображается текущее значение баланса выбранного субагента: ''Баланс компании: <СУММА В ВАЛЮТЕ>''

Чтобы добавить счет или изменить лимит овердрафта субагента:
# Перейдите на страницу управления балансом компании субагента одним из способов:
#* в '''таблице управления счетами''' всего агентства нажмите кнопку ''Управление'',
#* выберите компанию в поле '''Пользователь'''
# Введите сумму, на которую необходимо пополнить (или уменьшить) баланс компании субагента, и/или установите доступный овердрафт в заданной валюте.
# При необходимости добавьте примечание в поле ''Комментарий к изменению состояния счета''. Примечание отображается в ''Истории операций'' в качестве комментария к данной операции.
# Нажмите кнопку '''Сохранить'''. В текущем окне в информационном поле, подсвеченным желтым цветом, появится новое значение баланса компании: ''Баланс компании: <СУММА В ВАЛЮТЕ>''

=====Параметры управления балансом компании=====
* {{Setting|Пополнить баланс на}} - сумма и валюта, на которую будет увеличен или уменьшен баланс компании субагента:
** положительное значение суммы - баланс компании субагента будет увеличен на заданную сумму,
** отрицательное значение суммы - баланс компании субагента будет уменьшен на заданную сумму.
* {{Setting|Доступный овердрафт}} - сумма и валюта, максимально допустимый "минус" у баланса. Когда баланс субагента исчерпан, он дополнительно сможет оформлять заказы на общую сумму в пределах доступного овердрафта.
* {{Setting|Сальдо корпоративного клиента из СОФИ}} - подробнее см. ниже раздел данной статьи [[Депозит#Интеграция сальдо клиента из СОФИ|Интеграция сальдо клиента из СОФИ]]
* {{Setting|Сумма распределенных счетов может превышать сумму баланса субагентства}} - позволяет установить для пользователя субагенства баланс, превышающий реальный баланс компании субагенства. В данном случае пользователь сможет оплатить перелет, только если на счету субагенства хватает средств на оплату данного перелета. Иначе пользователю будет выведено сообщение с просьбой обратиться в агентство. Настройка актуальна только при подключенном модуле [[Перераспределение средств]].
* {{Setting|Комментарий к изменению состояния счета}} - текстовый комментарий в произвольной форме, который станет виден субагенту в личном кабинете в разделе ''История операций''.
* {{Setting|Разрешить указание данных платежного поручения}} - опция включает возможность оплаты Аэроэкспресса(Sirena) по платежному поручению. На этапе оплаты с баланса компании агент или сотрудник агентства указывает дополнительные параметры, а именно: номер платежного поручения и наименование организации. Эти данные при оплате Аэроэкспресса направляются в GDS Sirena. Также эти данные отправляются в GDS Sirena при выписке билета.
Возможные значения опции:
# Нет - опция выключена;
# Да - дополнительные поля не являются обязательными, поэтому при отсутствии данных в GDS Sirena эта информация не передаётся (если в настройках задан суффикс - то передастся он).
# Обязательно - дополнительные поля обязательны к заполнению. {{Attention|При оплате с баланса компании заказов в других GDS (кроме Sirena) поля номера платежного поручения и наименование организации также будут обязательны к заполнению. Чтобы выписка билетов проходила успешно рекомендуется создать разные Платежные Шлюзы в зависимости от поставщика, настраивается в фильтрации ПШ.}}

* {{Setting|Суффикс для формы оплаты}} - двухбуквенный код передается в ГРС Sirena на этапе выписки заказа, при этом заказ должен быть оплачен с баланса компании. Суффиксы присваиваются корпоративным клиентам на стороне поставщика. Суффикс отображается в форме оплаты на МК поставщика. Данные платежного поручения будут отправлены поставщику, только если поле "Суффикс для формы оплаты" не заполнено.
{| class="wikitable"
|-
|[[Файл:Форма редактирования баланса компании2.jpg]]
|-
|Форма редактирования баланса компании
|}

== Автопополнение кредитного лимита ==
У каждого заказа, оплаченного с баланса компании, в таблице заказов личного кабинета в столбце '''Форма оплаты''' есть кнопка ''«Погасить кредит» / «Погашено»''. Менеджер и эксперт корневого агентства может вернуть на баланс компании сумму, равную стоимости конкретного заказа.
Чтобы зачислить на счет компании сумму, равную стоимости заказа, менеджер агентства должен выполнить следующие действия:
[[Файл:Таблица заказов ссылка на погашение кредита.jpg|thumb|480px|left|Таблица заказов - ссылка на погашение кредита]]
# Зайдите в '''Личный кабинет''' и откройте вкладку '''Заказы'''.
# Настройте в таблице вывод столбца ''Форма оплаты''.
# Найдите заказ, стоимость которого должна быть зачислена в счет оплаты кредита компании.
# Нажмите на ссылку '''Погасить кредит'''.
# Подтвердите операцию во всплывающем окне.
#* если сумма на балансе компании отрицательная, сумма будет зачислена в счет погашения кредита,
#* если сумма на балансе компании положительная, сумма будет зачислена на счет субагента.
# После успешного выполнения операции текст кнопки в столбце ''Форма оплаты'' меняется на ''Погашено'' и кнопка становится неактивной.

==Уведомление субагентов об изменении баланса компании и доступного овердрафта==

Каждый раз при пополнении, изменении баланса компании или доступного овердрафта субагента через разделы управления счетами, а также при импорте данных о балансе компании на электронный адрес субагента отправляется уведомление.

Уведомления отправляются на адрес, указанный в настройке '''Профили компании → Адрес электронной почты'''.<br>
Текст сообщений можно изменить в разделе [[Локализация|Языковые ресурсы]] через редактирование переменной.

===Уведомление об остатке на счете и по овердрафту===

Чтобы информировать клиента об остатке на счете и по овердрафту, достаточно включить две опции на форме редактирования баланса компании и доступного овердрафта:
*''Отправлять уведомление субагенту при остатке по овердрафту (%)'' — укажите процент от максимального овердрафта, по достижению которого на электронный адрес субагента отправляется нотификация, содержащая текущее значение баланса компании и доступного овердрафта.
*''Отправлять уведомление субагенту когда сумма на балансе меньше или равна'' — укажите значение баланса компании, по достижению которого на электронный адрес субагента будет направлено уведомление, содержащее текущее значение баланса компании и доступного овердрафта.
Параметры поддерживают только положительные числа, дробная часть отделяется точкой.

Текст сообщений можно изменить в разделе [[Языковые ресурсы]] через редактирование переменной.

== Возврат средств ==

При возврате ж/д билетов, оплаченных с баланса компании, субагент может вручную вернуть средства обратно на счет, при этом возвращается сумма, назначенная поставщиком, за вычетом сборов агентства за возврат.

===Автоматический возврат средств при аннуляции заказа===

Чтобы включить автоматический возврат средств у заказов имеющие статус ''оплачен, билеты еще не выписаны'', необходимо включить опцию '''Автоматически вернуть деньги после отмены заказа (только баланс компаний и МПС)''' для данного способа оплаты в разделе '''Финансы и платежи → Платежные методы → Управление шлюзами'''. <br>
Опция активирует автоматический возврат средств при аннуляции заказов, оплаченных через МПС (см. [[Сирена Трэвел#МПС (EgoPay)|МПС (EgoPay)]]) или с баланса компаний. <br>
{{Attention|Аннуляция должна быть запущена на стороне Nemo, из служебной информации, иначе автоматический возврат не произойдет, например, в случае аннуляции через терминал.}} <br>

Доступ к отмене оплаченного заказа имеет менеджер и эксперт главного агентства, а также менеджер и эксперты субагентств. Только под этими пользователями можно провести автоматический возврат средств при аннуляции заказа. Сделать это можно с помощью нажатия кнопки "'''Отменить выписку и снять места'''" в "Служебной информации". Остальным пользователям система автоматически предложит заполнить заявку на аннуляцию заказа, которую обработает менеджер или эксперт корневого агентства.

== Логирование данных ==
Чтобы найти детализированную информацию в виде логов по всем заказам, оплаченных с баланса компаний, в разделе '''Просмотр логов системы''' выставите фильтр '''''Платежный шлюз''''' на значение ''Баланс компании''. Подробную информацию см. в статье [[Логи системы]].

{| class="wikitable"
|-
|[[Файл:Поиск логов1.jpg|700px]]
|-
|Поиск логов
|}

== Интеграция сальдо клиента из СОФИ ==

В {{NameSystem}} можно обновлять значение баланса компании субагентов через СОФИ.

Этот способ полезен, если менеджеру не удобно для каждого клиента вручную корректировать баланс компании.

При корректировке баланса компании через СОФИ обновление происходит в двух местах:
* При оплате с баланса компании синхронизация пройдет автоматически, если это еще не было сделано вручную.
* Во вкладке ''Финансы'' в личном кабинете рядом с балансом компании и доступным овердрафтом находится строчка {{Setting|Последняя синхронизация}}, в которой указана дата. Если синхронизации не было, то вместо даты выводится «нет». Если с последней успешной синхронизации прошло менее 24 часов, то повторная синхронизация будет не доступна.

Менеджер агентства может обновить баланс компании любого субагентства, а менеджер субагентства — только своей компании.

Чтобы использовать интеграцию:
# У агентства должен быть подключен модуль {{Setting|Взаимодействие с СОФИ}}.
# Включите опцию {{Setting|Сальдо корпоративного клиента из СОФИ}} в разделе '''Финансы и платежи → Баланс компаний → Управление счетами'''.

Настройки, описанные ниже будут не доступны, если эта настройка не включена.

{{Attention|Для подключения опции необходимо обратиться к сотрудникам {{NameSystem}}.}}

Для успешной синхронизации у '''субагентства''' должны быть настроены:
* {{Setting|Код субагента в СОФИ}} в разделе '''Управление сайтом → Домены и протоколы'''.
* В разделе '''Для техподдержки → Устаревшие настройки → Реквизиты подключения''':
**Логин, пароль для доступа к сервису,
**WSDL адрес для запросов.

[[Файл:ЛК_Финансы_Депозит_СОФИ.jpg|750px|Для обновление депозита в личном кабинете необходимо использовать ссылку «Синхронизировать из СОФИ».]]

== См. также ==
* [[Перераспределение средств]]
* [[Импорт данных о балансе]]
* [[Лог]]
* [[Личный кабинет]]
* [[Пользователь#Группы в Nemo|Группы в {{NameSystem}}]]
* [[Валюта]]
* [[Интеграция сервиса приёма платежей с помощью Payment Gateway API|Универсальный протокол Payment Gateway API]]

Платежные методы в Nemo.travel

2020-05-26T10:19:16Z

Мария Горшенева: /* Универсальный протокол для подключения платежных шлюзов */

[[Категория:Приём оплаты]]
[[Категория:Модули]]
[[Категория:Встроенные модули]]
==Способы оплаты в {{NameSystem}}==

Способы оплаты можно разделить на следующие группы:
* '''Платежные шлюзы онлайн''' — способы оплаты, при которых {{NameSystem}} взаимодействует в внешним платежным шлюзом и получает статусы оплаты заказов автоматически онлайн методом (подробнее см. [[Платежные шлюзы]]):
** ''Платежные шлюзы оплаты картой''.
** ''Платежные шлюзы оплаты кэшем''.<br> Подробнее о способах оплаты онлайн см. [[Платежные шлюзы]]).
* '''Способы оплаты с ручной фиксацией статуса''' — способы оплаты, при которых {{NameSystem}} не взаимодействует с внешними платежными шлюзами, и смена статуса оплаты производится вручную сотрудниками агентства:
** ''[[Оплата в офисе]]'',
** ''Оплата по счету ([[квитанция]]/[[счет|инвойс]])'',
* Оплата средствами с баланса компании или доступного овердрафта, заведённого в системе {{NameSystem}}:
** ''Оплата через [[баланс компаний]]''.

==Процесс оплаты в {{NameSystem}}==
Непосредственный процесс приёма оплаты всегда происходит вне {{NameSystem}}. Система лишь фиксирует конечный статус транзакции, получаемый извне. Присвоить статус платежной транзакции можно двумя способами:
[[Файл:Удалить_запись_об_оплате.png|705px|thumb|Окно «Платежные транзакции»]]
* ''Автоматически'' — автоматическая смена статуса транзакции происходит при взаимодействии с внешними платежными шлюзами, когда платежный шлюз присылает статус оплаты по транзакции или иной статус.
* ''Вручную'' — статус оплаты может быть зафиксирован вручную без взаимодействия с внешними платежными шлюзами с помощью кнопок:
** ''Зафиксировать оплату'' — присваивает признак оплаты заказу в {{NameSystem}}.
** ''Удалить запись об оплате'' — удаляет в {{NameSystem}} признак оплаты без фактического возврата средств. {{Attention|Операция не предполагает взаимодействия с платежными шлюзами, отмены оплаты не происходит}}.

===Платежные транзакции===

'''Платежная транзакция в {{NameSystem}}''' — это объект, управляющий и хранящий состояние по одному платежу одного заказа.

Термин «транзакция» подразумевает:
* максимальную (но не полную) целостность одной платежной операции в {{NameSystem}};
* абсолютную несвязанность платежей между собой;
* защиту от конфликтов (запрещен параллельный доступ к объекту-транзакции различным скриптам).

При переходе к оплате по любому платежному методу '''создаётся платежная транзакция''' по данной операции. Транзакции присваивается свой ''индивидуальный идентификатор'' (номер так же называется биллинг). В момент перехода на платежный шлюз в транзакции фиксируется сумма к оплате в определенной валюте (сумма, которую пользователь должен оплатить на удаленном шлюзе). Эта сумма ''не изменяется'' до завершения платежа, даже если сумма заказа в {{NameSystem}} меняется, независимо от причины изменения (изменилась стоимость в ГРС или изменение стоимости вручную, например, путём добавления новых услуг).

После успешной оплаты на удаленном шлюзе транзакция помечается как преавторизованная или успешно оплаченная. Оплаченная сумма по заказу равна сумме к оплате всех транзакций в статусе преавторизовано или оплачено.
* Если сумма к оплате ''меньше'' цены заказа, то у заказа проставляется статус '''Частично оплачено'''. Этот заказ не подлежит автоматической выписке, но его может выписать сотрудник агентства принудительно.
* Если сумма к оплате ''больше либо равна'' цене заказа, то у заказа проставляется статус '''Оплачено''' — запускается автовыписка (если она включена настройками).

В процессе выписки, если не возникнет сбоя со стороны удаленного шлюза, оплаченные платежи, требующие подтверждения (транзакции в статусе «Преавторизовано»), будут подтверждены.<br>
Если заказ ''частично оплачен'', то его можно доплатить, нажав кнопку '''Оплатить''' повторно. Сумма в транзакции будет выставлена как необходимая сумма для признания заказа оплаченным.

==== Процесс актуализации заказа ====
# В системе {{NameSystem}} реализована проверка на увеличение стоимости непосредственно в момент перехода на оплату. При увеличении стоимости пользователю предлагается выбор: оплатить по большей стоимости или вернуться к заказу.
# В случае сбоя работы не со стороны системы {{NameSystem}} запускается универсальный скрипт по проверке актуальности платежной транзакции (доступно только для ПШ: Сбербанка, Uniteller, Chronopay, Sirena2, ECPayment). Скрипт запускается для транзакций:
## Созданных за последние 3 часа и в статусе new или ready.
## Созданных за последние 24 часа с заблокированными средствами.
# Обновления запускаются по графику:
<table style="margin-left:23px;" class="wikitable">
<tr>
<td>Номер обновления</td><td>1</td><td>2</td><td>3</td><td>4</td><td>5</td><td>6</td><td>7</td><td>8</td><td>9</td><td>далее</td>
</tr>
<tr>
<td>Время</td><td>через 5 мин.</td><td>через 10 мин.</td><td>через 15 мин.</td><td>через 25 мин.</td><td>через 40 мин.</td><td>через 1 ч.</td><td>через 1 ч. 30 мин.</td><td>через 2 ч.</td><td>через 3 ч.</td><td>раз в час до 24 часов</td>
</tr>
</table>

[[Файл:Ссылка_на_Платёжные_транзакции.png|205px|thumb|Ссылка на Платежные транзакции.png]]

====Информация о платежных транзакциях====

Чтобы открыть информацию о платежных транзакциях, откройте '''служебную информацию''' на странице заказа (доступно только менеджерам и экспертам агентства) и нажмите кнопку '''Платежные транзакции''', расположенную внизу блока «Информация об оплате». Также данная ссылка доступна в личном кабинете в столбце '''Действия'''.

В системе логирования к записям, связанным с платежными транзакциями, есть столбец '''Биллинг'''. В поле этого столбца содержится номер последней транзакции в логе.

== Настройка способов оплаты в {{NameSystem}} ==

Завести и настроить способы оплаты можно в разделе '''Финансы и платежи'''.

===Управление доступом пользователей к платежным методам===
В разделе '''Финансы и платежи → Платежные методы → Доступ с способам оплаты''' агент может настроить доступность способов оплаты для пользователей/групп/компаний:<br>
* Выберите объект применения настроек в поле '''Пользователь'''.
* Включите способы оплаты, разрешённые пользователю, и выключите запрещённые.
{{Attention|Параметр ''Включить новую версию'' должен быть всегда <u>включен</u>. Эта опция задействует усовершенствованный модуль приема оплаты ''Платёжки 2.0''}}

===Заведение и управление платежными методами===
На странице '''Управление шлюзами''' настраиваются описания и параметры платежных шлюзов, имеющихся в системе.


На странице '''Управление шлюзами''' отображается таблица платежных методов, которая содержит все заведённые платёжные методы выбранного объекта (в поле ''Пользователь''), а так же:
* краткую информацию о каждом заведённом платёжном методе,
* ссылки на редактирование параметров платежного метода [[Файл:Ссылка на Редактирование параметров.png]],
* ссылки на настройку фильтрации платежного метода,
* ссылки на настройку реквизитов платежного метода,
* кнопки удаления платёжного метода [[Файл:Кнопка удаления.png]].

{| class="wikitable"
|-
|[[Файл:Таблица_платёжных_методов.png|1100px|Таблица платёжных методов в {{NameSystem}}]]
|-
|Таблица платежных методов в {{NameSystem}}
|}

====Создание платежного метода====
Чтобы создать новый платежный метод:
# Зайдите в раздел '''Финансы и платежи → Платежные методы → Управление шлюзами'''.
# Нажмите на кнопку '''Создать новую запись'''.
# Задайте параметры платёжного шлюза и нажмите на кнопку '''Сохранить'''.

Платежный метод появится в таблице платежных методов на странице '''Управление шлюзами'''.

====Параметры настройки платежных методов====

* {{Setting|Имя платежного шлюза}} — имя платежного шлюза, отображаемое на странице выбора способов оплаты.
* {{Setting|Информация об оплате через данный шлюз}} — дополнительная информация, отображаемая на странице выбора способов оплаты и после выбора конкретного способа оплаты.
* {{Setting|Сценарий платежного шлюза}} — настройка модуля «Платежки 2.0», позволяющая описывать сценарий действий, который произойдёт в процессе оплаты. Настройка доступна для всех платежных шлюзов на форме бронирования 2.0. Для редактирования текста сценария используется WYSIWYG. Если текст отсутствует, то на его месте будет выводится текст настройки «Информация об оплате через данный шлюз».
[[Файл:Отображение_сценария_на_вебе.png|300px|thumb|right|Отображение сценария после выбора оплаты]]
* {{Setting|Результат оплаты}} - данная настройка позволяет задавать текст, который будет выводиться в верхней части страницы заказа при возврате пользователя со страницы оплаты.
* {{Setting|Текст кнопки}} — текст кнопки выбора текущего способа оплаты.
* {{Setting|Ссылка на логотип шлюза (доступно не на всех темах)}} — добавляет изображение, указанное по ссылке, напротив названия платежного шлюза. 
* {{Setting|Наценка}} — размер наценки за оплату, определённый договором агентства с ПШ. Наценка - сбор платёжного шлюза за оплату, его размер устанавливается на стороне платёжного шлюза.
* {{Setting|Тип правила}} — задаёт тип расчета наценки:
** '''''Процент''''' — процент рассчитывается от общей суммы к оплате.
** '''''Значение''''' — сумма заданной валюты (задайте валюту в параметре '''Валюта наценки'''), прибавляется к общей сумме к оплате.
* {{Setting|Наценка не менее, чем}} — минимальное ограничение наценки (согласно договору агентства с ПШ).
* {{Setting|Наценка не более, чем}} — максимальное ограничение наценки (согласно договору агентства с ПШ).
* {{Setting|Тип правила для пределов}} — процент/значение, указывает на то, как воспринимать ограничения наценки, проценты или абсолютные величины.
* {{Setting|Валюта наценки}} — задает валюту расчета наценки, если наценка или ее ограничения указаны в абсолютных величинах.
* {{Setting|Способ оплаты отображать не менее чем за X часов до начала услуги}} — указывается минимальное целое количество часов до времени начала оказания услуги, при котором способ оплаты будет доступен к выбору.
* {{Setting|Способ оплаты отображать не менее чем за X часов до наступления таймлимита}} — указывается минимальное целое количество часов до наступления аннуляция, при котором способ оплаты будет доступен к выбору.
* {{Setting|Порядковый номер на странице выбора оплаты}} — позволяет задать порядковый номер, под которым платежный сервис будет отображаться на странице оплаты.
* {{Setting|Источник для фильтрации шлюза}} — в совокупности с настройкой «При совпадении источника» позволяет дополнительно переопределять поведение платежного шлюза в {{NameSystem}} в зависимости от источника перехода модуля метрики. Необходимо указать номер источника из таблицы источников модуля метрики. Чтобы указать несколько источников, необходимо перечислить их через запятую без пробелов, например, «23,48,56».
* {{Setting|При совпадении источника}} — определяет дополнительное поведение:
** {{Setting|ничего не делать}},
** {{Setting|не показывать в списке способов оплат}} — данный платежный шлюз будет недоступен на странице выбора способов оплаты,
** {{Setting|не применять сбор}} — наценка платежного шлюза будет равна 0.
* {{Setting|Текст, передаваемый в ремарке в ГДС (Invoice)}} — передача формы оплаты в GDS ({{NameProject2}}), происходит на этапе выписки посредством ремарок.
* {{Setting|Возможность инициализации платежа до бронирования}} — данная настройка предоставляет возможность отображать iframe банковской карты до бронирования.
* {{Setting|Запрет автоматических возвратов при изменении стоимости}} — настройка, регулирующая автоматический возврат средств клиенту. Если к моменту получения статуса успешной оплаты увеличилась стоимость заказа, автоматический возврат средств не происходит.
* {{Setting|Добавление в идентификаторы новых платежей номера заказа из Немо}} — настройка влияет на формирование номера транзакции при инициализации платежка, применяется для новых платежей. Если настройка включена то ID платежа будет ID заказа + «_» + ID транзакции. Работает для платежных шлюзов PayOnline, Sirena2, Platron, Sberbank / roseurobank, WayForPay(PayU). Для ПШ Uniteller настройка всегда активна.

=== Фильтрация платежных методов===
После создания записи о платежном методе в {{NameSystem}} можно настроить фильтрацию платежных методов.

Фильтрация платежных шлюзов используется, чтобы автоматически регулировать доступность различных платежных методов для заказов по заданным параметрам. Используя фильтрацию, можно ограничить доступность различных платежных методов для разных компонентов (авиабилеты, ж/д, отели), поставщиков, сумм заказов и т.д.

Условия доступности платежного шлюза настраивается индивидуального для каждой записи платежного шлюза с помощью параметров фильтрации. <br>Чтобы платежный шлюз был доступен для оплаты заказа, заказ должен подходить под все условия фильтрации платежного метода:
* если параметры заказа ''соответствует всем условиям'' фильтрации платежного метода, то платежный метод '''доступен''' для выбора в качестве способа оплаты,
* если параметры заказа ''не подходят хотя бы для одного условия'' фильтрации платежного метода, то платежный метод '''недоступен''' для выбора в качестве способа оплаты.
<u>''Все параметры фильтрации являются необязательными для заполнения.''</u>

Для задания условий фильтрации платежного метода:
# Откройте раздел '''Финансы и платежи → Платежные методы → Управление шлюзами'''.
# Для нужного платежного метода в столбце ''Действия'' нажмите на ссылку '''Фильтрация'''.
# Задайте условия фильтрации платежного шлюза и нажмите на кнопку '''Сохранить'''.

====Параметры фильтрации платежных методов====
* {{Setting|Платежный шлюз включен}} — опция включает/выключает платежный метод.
* {{Setting|Поставщик}} — фильтрация по компонентам и выбранным поставщикам. Здесь же флажком ''Обмен билетов'' можно включить доступность выбора этого платежного метода при обмене билетов.
* {{Setting|Реквизиты}} — с помощью данной настройки можно указать конкретные реквизиты поставщика.
* {{Setting|Источник}} — с помощью данной настройки можно включить доступ к оплате с помощью платежного метода только в тех случаях, когда переход был осуществлен с заданного в поле источника (из модуля метрики).
* {{Setting|Все источники, кроме}} — с помощью данной настройки можно запретить доступ к оплате с помощью платежного метода, если переход был осуществлен через источник, указанный в этом поле. <br>{{Attention|Значение не должно пересекаться со значениями из поля '''Источник'''!}}
* {{Setting|Авиакомпании}} — используется, чтобы установить фильтр по авиакомпаниям,
* {{Setting|Отображать, если сумма заказа менее чем}} — максимальная сумма заказа при которой способ оплаты доступен к выбору.
* {{Setting|Отображать, если сумма заказа более чем}} — минимальная сумма заказа при которой способ оплаты доступен к выбору.
* {{Setting|Способ оплаты отображать не менее чем за X часов до начала услуги}} — укажите минимальное целое количество часов до времени начала оказания услуги, при котором способ оплаты будет доступен к выбору.
* {{Setting|Способ оплаты отображать не менее чем за X часов до наступления таймлимита}} — укажите минимальное целое количество часов до наступления аннуляция, при котором способ оплаты будет доступен к выбору.
* {{Setting|Допустимая валюта расчетов (любая из списка, если не выбраны значения)}} — с помощью данной настройки можно задается список валют, с которыми будет работать выбранный платежный шлюз.
* {{Setting|Пользователи, имеющие доступ к способу оплаты}} — в поле вводятся либо названия компаний, либо логины/имена пользователей, для которых будет выводиться данный способ оплаты. В случае, если в поле не указана ни одна компания/пользователь, способ оплаты будет выводиться для всех.
* {{Setting|Пользователи, не имеющие доступ к способу оплаты}} — в поле вводятся либо названия компаний, либо логины/имена пользователей, для которых '''не''' будет выводиться данный способ оплаты. В случае, если в поле не указана ни одна компания/пользователь, способ оплаты будет выводиться для всех.

{{Attention|Если в настройках фильтрации платежный метод включен, а на странице ''Доступ к способам оплаты'' платежный метод выключен, то способ оплаты <u>будет недоступен для выбора</u>.}}

===Другие настройки платежных методов===

В разделе '''Финансы и платежи → Платежные методы → Устаревшая версия → Основные настройки''' находятся некоторые другие настройки платежных методов.

<table border="1" cellspacing="0" cellpadding="3" class="wikitable">
<tr>
<th>Опция</th>
<th>Возможные значения</th>
<th>Описание</th>
</tr>
<tr>
<td>Можно сменить способ оплаты</td>
<td>Включен / Выключен</td>
<td>Если настройка выставлена в значение «Включен», то после того как заказ оплачен, можно сменить способ оплаты.</td>
</tr>
<tr>
<td>Быстрое редактирование счетов</td>
<td>Нет / Да</td>
<td>Если включена эта настройка, то пользователь, для которого заведен счет имеет доступ к таблице редактирования счетов. Если не включена — редактировать могут только определенные пользователи (менеджер и пользователи группы). {{Attention|Рекомендация — не включать данную настройку.}}</td>
</tr>
<tr>
<td>Проставлять статус только при наличии подтверждения из внешней системы</td>
<td>Нет / Да</td>
<td>При установленном значении опции «Да» заказ будет считаться оплаченным только в случае оплаты в системе {{NameSystem}} и подтверждении транзакции от внешней системы.</td>
</tr>
<tr>
<td>Заказы из Сирены оплачивать картами только через Сирену (если шлюз доступен)</td>
<td>Нет / Да</td>
<td>При включенной настройке алгоритм работы следующий:<br/>Если доступно несколько систем оплаты с помощью банковских карт, в том числе платежный шлюз Сирена, то<br/>1) если заказ сделан в '''[[Сирена Трэвел|ГРС Сирена]]''', то все системы оплаты банковскими картами, кроме ПШ Сирена, становятся недоступными;<br/>2) если заказ сделан не в '''ГРС Сирена''', то ПШ Сирена становится недоступным.</td>
</tr>
<tr>
<td>Толерантность, значение</td>
<td>Число</td>
<td>Значение суммы толерантности.</td>
</tr>
<tr>
<td>Толерантность, валюта</td>
<td>Выпадающий список</td>
<td>Название валюты суммы толерантности.</td>
</tr>
</table>

'''Сумма толерантности''' — это сумма, которую агент готов «простить» клиенту в случае увеличения стоимости заказа. Есть возможность списывать и добавлять в заказ незначительное увеличение стоимости как скидку для повышения конверсии. Если увеличение стоимости не превышает значение данной настройки и значение суммы сбора агентства и комиссии авиакомпании, то разница в стоимости записывается как скидка в заказ. Итоговая стоимость при этом не меняется и оплата не прерывается. Можно настроить только на агентство.

== Иконки платёжных шлюзов ==

Для того, чтобы выставить иконку для платёжного шлюза, необходимо воспользоваться стилизацией.
Необходимо зайти в «Управление сайтом» → «Настройка внешнего вида» и добавить необходимый код.
Пример:
.new-flights-passInfo__pay__method__logo_XXX {
background-image: url('path/to/image.svg');
}
Где «XXX» — название платежного шлюза, которое можно посмотреть в инспекторе браузера.

==Перевод имен платежных шлюзов==
Для перевода имени платежного шлюза необходимо в разделе '''Финансы и платежи → Платежные методы → Управление шлюзами''' в правом верхнем углу страницы выбрать нужный язык, затем выполнить редактирование записи платежного шлюза, указав имя на выбранном языке.

{| class="wikitable"
|-
|[[Файл:Перевод названий платежных шлюзов.png|1000px]]
|-
|Перевод имен платежных шлюзов
|}

==Увеличение стоимости заказа==

При увеличении стоимости оплаченного, но не выписанного заказа система активирует возможность оплаты разницы суммы, полученной после модификаций в заказе.
Оплатить заказ можно только в том случае, если доступно действие выписки, но заказ еще не выписан, либо если после выписки выбраны дополнительные услуги, которые необходимо оплатить.

== Подключение новых платежных решений==

Если вам необходим платёжный метод, который ещё не интегрирован в систему {{NameSystem}}, вы можете воспользоваться сервисом Payment Gateway API, который позволит быстро подключить любое платежное решение.<br>
Для более подробной информации см. статью [[Интеграция сервиса приёма платежей с помощью Payment Gateway API]]

==См. также==
*[[Платежные шлюзы]]
*[[Счет]]
*[[Квитанция]]
*[[Оплата в офисе]]
*[[Баланс компаний]]
*[[Интеграция сервиса приёма платежей с помощью Payment Gateway API|Универсальный протокол Payment Gateway API]]

Платежные шлюзы

2020-05-26T10:18:54Z

Мария Горшенева: /* Универсальный протокол для подключения платежных шлюзов */

[[Category:Термины]]
[[Category:Руководство]]
[[Category:Настройки]]
[[Category:Приём оплаты]]

'''Платежный шлюз''' (Payment Gateway) — сервис для быстрой и безопасной обработки электронных транзакций, онлайн-аналог платежного терминала, используемого в торговых точках. Авторизует платежи и обеспечивает контакт между продавцом, покупателем и банком.

Платежные шлюзы представляют собой программные приложения, созданные специально для электронной коммерции. Однако благодаря заложенным в них инструментам быстрой и точной активизации платежей они нашли применение и в традиционном бизнесе. Безопасность обмена информацией через платежный шлюз достигается благодаря шифрованию персональных данных (таких как номер кредитной карты, секретный код и т.д.) с помощью SSL (Secure Socket Layer). Многие хостинговые компании включают платежные шлюзы в свои стандартные клиентские пакеты.

[[Изображение:Nemo-goto.png|center|link=http://nemo.travel]]

Чтобы купить товар через платежный шлюз, клиент должен иметь учетную запись в соответствующей системе. Но однажды пройдя регистрацию, далее при покупке он выбирает способ оплаты через платежный шлюз и вводит [[Пароль]] — данные карты передаются автоматически. Некоторые онлайн-магазины предлагают своим клиентам два альтернативных способа оплаты товара: через шлюз или банковской картой. Если у продавца нет инструментов для самостоятельного процессинга пластиковых карт, он использует только платежный шлюз (так, например, совершаются практически все транзакции на аукционе eBay). Для покупателя пользование платежным шлюзом бесплатно, продавец платит проценты от совершенных сделок.

== Как работает платежный шлюз ==

Для использования платежных шлюзов необходимо подключение к сети интернет.

* Покупатель совершает транзакцию через [[веб-сайт]] или физически.
* Данные пересылаются в платежный шлюз, который принимает информацию и далее передает детали транзакции в банк, выдавший карту, с помощью которой была оплачена покупка.
* Банк отправляет запрос в платежную систему (VISA, Mastercard и т.д.). Происходит оценка соответствия условий сделки и кредитной ситуации клиента.
* Банк-эмитент отправляет код авторизации, который «дает добро» платежной системе на совершение сделки.
* Платежная система отправляет код авторизации в платежный шлюз, оттуда он поступает продавцу.
* Если сделка одобрена, продажа проходит и деньги снимаются со счета клиента.

Весь процесс занимает несколько секунд. Скорость зависит от качества интернет-соединения. В реальности продавец получает деньги клиента примерно через 3 дня.

== Платежные шлюзы в {{NameSystem}} ==

В системе бронирования {{NameSystem}} имеются шлюзы к самым популярным поставщикам платежных решений:

* Процессинговый центр '''Uniteller''' осуществляет интернет-эквайринг на базе платежного решения собственной разработки, что позволяет реализовать все востребованные сервисы. Быстрая и простая кастомизация платежной страницы максимально упрощает процесс оплаты. Безопасность платежей подтверждена сертификатом безопасности PCI DSS 2.0. Круглосуточный Fraud-мониторинг и поддержка протокола 3D Secure исключает незаконное использование банковских карт. Значительным преимуществом для систем бронирования авиабилетов является поддержка «длинной записи» и интеграция с GDS, позволяющие значительно снизить комиссию за эквайринг.

* '''ChronoPay''' – международный оператор интернет-платежей по банковским картам. Система обработки платежей компании ChronoPay позволяет проводить авторизацию и обработку онлайн-платежей в соответствии с мировыми стандартами безопасности и надежности в режиме реального времени. Компания предоставляет клиентам возможность использования широкого спектра платежных инструментов. Помимо поддержки распространенных типов банковских карт, ChronoPay тесно сотрудничает с региональными системами интернет-платежей в России и во всем мире.

* За 6 лет работы в области электронной коммерции, компания '''«Универсальная Финансовая Система»''' проделала значительную работу по созданию и внедрению комплексных платежных решений, настройке, интеграции различных систем — это интеграция с процессинговыми системами различных спецификаций, создание систем информационной безопасности, шлюз с биллинговыми системами мобильных операторов, подключение к системе бронирования железнодорожных билетов «Экспресс-3», отработка системы обмена данными с едиными расчетными центрами службы ЖКХ и др. За время работы был приобретен уникальный опыт в области платежных систем, сложилась сильная команда разработчиков, были созданы эффективные решения, основанные на собственных ноу-хау разработках, особенно в области комплексной безопасности и непрерывности работы систем.

* '''QIWI''' (КИВИ) — это удобный сервис для оплаты всех повседневных услуг: от мобильной связи и ЖКУ до банковских кредитов. Через QIWI (КИВИ) можно приобретать ж/д билеты, оплачивать покупки в интернет-магазинах и многое другое. Платежные терминалы QIWI (КИВИ) есть везде.

* '''Webmoney''' — одна из самых популярных систем онлайн-расчетов в России, Украине и других странах СНГ. Основана в 1998 г. Платежи в системе моментальны и безотзывны. Последнее означает полную защищенность билетного агентства от возвратов, «чарджбеков», злоупотреблений со стороны плательщика. Технология WebMoney создана на предоставлении всем участникам Системы единых интерфейсов по непосредственному управлению своими имущественными правами на ценности, находящиеся на хранении в специализированных компаниях — Гарантах.

* '''CoPAYco''' — надежный и удобный интернет-сервис, который позволяет использовать деньги на пластиковых картах и банковских счетах, не выходя из дома.Можно оплачивать товары и услуги через интернет – в любое удобное время.

* '''ПриватБанк''' — крупнейший банк Украины по количеству клиентов, активам, кредитному портфелю. ПриватБанк, в отличии от большинства крупных банков Украины, находится не в Киеве, а в Днепропетровске. Кроме того, ПриватБанк является крупнейшим коммерческим банком Украины с отечественным капиталом. ПриватБанк стал первым банком на Украине, который предложил своим клиентам простой способ использования возможностей интернет-банкинга.

* '''Универсальный платежный шлюз Nemo''' — встроенный в систему шлюз позволить обеспечить связь с любым платежным сервисом, например разработанным специально для вашей компании.

* '''Платрон (Platron)''' – универсальная система электронных платежей для сайта, связывающая онлайн-платежи между интернет-магазинами, покупателями и платежными системами.

* '''PayPal''' – оператор электронных денежных средств. Позволяет клиентам оплачивать счета и покупки, отправлять и принимать денежные переводы. В случае оплаты покупок важнейшей особенностью PayPal является предоставление гарантий безопасности как покупателю, так и продавцу.

* '''Belassist''' – мультибанковская система приема платежей по банковским картам через интернет, позволяющая в реальном времени производить авторизацию и обработку электронных платежей. Компания организует прием банковских карт VISA, VISA Electron, MasterCard, Maestro, American Express на сайте интернет-магазина.

* '''Processing.kz''' — компания, обеспечивающая технологические процессы по оказанию услуг интернет-эквайринга для банков Казахстана, оплату платежными картами для интернет-магазинов и полноценную защиту карточных данных для покупателей. Принимает онлайн платежи по банковским картам самых популярных платежных систем Visa и MasterCard. Использует технологию 3-D Secure и передачу данных с использованием протокола TLS/SSL. Преимущества: простота подключения к процессинговому центру и индивидуальный подход к каждому клиенту.

* '''Kazkommertsbank''' — является одним из крупнейших банков в Казахстане и Центральной Азии. В системе {{NameSystem}} интегрирован через открытую систему E-commerce авторизации пластиковых карточек через интернет с уникальной системой обеспечения безопасности электронных платежей Visa 3D-Secure.

* '''Agroindbank''' — крупнейший коммерческий банк в Молдавии. Подробнее о подключении см. [[Agroindbank]].

* '''[[РосЕвроБанк]]'''

* '''[[Isbank]]'''

* '''[[Saferpay]]'''

* '''[[MilliKart]]'''

* '''[[Элсом]]'''

* '''[[PayOnline]]'''

* '''[[Paylate]]'''

* '''[[AzeriCard]]'''

* '''[[ECommPay]]'''

*'''[[Gateline]]'''

*'''[[Рапида]]'''

*'''[[Payture]]'''

* '''Acquiro'''

*'''[[PayU]]'''

*'''[[Сбербанк]]'''

*'''[[LiqPay (ПриватБанк)]]'''

*'''[[OneClickPay]]'''

*'''[[DemirBank]]'''

*'''[[Cybersource]]'''

*'''[[Halkbank]]'''

*'''[[PayMO]]'''

*'''[[MoneyWall]]'''

== Настройка способов оплаты в {{NameSystem}} ==
См. статью [[Платежные методы в Nemo.travel]].

== Подключение новых платежных шлюзов ==

Если вам необходим платёжный метод, который ещё не интегрирован в систему {{NameSystem}}, вы можете воспользоваться сервисом Payment Gateway API, который позволит быстро подключить любое платежное решение.<br>
Для более подробной информации см. статью [[Интеграция сервиса приёма платежей с помощью Payment Gateway API]]

== См. также ==
* [[Интеграция сервиса приёма платежей с помощью Payment Gateway API|Универсальный протокол Payment Gateway API]]
* [[Платежные методы в Nemo.travel]]
* [[Хронопей]]
* [[Приватбанк]]
* [[Uniteller]]
* [[Монета.ру]]
* [[ECommPay]]
* [[Рапида]]
* [[Platron]]
* [[OneClickPay]]
*[[Настройки фискализации]]

== Полезные ссылки ==
* [http://www.uniteller.com Uniteller]
* [http://www.chronopay.com Chronopay]
* [http://www.ufs-online.ru/ Универсальная Финансовая Система]
* [http://qiwi.ru QIWI]
* [http://www.ecommpay.com ECommPay]
* [http://www.webmoney.ru WebMoney]
* [http://www.copayco.com CoPayCo]
* [http://www.privatbank.ua ПриватБанк]
* [http://www.platron.ru Платрон]

Look2Book для B2B

2020-05-21T19:23:47Z

Мария Горшенева: /* Статистика поисков и заказов */

[[Категория:Модули]] [[Категория:Дополнительные модули]] [[Категория:Решения для B2B]]
 [[Категория:Модули]] [[Категория:Дополнительные модули‎]]
'''Look2book для B2B''' — модуль системы бронирования билетов онлайн {{NameSystemLink}} для ограничения максимального суточного количества поисков и выписанных броней для субагентов агентства.

== Описание ==
С помощью модуля '''Look2book для B2B''' [[Менеджер агентства|менеджер корневого агентства]] контролирует текущий уровень соотношения числа поисков к выписанным броням по своим B2B клиентам, включая и тех субагентов, которые подключены по XML API. С использованием модуля можно отслеживать статистику поисков и выписок своих компаний, ограничивать число [[Поиск (Авиабилеты)|поисков]] от имени субагентов в день, а также вести мониторинг заблокированных компаний. <br>
Контроль максимального суточного количества поисков и выписок субагентов агентства помогает не допустить превышение числа сканов в [[ГРС]].

==Включение модуля==

Чтобы подключить модуль '''Look2book для B2B''', обратитесь в [http://helpdesk.nemo.travel/ трекер технической поддержки {{NameSystem}}]. Модуль подключает администратор {{NameSystem}} в разделе '''Для техподдержки''' → '''Модули'''.

==Принцип работы==
[[Файл:Ограничение_b2b_поисков_-_блокировка.png|thumb|left|390px|Сообщению пользователю при заблокированном поиске]]
* Корневое агентство задаёт лимит на число поисков для субагента. Можно задать как одинаковые [[Настройка|параметры]] на все компании, так и указать индивидуальные для выбранных.
* Если компания достигает заданного ей лимита, то {{NameSystem}} (Сервер Авиа) запрещает поиски и выписки от имени компании (блокирует компанию) до следующих суток. В 00:00 блокировка снимается. При этом поиски завершаются ошибкой: ''Поиск недоступен. Достигнут лимит поисковых запросов, обратитесь к администратору агентства.''
* При получении ошибки об ограничении поисков/выписок на указанные адреса будет отправлена стандартная нотификация. Адреса для отправки уведомлений настраиваются в разделе '''Нотификации об ошибках ГДС'''.

Если необходимо снять блокировку субагента, корневое агентство может временно увеличить лимиты поисков для субагента.

Параметры модуля настраиваются в разделе '''Управление продажами → Авиабилеты → Модули → Look2book для B2B'''.<br>
Раздел состоит из следующих подразделов:
* Установка ограничений — доступен только для менеджера корневого агентства.
* Заблокированные компании — доступен только для менеджера корневого агентства.
* Статистика поисков и заказов — доступен только менеджеру корневого агентства и менеджерам субагентств.<br>

===Установка ограничений===
В разделе '''Установка ограничений''' настраивается лимит на число поисков и выписок для субагентств в день:
* для всех субагентов агентства: задайте ограничение на корневое агентство, тогда все субагентства агентства унаследуют установленные значения;
* для отдельных субагентов: задайте ограничение на выбранного субагента.
На пользователей самого корневого агентства ограничения не действуют.

Параметры настройки ограничений:
* '''Максимальное количество поисков в сутки''' — максимально допустимое число поисков субагентства.
* '''Максимальное количество поисков на одну выписанную бронь''' — максимальное число поисков субагентства в отношении к выписанным броням.

{| class="wikitable"
|-
|[[Файл:Ограничение_b2b_поисков_-_параметры.png|650px]]
|-
|Параметры настройки ограничений
|}

Ограничения накладываются на поиски/выписки субагентства в целом, независимо от конкретных реквизитов или поставщиков.

=== Заблокированные компании ===
В разделе '''Заблокированные компании''' отображаются данные о компаниях, для которых в данный момент установлена блокировка. <br>
Информация отображается в виде таблицы со столбцами:
* '''''Название компании''''',
* '''''Тип блокировки''''':
** ''Превышено ограничение на соотношение числа поисков к выписанным броням'',
** ''Превышено ограничение на число поисков'',
* '''''Выполнено''''',
* '''''Изменить ограничения'''''.
{| class="wikitable"
|-
|[[Файл:Ограничение_b2b_поисков_-_заблокированные_компании.png|750px]]
|-
|Таблица заблокированных компаний
|}

=== Статистика поисков и заказов ===
В разделе '''Статистика поисков и заказов''' можно получить информацию о количестве совершенных поисков, выписанных броней субагентов.

* Установите '''период''', за который {{NameSystem}} сформирует статистику поисков и заказов:
** ''Дата от''.
** ''Дата до''.
* Нажмите кнопку '''Получить информацию'''.

{| class="wikitable"
|-
|[[Файл:Ограничение_b2b_поисков_-_статистика.png|950px]]
|-
|Статистика поисков и заказов компаний
|}

==См. также==
*[[Нотификация]]
*[[Расширенный модуль субагентских продаж]]
*[[Отчет по пользователям]]
*[[Статистика]]
*[[Отчеты]]

Интеграция сервиса приёма платежей с помощью Payment Gateway API

2020-04-08T15:34:28Z

Мария Горшенева: /* Порядок подключения модуля Payment Gateway API */

Payment Gateway API представляет собой протокол для подключения платежных шлюзов. Сервис позволяет с минимальными затратами времени и ресурсов подключить любой существующий платежный шлюз, используя единую схему подключения. Преимущество метода в том, что работы по разработке интеграции заказчик выполняет на своей стороне, а значит, самостоятельно планирует сроки интеграции и независимо управляет ресурсом.

=Порядок подключения модуля Payment Gateway API=

Модуль Payment Gateway API является дополнительным. Чтобы подключиться к Nemo.travel по данному протоколу, обратитесь в коммерческий отдел по адресу connect@nemo.travel

Для подключения платёжного сервиса по представленному методу агентству необходимо:
# Обратиться в коммерческий отдел {{NameSystem}} по адресу connect@nemo.travel с заявкой на подключение продукта, подписать документы на эксплуатацию сервиса
# Создать тикет в проектном трекере {{NameSystem}} на подключение сервиса. Вам будет открыт доступ к сервису "UniversalNemoPay" в разделе "Доступ к способам оплаты" (доступно только администраторам системы {{NameSystem}} )
# Провести интеграцию с {{NameSystem}} по протоколу Payment Gateway API, используя техническую документацию по интеграции ([[Интеграция сервиса приёма платежей с помощью Payment Gateway API#Техническая документация по интеграции с сервисом Payment Gateway API|Техническая документация по интеграции с сервисом Payment Gateway API]])
# Выполнить настройку метода оплаты ([[Интеграция сервиса приёма платежей с помощью Payment Gateway API#Настройка платёжного шлюза в {{NameSystem}}|Настройка платёжного шлюза]]) и сообщить в тикете реквизиты для взаимодействия {{NameSystem}} и платёжного шлюза (комплект: URL, логин, пароль) для завершения настройки платёжного метода технической поддержкой {{NameSystem}}
# Протестировать подключение перед началом боевой эксплуатации
# Сообщить в тикете о готовности перехода к продуктовый режим. Предоставить контакты службы поддержки сервиса по приёму платежей и тестовые реквизиты для дальнейшей поддержки сервиса

==Особенности==
Сервис не поддерживает фискализацию платежей по ФЗ 54.

==Настройка платёжного шлюза в {{NameSystem}}==

# В разделе '''Финансы и платежи → Платежные методы → Доступ с способам оплаты''' откройте доступ к способу оплаты UniversalNemoPay для пользователей/групп/компаний (подробнее о настройке см. [[Платежные методы в Nemo.travel]])
# В разделе '''Финансы и платежи → Платежные методы → Управление шлюзами''' создайте метод оплаты "UniversalNemoPay" (подробнее о настройке см. [[Платежные методы в Nemo.travel]])
# Откройте раздел "Реквизиты" созданного платёжного метода и задайте настройки доступа к платёжному шлюзу (подробнее о настройке см. [[Платежные методы в Nemo.travel]]):
#* ''URL клиентского сервера для запросов'' - адрес запросов для доступа к Сервису, например http://test.com/test
#* ''API логин'' - реквизит доступа к платёжному шлюзу, выдаётся платёжным шлюзом
#* ''Пароль'' - реквизит доступа к платёжному шлюзу, выдаётся платёжным шлюзом
#* ''Валюта'' - валюта по договору с платёжным шлюзом
#* ''Использовать двухстадийную оплату'' - если параметр включен, будет использована схема запросов с преавторизацией. Если выключен - схема запросов без преавторизации.
#* ''Разрешить оплату только картами Visa Electron и MasterCard Maestro''
#* ''Добавить локатор в начало идентификатора платежа при передаче в платежный шлюз'' - в orderNumber будет добавлен префикс с локатором.
#* ''Отображать фрэйм со страницей оплаты на странице информации о заказе '' - для оплаты во фрейме на странице заказа без перехода на странцу платёжного шлюза
#* ''Высота фрэйма со страницей оплаты'' - задайте высоту фрейма

=Техническая документация по интеграции с сервисом Payment Gateway API=

'''Используемые в разделе термины:'''
*''Система Немо'' - система бронирования Nemo Travel,
*''Сервис'' - сервис по приему платежей.

==Описание запросов==

{| class="wikitable"
! Название запроса !! Описание !! Особенности
|-
| register.do || Запрос регистрации заказа (без преавторизации)|| -
|-
| registerPreAuth.do || Запрос регистрации заказа c преавторизацией || -
|-
| deposit.do || Запрoс завершения oплаты заказа || -
|-
| reverse.do || Запрос отмены оплаты заказа || -
|-
| refund.do || Запрос возврата средств оплаты заказа || -
|-
| getOrderStatusExtended.do || Расширенный запрос состояния заказа || -
|-
|}

* Запросы, использующиеся при двухстадийной оплате (с преавторизацией): registerPreAuth.do, deposit.do.
* Запросы, использующиеся при одностадийной оплате (без преавторизации): register.do.
* Запросы reverse.do, refund.do и getOrderStatusExtended.do могут быть использованы при любой схеме оплаты.
* При необходимости возврата средств система Немо посылает запрос обновления заказа в платежный шлюз. Если полученный статус заказа - orderStatus=1, то посылается запрос reverse.do, если orderStatus=2, то посылается refund.do.

==Порядок взаимодействия Системы Немо и Сервиса==

===Оплата с преавторизацией===
#При инициировании оплаты Система Немо отправляет Запрос регистрации заказа registerPreAuth.do.
#Система Немо перенаправляет пользователя на url, который Сервис указал в ответе на запрос регистрации для совершения операции эквайринга на стороне Сервиса.
#Периодически Система Немо отправляет запрос getOrderStatusExtended.do для получения состояния заказа до тех пор, пока Сервис не укажет в качестве orderStatus 1 или 6 при нулевом значении errorCode. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =1, процедура продолжается.
#Параллельно с завершением транзакции Сервис переадресует клиента обратно на страницу заказа (returnUrl в запросе registerPreAuth.do). В результате операции Система Немо дополнительно направляет запрос getOrderStatusExtended для получения актуального статуса оплаты. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =1, процедура продолжается.
#Система Немо выполняет оформление заказа.
##Если оформление прошло успешно, Система Немо инициирует запрос deposit.do для завершения операции эквайринга на стороне Сервиса;
##Если оформление прошло неуспешно, Система Немо инициирует запрос reverse.do;
#Процедура оплаты завершена.

===Оплата без преавторизации===
#При инициировании оплаты Система Немо отправляет Запрос регистрации заказа register.do.
#Система Немо перенаправляет пользователя на url, который Сервис указал в ответе на запрос регистрации для совершения операции эквайринга на стороне Сервиса.
#Периодически Система Немо отправляет запрос getOrderStatusExtended.do для получения состояния заказа до тех пор, пока Сервис не укажет в качестве orderStatus 2 или 6 при нулевом значении errorCode. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =2, процедура продолжается.
#Параллельно с завершением транзакции Сервис переадресует клиента обратно на страницу заказа (returnUrl в запросе register.do). В результате операции Система Немо дополнительно направляет запрос getOrderStatusExtended для получения актуального статуса оплаты.
#Если orderStatus=2 и errorCode=0, Система Немо выполняет оформление заказа.

===Возврат средств===
Для возврата средств Система Немо направляет getOrderStatusExtended.do.
*Если полученный статус заказа orderStatus=1, то Система Немо направляет запрос reverse.do,
*Если orderStatus=2, то Система Немо направляет запрос refund.do.

==Формат запросов/ответов==

Универсальный API для подключения платежных шлюзов реализован с помощью HTTP запросов/ответов методом POST.

* register.do
<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderNumber, amount, returnUrl, currency, description, language, jsonParams
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
| returnUrl || Адрес, на который требуется перенаправить пользователя в случае успешной оплаты. Значение должно представлять собой абсолютную ссылку. || Пример: "http://test.com/universal_nemo_pay__after_authorisation?billing_id=111111111".
|-
| currency || Валюта || Код валюты платежа ISO 4217.
|-
| description || Описание заказа в свободной форме || Пример: "Оплата заказа №586578 (1X96WD) с сайта http://test.com".
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
| jsonParams || Блок для передачи дополнительных параметров мерчанта. || Пример данных передаваемых Немо: {"onlyMaestro":"false","email":"test@mutelab.com","phone":"79270099000"}
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: orderId, formUrl, errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| formUrl || URL платежной формы, на который надо перенаправить браузер клиента. || -
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* registerPreAuth.do
<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderNumber, amount, returnUrl, currency, description, language, jsonParams
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
| returnUrl || Адрес, на который требуется перенаправить пользователя в случае успешной оплаты. Значение должно представлять собой абсолютную ссылку. || Пример: "http://test.com/universal_nemo_pay__after_authorisation?billing_id=111111111".
|-
| currency || Валюта || Код валюты платежа ISO 4217.
|-
| description || Описание заказа в свободной форме || Пример: "Оплата заказа №586578 (1X96WD) с сайта http://test.com".
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
| jsonParams || Блок для передачи дополнительных параметров мерчанта. || Пример данных передаваемых Немо: {"onlyMaestro":"false","email":"test@mutelab.com","phone":"79270099000"}
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: orderId, formUrl, errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| formUrl || URL платежной формы, на который надо перенаправить браузер клиента. || -
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* deposit.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId, amount.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* reverse.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* refund.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* getOrderStatusExtended.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId, language, orderNumber.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage, orderStatus и cardAuthInfo(expiration, cardholderName, approvalCode, pan).
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
| orderStatus || Состояние заказа в платежной системе. ||
* 0 - Заказ зарегистрирован, но не оплачен
* 1 - Предавторизованная сумма захолдирована (для двухстадийных платежей)
* 2 - Проведена полная авторизация суммы заказа
* 6 - Авторизация отклонена
|-
| cardAuthInfo || Тэг с атрибутами платежа. ||
* expiration - Срок истечения действия карты в формате YYYYMM.
* cardholderName - Имя держателя карты.
* approvalCode - Код авторизации платежа. Поле фиксированной длины (6 символов), может содержать цифры и латинские буквы.
* pan - Маскированный номер карты, которая использовалась для оплаты.
|-
|}
</div></div>

=См.также=
[[Платежный шлюз]]

Интеграция сервиса приёма платежей с помощью Payment Gateway API

2020-04-08T15:34:04Z

Мария Горшенева: /* Порядок подключения модуля Payment Gateway API */

Payment Gateway API представляет собой протокол для подключения платежных шлюзов. Сервис позволяет с минимальными затратами времени и ресурсов подключить любой существующий платежный шлюз, используя единую схему подключения. Преимущество метода в том, что работы по разработке интеграции заказчик выполняет на своей стороне, а значит, самостоятельно планирует сроки интеграции и независимо управляет ресурсом.

=Порядок подключения модуля Payment Gateway API=

Модуль Payment Gateway API является дополнительным. Чтобы подключиться к Nemo.travel по данному протоколу, обратитесь в коммерческий отдел по адресу connect@nemo.travel

Для подключения платёжного сервиса по представленному методу агентству необходимо:
# Обратиться в коммерческий отдел {{NameSystem}} по адресу connect@nemo.travel с заявкой на подключение продукта, подписать документы на эксплуатацию сервиса
# Создать тикет в проектном трекере {{NameSystem}} на подключение сервиса. Вам будет открыт доступ к сервису "UniversalNemoPay" в разделе "Доступ к способам оплаты" (доступно только администраторам системы {{NameSystem}} )
# Провести интеграцию с {{NameSystem}} по протоколу Payment Gateway API, используя техническую документацию по интеграции ([[Интеграция сервиса приёма платежей с помощью Payment Gateway API#Техническая документация по интеграции с сервисом Payment Gateway API|Техническая документация по интеграции с сервисом Payment Gateway API]])
# Выполнить настройку метода оплаты ([[Интеграция сервиса приёма платежей с помощью Payment Gateway API#Настройка платёжного шлюза в {{NameSystem}}|Настройка платёжного шлюза]]) и сообщить в тикете реквизиты для взаимодействия {{NameSystem}} и платёжного шлюза (связка URL + логин + пароль) для завершения настройки платёжного метода технической поддержкой {{NameSystem}}
# Протестировать подключение перед началом боевой эксплуатации
# Сообщить в тикете о готовности перехода к продуктовый режим. Предоставить контакты службы поддержки сервиса по приёму платежей и тестовые реквизиты для дальнейшей поддержки сервиса

==Особенности==
Сервис не поддерживает фискализацию платежей по ФЗ 54.

==Настройка платёжного шлюза в {{NameSystem}}==

# В разделе '''Финансы и платежи → Платежные методы → Доступ с способам оплаты''' откройте доступ к способу оплаты UniversalNemoPay для пользователей/групп/компаний (подробнее о настройке см. [[Платежные методы в Nemo.travel]])
# В разделе '''Финансы и платежи → Платежные методы → Управление шлюзами''' создайте метод оплаты "UniversalNemoPay" (подробнее о настройке см. [[Платежные методы в Nemo.travel]])
# Откройте раздел "Реквизиты" созданного платёжного метода и задайте настройки доступа к платёжному шлюзу (подробнее о настройке см. [[Платежные методы в Nemo.travel]]):
#* ''URL клиентского сервера для запросов'' - адрес запросов для доступа к Сервису, например http://test.com/test
#* ''API логин'' - реквизит доступа к платёжному шлюзу, выдаётся платёжным шлюзом
#* ''Пароль'' - реквизит доступа к платёжному шлюзу, выдаётся платёжным шлюзом
#* ''Валюта'' - валюта по договору с платёжным шлюзом
#* ''Использовать двухстадийную оплату'' - если параметр включен, будет использована схема запросов с преавторизацией. Если выключен - схема запросов без преавторизации.
#* ''Разрешить оплату только картами Visa Electron и MasterCard Maestro''
#* ''Добавить локатор в начало идентификатора платежа при передаче в платежный шлюз'' - в orderNumber будет добавлен префикс с локатором.
#* ''Отображать фрэйм со страницей оплаты на странице информации о заказе '' - для оплаты во фрейме на странице заказа без перехода на странцу платёжного шлюза
#* ''Высота фрэйма со страницей оплаты'' - задайте высоту фрейма

=Техническая документация по интеграции с сервисом Payment Gateway API=

'''Используемые в разделе термины:'''
*''Система Немо'' - система бронирования Nemo Travel,
*''Сервис'' - сервис по приему платежей.

==Описание запросов==

{| class="wikitable"
! Название запроса !! Описание !! Особенности
|-
| register.do || Запрос регистрации заказа (без преавторизации)|| -
|-
| registerPreAuth.do || Запрос регистрации заказа c преавторизацией || -
|-
| deposit.do || Запрoс завершения oплаты заказа || -
|-
| reverse.do || Запрос отмены оплаты заказа || -
|-
| refund.do || Запрос возврата средств оплаты заказа || -
|-
| getOrderStatusExtended.do || Расширенный запрос состояния заказа || -
|-
|}

* Запросы, использующиеся при двухстадийной оплате (с преавторизацией): registerPreAuth.do, deposit.do.
* Запросы, использующиеся при одностадийной оплате (без преавторизации): register.do.
* Запросы reverse.do, refund.do и getOrderStatusExtended.do могут быть использованы при любой схеме оплаты.
* При необходимости возврата средств система Немо посылает запрос обновления заказа в платежный шлюз. Если полученный статус заказа - orderStatus=1, то посылается запрос reverse.do, если orderStatus=2, то посылается refund.do.

==Порядок взаимодействия Системы Немо и Сервиса==

===Оплата с преавторизацией===
#При инициировании оплаты Система Немо отправляет Запрос регистрации заказа registerPreAuth.do.
#Система Немо перенаправляет пользователя на url, который Сервис указал в ответе на запрос регистрации для совершения операции эквайринга на стороне Сервиса.
#Периодически Система Немо отправляет запрос getOrderStatusExtended.do для получения состояния заказа до тех пор, пока Сервис не укажет в качестве orderStatus 1 или 6 при нулевом значении errorCode. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =1, процедура продолжается.
#Параллельно с завершением транзакции Сервис переадресует клиента обратно на страницу заказа (returnUrl в запросе registerPreAuth.do). В результате операции Система Немо дополнительно направляет запрос getOrderStatusExtended для получения актуального статуса оплаты. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =1, процедура продолжается.
#Система Немо выполняет оформление заказа.
##Если оформление прошло успешно, Система Немо инициирует запрос deposit.do для завершения операции эквайринга на стороне Сервиса;
##Если оформление прошло неуспешно, Система Немо инициирует запрос reverse.do;
#Процедура оплаты завершена.

===Оплата без преавторизации===
#При инициировании оплаты Система Немо отправляет Запрос регистрации заказа register.do.
#Система Немо перенаправляет пользователя на url, который Сервис указал в ответе на запрос регистрации для совершения операции эквайринга на стороне Сервиса.
#Периодически Система Немо отправляет запрос getOrderStatusExtended.do для получения состояния заказа до тех пор, пока Сервис не укажет в качестве orderStatus 2 или 6 при нулевом значении errorCode. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =2, процедура продолжается.
#Параллельно с завершением транзакции Сервис переадресует клиента обратно на страницу заказа (returnUrl в запросе register.do). В результате операции Система Немо дополнительно направляет запрос getOrderStatusExtended для получения актуального статуса оплаты.
#Если orderStatus=2 и errorCode=0, Система Немо выполняет оформление заказа.

===Возврат средств===
Для возврата средств Система Немо направляет getOrderStatusExtended.do.
*Если полученный статус заказа orderStatus=1, то Система Немо направляет запрос reverse.do,
*Если orderStatus=2, то Система Немо направляет запрос refund.do.

==Формат запросов/ответов==

Универсальный API для подключения платежных шлюзов реализован с помощью HTTP запросов/ответов методом POST.

* register.do
<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderNumber, amount, returnUrl, currency, description, language, jsonParams
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
| returnUrl || Адрес, на который требуется перенаправить пользователя в случае успешной оплаты. Значение должно представлять собой абсолютную ссылку. || Пример: "http://test.com/universal_nemo_pay__after_authorisation?billing_id=111111111".
|-
| currency || Валюта || Код валюты платежа ISO 4217.
|-
| description || Описание заказа в свободной форме || Пример: "Оплата заказа №586578 (1X96WD) с сайта http://test.com".
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
| jsonParams || Блок для передачи дополнительных параметров мерчанта. || Пример данных передаваемых Немо: {"onlyMaestro":"false","email":"test@mutelab.com","phone":"79270099000"}
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: orderId, formUrl, errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| formUrl || URL платежной формы, на который надо перенаправить браузер клиента. || -
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* registerPreAuth.do
<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderNumber, amount, returnUrl, currency, description, language, jsonParams
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
| returnUrl || Адрес, на который требуется перенаправить пользователя в случае успешной оплаты. Значение должно представлять собой абсолютную ссылку. || Пример: "http://test.com/universal_nemo_pay__after_authorisation?billing_id=111111111".
|-
| currency || Валюта || Код валюты платежа ISO 4217.
|-
| description || Описание заказа в свободной форме || Пример: "Оплата заказа №586578 (1X96WD) с сайта http://test.com".
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
| jsonParams || Блок для передачи дополнительных параметров мерчанта. || Пример данных передаваемых Немо: {"onlyMaestro":"false","email":"test@mutelab.com","phone":"79270099000"}
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: orderId, formUrl, errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| formUrl || URL платежной формы, на который надо перенаправить браузер клиента. || -
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* deposit.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId, amount.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* reverse.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* refund.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* getOrderStatusExtended.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId, language, orderNumber.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage, orderStatus и cardAuthInfo(expiration, cardholderName, approvalCode, pan).
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
| orderStatus || Состояние заказа в платежной системе. ||
* 0 - Заказ зарегистрирован, но не оплачен
* 1 - Предавторизованная сумма захолдирована (для двухстадийных платежей)
* 2 - Проведена полная авторизация суммы заказа
* 6 - Авторизация отклонена
|-
| cardAuthInfo || Тэг с атрибутами платежа. ||
* expiration - Срок истечения действия карты в формате YYYYMM.
* cardholderName - Имя держателя карты.
* approvalCode - Код авторизации платежа. Поле фиксированной длины (6 символов), может содержать цифры и латинские буквы.
* pan - Маскированный номер карты, которая использовалась для оплаты.
|-
|}
</div></div>

=См.также=
[[Платежный шлюз]]

Интеграция сервиса приёма платежей с помощью Payment Gateway API

2020-04-08T15:33:50Z

Мария Горшенева: /* Порядок подключения модуля Payment Gateway API */

Payment Gateway API представляет собой протокол для подключения платежных шлюзов. Сервис позволяет с минимальными затратами времени и ресурсов подключить любой существующий платежный шлюз, используя единую схему подключения. Преимущество метода в том, что работы по разработке интеграции заказчик выполняет на своей стороне, а значит, самостоятельно планирует сроки интеграции и независимо управляет ресурсом.

=Порядок подключения модуля Payment Gateway API=

Модуль Payment Gateway API является дополнительным. Чтобы подключиться к Nemo.travel по данному протоколу, обратитесь в коммерческий отдел по адресу connect@nemo.travel

Для подключения платёжного сервиса по представленному методу агентству необходимо:
# Обратиться в коммерческий отдел {{NameSystem}} по адресу connect@nemo.travel с заявкой на подключение продукта, подписать документы на эксплуатацию сервиса
# Создать тикет в проектном трекере {{NameSystem}} на подключение сервиса. Вам будет открыт доступ к сервису "UniversalNemoPay" в разделе "Доступ к способам оплаты" (доступно только администраторам системы {{NameSystem}} )
# Провести интеграцию с {{NameSystem}} по протоколу Payment Gateway API, используя техническую документацию по интеграции ([[Интеграция сервиса приёма платежей с помощью Payment Gateway API#Техническая документация по интеграции с сервисом Payment Gateway API|Техническая документация по интеграции с сервисом Payment Gateway API]])
# Выполнить настройку метода оплаты ([[Интеграция сервиса приёма платежей с помощью Payment Gateway API#Настройка платёжного шлюза в {{NameSystem}}|Настройка платёжного шлюза]]) и сообщить в тикете дреквизиты для взаимодействия {{NameSystem}} и платёжного шлюза (связка URL + логин + пароль) для завершения настройки платёжного метода технической поддержкой {{NameSystem}}
# Протестировать подключение перед началом боевой эксплуатации
# Сообщить в тикете о готовности перехода к продуктовый режим. Предоставить контакты службы поддержки сервиса по приёму платежей и тестовые реквизиты для дальнейшей поддержки сервиса

==Особенности==
Сервис не поддерживает фискализацию платежей по ФЗ 54.

==Настройка платёжного шлюза в {{NameSystem}}==

# В разделе '''Финансы и платежи → Платежные методы → Доступ с способам оплаты''' откройте доступ к способу оплаты UniversalNemoPay для пользователей/групп/компаний (подробнее о настройке см. [[Платежные методы в Nemo.travel]])
# В разделе '''Финансы и платежи → Платежные методы → Управление шлюзами''' создайте метод оплаты "UniversalNemoPay" (подробнее о настройке см. [[Платежные методы в Nemo.travel]])
# Откройте раздел "Реквизиты" созданного платёжного метода и задайте настройки доступа к платёжному шлюзу (подробнее о настройке см. [[Платежные методы в Nemo.travel]]):
#* ''URL клиентского сервера для запросов'' - адрес запросов для доступа к Сервису, например http://test.com/test
#* ''API логин'' - реквизит доступа к платёжному шлюзу, выдаётся платёжным шлюзом
#* ''Пароль'' - реквизит доступа к платёжному шлюзу, выдаётся платёжным шлюзом
#* ''Валюта'' - валюта по договору с платёжным шлюзом
#* ''Использовать двухстадийную оплату'' - если параметр включен, будет использована схема запросов с преавторизацией. Если выключен - схема запросов без преавторизации.
#* ''Разрешить оплату только картами Visa Electron и MasterCard Maestro''
#* ''Добавить локатор в начало идентификатора платежа при передаче в платежный шлюз'' - в orderNumber будет добавлен префикс с локатором.
#* ''Отображать фрэйм со страницей оплаты на странице информации о заказе '' - для оплаты во фрейме на странице заказа без перехода на странцу платёжного шлюза
#* ''Высота фрэйма со страницей оплаты'' - задайте высоту фрейма

=Техническая документация по интеграции с сервисом Payment Gateway API=

'''Используемые в разделе термины:'''
*''Система Немо'' - система бронирования Nemo Travel,
*''Сервис'' - сервис по приему платежей.

==Описание запросов==

{| class="wikitable"
! Название запроса !! Описание !! Особенности
|-
| register.do || Запрос регистрации заказа (без преавторизации)|| -
|-
| registerPreAuth.do || Запрос регистрации заказа c преавторизацией || -
|-
| deposit.do || Запрoс завершения oплаты заказа || -
|-
| reverse.do || Запрос отмены оплаты заказа || -
|-
| refund.do || Запрос возврата средств оплаты заказа || -
|-
| getOrderStatusExtended.do || Расширенный запрос состояния заказа || -
|-
|}

* Запросы, использующиеся при двухстадийной оплате (с преавторизацией): registerPreAuth.do, deposit.do.
* Запросы, использующиеся при одностадийной оплате (без преавторизации): register.do.
* Запросы reverse.do, refund.do и getOrderStatusExtended.do могут быть использованы при любой схеме оплаты.
* При необходимости возврата средств система Немо посылает запрос обновления заказа в платежный шлюз. Если полученный статус заказа - orderStatus=1, то посылается запрос reverse.do, если orderStatus=2, то посылается refund.do.

==Порядок взаимодействия Системы Немо и Сервиса==

===Оплата с преавторизацией===
#При инициировании оплаты Система Немо отправляет Запрос регистрации заказа registerPreAuth.do.
#Система Немо перенаправляет пользователя на url, который Сервис указал в ответе на запрос регистрации для совершения операции эквайринга на стороне Сервиса.
#Периодически Система Немо отправляет запрос getOrderStatusExtended.do для получения состояния заказа до тех пор, пока Сервис не укажет в качестве orderStatus 1 или 6 при нулевом значении errorCode. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =1, процедура продолжается.
#Параллельно с завершением транзакции Сервис переадресует клиента обратно на страницу заказа (returnUrl в запросе registerPreAuth.do). В результате операции Система Немо дополнительно направляет запрос getOrderStatusExtended для получения актуального статуса оплаты. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =1, процедура продолжается.
#Система Немо выполняет оформление заказа.
##Если оформление прошло успешно, Система Немо инициирует запрос deposit.do для завершения операции эквайринга на стороне Сервиса;
##Если оформление прошло неуспешно, Система Немо инициирует запрос reverse.do;
#Процедура оплаты завершена.

===Оплата без преавторизации===
#При инициировании оплаты Система Немо отправляет Запрос регистрации заказа register.do.
#Система Немо перенаправляет пользователя на url, который Сервис указал в ответе на запрос регистрации для совершения операции эквайринга на стороне Сервиса.
#Периодически Система Немо отправляет запрос getOrderStatusExtended.do для получения состояния заказа до тех пор, пока Сервис не укажет в качестве orderStatus 2 или 6 при нулевом значении errorCode. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =2, процедура продолжается.
#Параллельно с завершением транзакции Сервис переадресует клиента обратно на страницу заказа (returnUrl в запросе register.do). В результате операции Система Немо дополнительно направляет запрос getOrderStatusExtended для получения актуального статуса оплаты.
#Если orderStatus=2 и errorCode=0, Система Немо выполняет оформление заказа.

===Возврат средств===
Для возврата средств Система Немо направляет getOrderStatusExtended.do.
*Если полученный статус заказа orderStatus=1, то Система Немо направляет запрос reverse.do,
*Если orderStatus=2, то Система Немо направляет запрос refund.do.

==Формат запросов/ответов==

Универсальный API для подключения платежных шлюзов реализован с помощью HTTP запросов/ответов методом POST.

* register.do
<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderNumber, amount, returnUrl, currency, description, language, jsonParams
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
| returnUrl || Адрес, на который требуется перенаправить пользователя в случае успешной оплаты. Значение должно представлять собой абсолютную ссылку. || Пример: "http://test.com/universal_nemo_pay__after_authorisation?billing_id=111111111".
|-
| currency || Валюта || Код валюты платежа ISO 4217.
|-
| description || Описание заказа в свободной форме || Пример: "Оплата заказа №586578 (1X96WD) с сайта http://test.com".
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
| jsonParams || Блок для передачи дополнительных параметров мерчанта. || Пример данных передаваемых Немо: {"onlyMaestro":"false","email":"test@mutelab.com","phone":"79270099000"}
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: orderId, formUrl, errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| formUrl || URL платежной формы, на который надо перенаправить браузер клиента. || -
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* registerPreAuth.do
<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderNumber, amount, returnUrl, currency, description, language, jsonParams
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
| returnUrl || Адрес, на который требуется перенаправить пользователя в случае успешной оплаты. Значение должно представлять собой абсолютную ссылку. || Пример: "http://test.com/universal_nemo_pay__after_authorisation?billing_id=111111111".
|-
| currency || Валюта || Код валюты платежа ISO 4217.
|-
| description || Описание заказа в свободной форме || Пример: "Оплата заказа №586578 (1X96WD) с сайта http://test.com".
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
| jsonParams || Блок для передачи дополнительных параметров мерчанта. || Пример данных передаваемых Немо: {"onlyMaestro":"false","email":"test@mutelab.com","phone":"79270099000"}
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: orderId, formUrl, errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| formUrl || URL платежной формы, на который надо перенаправить браузер клиента. || -
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* deposit.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId, amount.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* reverse.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* refund.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* getOrderStatusExtended.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId, language, orderNumber.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage, orderStatus и cardAuthInfo(expiration, cardholderName, approvalCode, pan).
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
| orderStatus || Состояние заказа в платежной системе. ||
* 0 - Заказ зарегистрирован, но не оплачен
* 1 - Предавторизованная сумма захолдирована (для двухстадийных платежей)
* 2 - Проведена полная авторизация суммы заказа
* 6 - Авторизация отклонена
|-
| cardAuthInfo || Тэг с атрибутами платежа. ||
* expiration - Срок истечения действия карты в формате YYYYMM.
* cardholderName - Имя держателя карты.
* approvalCode - Код авторизации платежа. Поле фиксированной длины (6 символов), может содержать цифры и латинские буквы.
* pan - Маскированный номер карты, которая использовалась для оплаты.
|-
|}
</div></div>

=См.также=
[[Платежный шлюз]]

Интеграция сервиса приёма платежей с помощью Payment Gateway API

2020-04-08T15:25:11Z

Мария Горшенева: /* Порядок подключения модуля Payment Gateway API */

Payment Gateway API представляет собой протокол для подключения платежных шлюзов. Сервис позволяет с минимальными затратами времени и ресурсов подключить любой существующий платежный шлюз, используя единую схему подключения. Преимущество метода в том, что работы по разработке интеграции заказчик выполняет на своей стороне, а значит, самостоятельно планирует сроки интеграции и независимо управляет ресурсом.

=Порядок подключения модуля Payment Gateway API=

Модуль Payment Gateway API является дополнительным. Чтобы подключиться к Nemo.travel по данному протоколу, обратитесь в коммерческий отдел по адресу connect@nemo.travel

Для подключения платёжного сервиса по представленному методу агентству необходимо:
# Обратиться в коммерческий отдел {{NameSystem}} по адресу connect@nemo.travel с заявкой на подключение продукта, подписать документы на эксплуатацию сервиса
# Создать тикет в проектном трекере {{NameSystem}} на подключение сервиса. Вам будет открыт доступ к сервису "UniversalNemoPay" в разделе "Доступ к способам оплаты" (доступно только администраторам системы {{NameSystem}} )
# Провести интеграцию с {{NameSystem}} по протоколу Payment Gateway API, используя техническую документацию по интеграции ([[Интеграция сервиса приёма платежей с помощью Payment Gateway API#Техническая документация по интеграции с сервисом Payment Gateway API|Техническая документация по интеграции с сервисом Payment Gateway API]])
# Выполнить настройку метода оплаты ([[Интеграция сервиса приёма платежей с помощью Payment Gateway API#Настройка платёжного шлюза в {{NameSystem}}|Настройка платёжного шлюза]])
# Протестировать подключение перед началом боевой эксплуатации
# Сообщить в тикете о готовности перехода к продуктовый режим. Предоставить контакты службы поддержки сервиса по приёму платежей и тестовые реквизиты для дальнейшей поддержки сервиса

==Особенности==
Сервис не поддерживает фискализацию платежей по ФЗ 54.

==Настройка платёжного шлюза в {{NameSystem}}==

# В разделе '''Финансы и платежи → Платежные методы → Доступ с способам оплаты''' откройте доступ к способу оплаты UniversalNemoPay для пользователей/групп/компаний (подробнее о настройке см. [[Платежные методы в Nemo.travel]])
# В разделе '''Финансы и платежи → Платежные методы → Управление шлюзами''' создайте метод оплаты "UniversalNemoPay" (подробнее о настройке см. [[Платежные методы в Nemo.travel]])
# Откройте раздел "Реквизиты" созданного платёжного метода и задайте настройки доступа к платёжному шлюзу (подробнее о настройке см. [[Платежные методы в Nemo.travel]]):
#* ''URL клиентского сервера для запросов'' - адрес запросов для доступа к Сервису, например http://test.com/test
#* ''API логин'' - реквизит доступа к платёжному шлюзу, выдаётся платёжным шлюзом
#* ''Пароль'' - реквизит доступа к платёжному шлюзу, выдаётся платёжным шлюзом
#* ''Валюта'' - валюта по договору с платёжным шлюзом
#* ''Использовать двухстадийную оплату'' - если параметр включен, будет использована схема запросов с преавторизацией. Если выключен - схема запросов без преавторизации.
#* ''Разрешить оплату только картами Visa Electron и MasterCard Maestro''
#* ''Добавить локатор в начало идентификатора платежа при передаче в платежный шлюз'' - в orderNumber будет добавлен префикс с локатором.
#* ''Отображать фрэйм со страницей оплаты на странице информации о заказе '' - для оплаты во фрейме на странице заказа без перехода на странцу платёжного шлюза
#* ''Высота фрэйма со страницей оплаты'' - задайте высоту фрейма

=Техническая документация по интеграции с сервисом Payment Gateway API=

'''Используемые в разделе термины:'''
*''Система Немо'' - система бронирования Nemo Travel,
*''Сервис'' - сервис по приему платежей.

==Описание запросов==

{| class="wikitable"
! Название запроса !! Описание !! Особенности
|-
| register.do || Запрос регистрации заказа (без преавторизации)|| -
|-
| registerPreAuth.do || Запрос регистрации заказа c преавторизацией || -
|-
| deposit.do || Запрoс завершения oплаты заказа || -
|-
| reverse.do || Запрос отмены оплаты заказа || -
|-
| refund.do || Запрос возврата средств оплаты заказа || -
|-
| getOrderStatusExtended.do || Расширенный запрос состояния заказа || -
|-
|}

* Запросы, использующиеся при двухстадийной оплате (с преавторизацией): registerPreAuth.do, deposit.do.
* Запросы, использующиеся при одностадийной оплате (без преавторизации): register.do.
* Запросы reverse.do, refund.do и getOrderStatusExtended.do могут быть использованы при любой схеме оплаты.
* При необходимости возврата средств система Немо посылает запрос обновления заказа в платежный шлюз. Если полученный статус заказа - orderStatus=1, то посылается запрос reverse.do, если orderStatus=2, то посылается refund.do.

==Порядок взаимодействия Системы Немо и Сервиса==

===Оплата с преавторизацией===
#При инициировании оплаты Система Немо отправляет Запрос регистрации заказа registerPreAuth.do.
#Система Немо перенаправляет пользователя на url, который Сервис указал в ответе на запрос регистрации для совершения операции эквайринга на стороне Сервиса.
#Периодически Система Немо отправляет запрос getOrderStatusExtended.do для получения состояния заказа до тех пор, пока Сервис не укажет в качестве orderStatus 1 или 6 при нулевом значении errorCode. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =1, процедура продолжается.
#Параллельно с завершением транзакции Сервис переадресует клиента обратно на страницу заказа (returnUrl в запросе registerPreAuth.do). В результате операции Система Немо дополнительно направляет запрос getOrderStatusExtended для получения актуального статуса оплаты. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =1, процедура продолжается.
#Система Немо выполняет оформление заказа.
##Если оформление прошло успешно, Система Немо инициирует запрос deposit.do для завершения операции эквайринга на стороне Сервиса;
##Если оформление прошло неуспешно, Система Немо инициирует запрос reverse.do;
#Процедура оплаты завершена.

===Оплата без преавторизации===
#При инициировании оплаты Система Немо отправляет Запрос регистрации заказа register.do.
#Система Немо перенаправляет пользователя на url, который Сервис указал в ответе на запрос регистрации для совершения операции эквайринга на стороне Сервиса.
#Периодически Система Немо отправляет запрос getOrderStatusExtended.do для получения состояния заказа до тех пор, пока Сервис не укажет в качестве orderStatus 2 или 6 при нулевом значении errorCode. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =2, процедура продолжается.
#Параллельно с завершением транзакции Сервис переадресует клиента обратно на страницу заказа (returnUrl в запросе register.do). В результате операции Система Немо дополнительно направляет запрос getOrderStatusExtended для получения актуального статуса оплаты.
#Если orderStatus=2 и errorCode=0, Система Немо выполняет оформление заказа.

===Возврат средств===
Для возврата средств Система Немо направляет getOrderStatusExtended.do.
*Если полученный статус заказа orderStatus=1, то Система Немо направляет запрос reverse.do,
*Если orderStatus=2, то Система Немо направляет запрос refund.do.

==Формат запросов/ответов==

Универсальный API для подключения платежных шлюзов реализован с помощью HTTP запросов/ответов методом POST.

* register.do
<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderNumber, amount, returnUrl, currency, description, language, jsonParams
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
| returnUrl || Адрес, на который требуется перенаправить пользователя в случае успешной оплаты. Значение должно представлять собой абсолютную ссылку. || Пример: "http://test.com/universal_nemo_pay__after_authorisation?billing_id=111111111".
|-
| currency || Валюта || Код валюты платежа ISO 4217.
|-
| description || Описание заказа в свободной форме || Пример: "Оплата заказа №586578 (1X96WD) с сайта http://test.com".
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
| jsonParams || Блок для передачи дополнительных параметров мерчанта. || Пример данных передаваемых Немо: {"onlyMaestro":"false","email":"test@mutelab.com","phone":"79270099000"}
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: orderId, formUrl, errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| formUrl || URL платежной формы, на который надо перенаправить браузер клиента. || -
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* registerPreAuth.do
<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderNumber, amount, returnUrl, currency, description, language, jsonParams
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
| returnUrl || Адрес, на который требуется перенаправить пользователя в случае успешной оплаты. Значение должно представлять собой абсолютную ссылку. || Пример: "http://test.com/universal_nemo_pay__after_authorisation?billing_id=111111111".
|-
| currency || Валюта || Код валюты платежа ISO 4217.
|-
| description || Описание заказа в свободной форме || Пример: "Оплата заказа №586578 (1X96WD) с сайта http://test.com".
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
| jsonParams || Блок для передачи дополнительных параметров мерчанта. || Пример данных передаваемых Немо: {"onlyMaestro":"false","email":"test@mutelab.com","phone":"79270099000"}
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: orderId, formUrl, errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| formUrl || URL платежной формы, на который надо перенаправить браузер клиента. || -
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* deposit.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId, amount.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* reverse.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* refund.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* getOrderStatusExtended.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId, language, orderNumber.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage, orderStatus и cardAuthInfo(expiration, cardholderName, approvalCode, pan).
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
| orderStatus || Состояние заказа в платежной системе. ||
* 0 - Заказ зарегистрирован, но не оплачен
* 1 - Предавторизованная сумма захолдирована (для двухстадийных платежей)
* 2 - Проведена полная авторизация суммы заказа
* 6 - Авторизация отклонена
|-
| cardAuthInfo || Тэг с атрибутами платежа. ||
* expiration - Срок истечения действия карты в формате YYYYMM.
* cardholderName - Имя держателя карты.
* approvalCode - Код авторизации платежа. Поле фиксированной длины (6 символов), может содержать цифры и латинские буквы.
* pan - Маскированный номер карты, которая использовалась для оплаты.
|-
|}
</div></div>

=См.также=
[[Платежный шлюз]]

Интеграция сервиса приёма платежей с помощью Payment Gateway API

2020-04-08T15:20:54Z

Мария Горшенева: /* Порядок подключения модуля Payment Gateway API */

Payment Gateway API представляет собой протокол для подключения платежных шлюзов. Сервис позволяет с минимальными затратами времени и ресурсов подключить любой существующий платежный шлюз, используя единую схему подключения. Преимущество метода в том, что работы по разработке интеграции заказчик выполняет на своей стороне, а значит, самостоятельно планирует сроки интеграции и независимо управляет ресурсом.

=Порядок подключения модуля Payment Gateway API=

Модуль Payment Gateway API является дополнительным. Чтобы подключиться к Nemo.travel по данному протоколу, обратитесь в коммерческий отдел по адресу connect@nemo.travel

Для подключения платёжного сервиса по представленному методу агентству необходимо:
# Обратиться в коммерческий отдел {{NameSystem}} по адресу connect@nemo.travel с заявкой на подключение продукта, подписать документы на эксплуатацию сервиса
# Создать тикет в проектном трекере {{NameSystem}} на подключение сервиса
# Провести интеграцию с {{NameSystem}} по протоколу Payment Gateway API, используя техническую документацию по интеграции ([[Интеграция сервиса приёма платежей с помощью Payment Gateway API#Техническая документация по интеграции с сервисом Payment Gateway API|Техническая документация по интеграции с сервисом Payment Gateway API]])
# Выполнить настройку метода оплаты ([[Интеграция сервиса приёма платежей с помощью Payment Gateway API#Настройка платёжного шлюза в {{NameSystem}}|Настройка платёжного шлюза]])
# Протестировать подключение перед началом боевой эксплуатации
# Сообщить в тикете о готовности перехода к продуктовый режим. Предоставить контакты службы поддержки сервиса по приёму платежей и тестовые реквизиты для дальнейшей поддержки сервиса

==Особенности==
Сервис не поддерживает фискализацию платежей по ФЗ 54.

==Настройка платёжного шлюза в {{NameSystem}}==

# В разделе '''Финансы и платежи → Платежные методы → Доступ с способам оплаты''' откройте доступ к способу оплаты UniversalNemoPay для пользователей/групп/компаний (подробнее о настройке см. [[Платежные методы в Nemo.travel]])
# В разделе '''Финансы и платежи → Платежные методы → Управление шлюзами''' создайте метод оплаты "UniversalNemoPay" (подробнее о настройке см. [[Платежные методы в Nemo.travel]])
# Откройте раздел "Реквизиты" созданного платёжного метода и задайте настройки доступа к платёжному шлюзу (подробнее о настройке см. [[Платежные методы в Nemo.travel]]):
#* ''URL клиентского сервера для запросов'' - адрес запросов для доступа к Сервису, например http://test.com/test
#* ''API логин'' - реквизит доступа к платёжному шлюзу, выдаётся платёжным шлюзом
#* ''Пароль'' - реквизит доступа к платёжному шлюзу, выдаётся платёжным шлюзом
#* ''Валюта'' - валюта по договору с платёжным шлюзом
#* ''Использовать двухстадийную оплату'' - если параметр включен, будет использована схема запросов с преавторизацией. Если выключен - схема запросов без преавторизации.
#* ''Разрешить оплату только картами Visa Electron и MasterCard Maestro''
#* ''Добавить локатор в начало идентификатора платежа при передаче в платежный шлюз'' - в orderNumber будет добавлен префикс с локатором.
#* ''Отображать фрэйм со страницей оплаты на странице информации о заказе '' - для оплаты во фрейме на странице заказа без перехода на странцу платёжного шлюза
#* ''Высота фрэйма со страницей оплаты'' - задайте высоту фрейма

=Техническая документация по интеграции с сервисом Payment Gateway API=

'''Используемые в разделе термины:'''
*''Система Немо'' - система бронирования Nemo Travel,
*''Сервис'' - сервис по приему платежей.

==Описание запросов==

{| class="wikitable"
! Название запроса !! Описание !! Особенности
|-
| register.do || Запрос регистрации заказа (без преавторизации)|| -
|-
| registerPreAuth.do || Запрос регистрации заказа c преавторизацией || -
|-
| deposit.do || Запрoс завершения oплаты заказа || -
|-
| reverse.do || Запрос отмены оплаты заказа || -
|-
| refund.do || Запрос возврата средств оплаты заказа || -
|-
| getOrderStatusExtended.do || Расширенный запрос состояния заказа || -
|-
|}

* Запросы, использующиеся при двухстадийной оплате (с преавторизацией): registerPreAuth.do, deposit.do.
* Запросы, использующиеся при одностадийной оплате (без преавторизации): register.do.
* Запросы reverse.do, refund.do и getOrderStatusExtended.do могут быть использованы при любой схеме оплаты.
* При необходимости возврата средств система Немо посылает запрос обновления заказа в платежный шлюз. Если полученный статус заказа - orderStatus=1, то посылается запрос reverse.do, если orderStatus=2, то посылается refund.do.

==Порядок взаимодействия Системы Немо и Сервиса==

===Оплата с преавторизацией===
#При инициировании оплаты Система Немо отправляет Запрос регистрации заказа registerPreAuth.do.
#Система Немо перенаправляет пользователя на url, который Сервис указал в ответе на запрос регистрации для совершения операции эквайринга на стороне Сервиса.
#Периодически Система Немо отправляет запрос getOrderStatusExtended.do для получения состояния заказа до тех пор, пока Сервис не укажет в качестве orderStatus 1 или 6 при нулевом значении errorCode. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =1, процедура продолжается.
#Параллельно с завершением транзакции Сервис переадресует клиента обратно на страницу заказа (returnUrl в запросе registerPreAuth.do). В результате операции Система Немо дополнительно направляет запрос getOrderStatusExtended для получения актуального статуса оплаты. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =1, процедура продолжается.
#Система Немо выполняет оформление заказа.
##Если оформление прошло успешно, Система Немо инициирует запрос deposit.do для завершения операции эквайринга на стороне Сервиса;
##Если оформление прошло неуспешно, Система Немо инициирует запрос reverse.do;
#Процедура оплаты завершена.

===Оплата без преавторизации===
#При инициировании оплаты Система Немо отправляет Запрос регистрации заказа register.do.
#Система Немо перенаправляет пользователя на url, который Сервис указал в ответе на запрос регистрации для совершения операции эквайринга на стороне Сервиса.
#Периодически Система Немо отправляет запрос getOrderStatusExtended.do для получения состояния заказа до тех пор, пока Сервис не укажет в качестве orderStatus 2 или 6 при нулевом значении errorCode. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =2, процедура продолжается.
#Параллельно с завершением транзакции Сервис переадресует клиента обратно на страницу заказа (returnUrl в запросе register.do). В результате операции Система Немо дополнительно направляет запрос getOrderStatusExtended для получения актуального статуса оплаты.
#Если orderStatus=2 и errorCode=0, Система Немо выполняет оформление заказа.

===Возврат средств===
Для возврата средств Система Немо направляет getOrderStatusExtended.do.
*Если полученный статус заказа orderStatus=1, то Система Немо направляет запрос reverse.do,
*Если orderStatus=2, то Система Немо направляет запрос refund.do.

==Формат запросов/ответов==

Универсальный API для подключения платежных шлюзов реализован с помощью HTTP запросов/ответов методом POST.

* register.do
<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderNumber, amount, returnUrl, currency, description, language, jsonParams
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
| returnUrl || Адрес, на который требуется перенаправить пользователя в случае успешной оплаты. Значение должно представлять собой абсолютную ссылку. || Пример: "http://test.com/universal_nemo_pay__after_authorisation?billing_id=111111111".
|-
| currency || Валюта || Код валюты платежа ISO 4217.
|-
| description || Описание заказа в свободной форме || Пример: "Оплата заказа №586578 (1X96WD) с сайта http://test.com".
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
| jsonParams || Блок для передачи дополнительных параметров мерчанта. || Пример данных передаваемых Немо: {"onlyMaestro":"false","email":"test@mutelab.com","phone":"79270099000"}
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: orderId, formUrl, errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| formUrl || URL платежной формы, на который надо перенаправить браузер клиента. || -
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* registerPreAuth.do
<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderNumber, amount, returnUrl, currency, description, language, jsonParams
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
| returnUrl || Адрес, на который требуется перенаправить пользователя в случае успешной оплаты. Значение должно представлять собой абсолютную ссылку. || Пример: "http://test.com/universal_nemo_pay__after_authorisation?billing_id=111111111".
|-
| currency || Валюта || Код валюты платежа ISO 4217.
|-
| description || Описание заказа в свободной форме || Пример: "Оплата заказа №586578 (1X96WD) с сайта http://test.com".
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
| jsonParams || Блок для передачи дополнительных параметров мерчанта. || Пример данных передаваемых Немо: {"onlyMaestro":"false","email":"test@mutelab.com","phone":"79270099000"}
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: orderId, formUrl, errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| formUrl || URL платежной формы, на который надо перенаправить браузер клиента. || -
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* deposit.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId, amount.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* reverse.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* refund.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* getOrderStatusExtended.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId, language, orderNumber.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage, orderStatus и cardAuthInfo(expiration, cardholderName, approvalCode, pan).
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
| orderStatus || Состояние заказа в платежной системе. ||
* 0 - Заказ зарегистрирован, но не оплачен
* 1 - Предавторизованная сумма захолдирована (для двухстадийных платежей)
* 2 - Проведена полная авторизация суммы заказа
* 6 - Авторизация отклонена
|-
| cardAuthInfo || Тэг с атрибутами платежа. ||
* expiration - Срок истечения действия карты в формате YYYYMM.
* cardholderName - Имя держателя карты.
* approvalCode - Код авторизации платежа. Поле фиксированной длины (6 символов), может содержать цифры и латинские буквы.
* pan - Маскированный номер карты, которая использовалась для оплаты.
|-
|}
</div></div>

=См.также=
[[Платежный шлюз]]

Интеграция сервиса приёма платежей с помощью Payment Gateway API

2020-04-08T09:00:21Z

Мария Горшенева: /* Техническая документация по интеграции с сервисом Payment Gateway API */

Payment Gateway API представляет собой протокол для подключения платежных шлюзов. Сервис позволяет с минимальными затратами времени и ресурсов подключить любой существующий платежный шлюз, используя единую схему подключения. Преимущество метода в том, что работы по разработке интеграции заказчик выполняет на своей стороне, а значит, самостоятельно планирует сроки интеграции и независимо управляет ресурсом.

=Порядок подключения модуля Payment Gateway API=

Модуль Payment Gateway API является дополнительным. Чтобы подключиться к Nemo.travel по данному протоколу, обратитесь в коммерческий отдел по адресу connect@nemo.travel

Для подключения платёжного сервиса по представленному методу агентству необходимо:
# Оставить заявку на подключение в коммерческий отдел {{NameSystem}} по адресу connect@nemo.travel, подписать документы на эксплуатацию сервиса
# Создать тикет в проектном трекере {{NameSystem}} на подключение сервиса
# Провести интеграцию с {{NameSystem}} по протоколу Payment Gateway API, используя техническую документацию по интеграции ([[Интеграция сервиса приёма платежей с помощью Payment Gateway API#Техническая документация по интеграции с сервисом Payment Gateway API|Техническая документация по интеграции с сервисом Payment Gateway API]])
# Выполнить настройку метода оплаты ([[Интеграция сервиса приёма платежей с помощью Payment Gateway API#Настройка платёжного шлюза в {{NameSystem}}|Настройка платёжного шлюза]])
# Протестировать подключение перед началом боевой эксплуатации
# Сообщить в тикете о готовности перехода к продуктовый режим. Предоставить контакты службы поддержки сервиса по приёму платежей и тестовые реквизиты для дальнейшей поддержки сервиса

==Особенности==
Сервис не поддерживает фискализацию платежей по ФЗ 54.

==Настройка платёжного шлюза в {{NameSystem}}==

# В разделе '''Финансы и платежи → Платежные методы → Доступ с способам оплаты''' откройте доступ к способу оплаты UniversalNemoPay для пользователей/групп/компаний (подробнее о настройке см. [[Платежные методы в Nemo.travel]])
# В разделе '''Финансы и платежи → Платежные методы → Управление шлюзами''' создайте метод оплаты "UniversalNemoPay" (подробнее о настройке см. [[Платежные методы в Nemo.travel]])
# Откройте раздел "Реквизиты" созданного платёжного метода и задайте настройки доступа к платёжному шлюзу (подробнее о настройке см. [[Платежные методы в Nemo.travel]]):
#* ''URL клиентского сервера для запросов'' - адрес запросов для доступа к Сервису, например http://test.com/test
#* ''API логин'' - реквизит доступа к платёжному шлюзу, выдаётся платёжным шлюзом
#* ''Пароль'' - реквизит доступа к платёжному шлюзу, выдаётся платёжным шлюзом
#* ''Валюта'' - валюта по договору с платёжным шлюзом
#* ''Использовать двухстадийную оплату'' - если параметр включен, будет использована схема запросов с преавторизацией. Если выключен - схема запросов без преавторизации.
#* ''Разрешить оплату только картами Visa Electron и MasterCard Maestro''
#* ''Добавить локатор в начало идентификатора платежа при передаче в платежный шлюз'' - в orderNumber будет добавлен префикс с локатором.
#* ''Отображать фрэйм со страницей оплаты на странице информации о заказе '' - для оплаты во фрейме на странице заказа без перехода на странцу платёжного шлюза
#* ''Высота фрэйма со страницей оплаты'' - задайте высоту фрейма

=Техническая документация по интеграции с сервисом Payment Gateway API=

'''Используемые в разделе термины:'''
*''Система Немо'' - система бронирования Nemo Travel,
*''Сервис'' - сервис по приему платежей.

==Описание запросов==

{| class="wikitable"
! Название запроса !! Описание !! Особенности
|-
| register.do || Запрос регистрации заказа (без преавторизации)|| -
|-
| registerPreAuth.do || Запрос регистрации заказа c преавторизацией || -
|-
| deposit.do || Запрoс завершения oплаты заказа || -
|-
| reverse.do || Запрос отмены оплаты заказа || -
|-
| refund.do || Запрос возврата средств оплаты заказа || -
|-
| getOrderStatusExtended.do || Расширенный запрос состояния заказа || -
|-
|}

* Запросы, использующиеся при двухстадийной оплате (с преавторизацией): registerPreAuth.do, deposit.do.
* Запросы, использующиеся при одностадийной оплате (без преавторизации): register.do.
* Запросы reverse.do, refund.do и getOrderStatusExtended.do могут быть использованы при любой схеме оплаты.
* При необходимости возврата средств система Немо посылает запрос обновления заказа в платежный шлюз. Если полученный статус заказа - orderStatus=1, то посылается запрос reverse.do, если orderStatus=2, то посылается refund.do.

==Порядок взаимодействия Системы Немо и Сервиса==

===Оплата с преавторизацией===
#При инициировании оплаты Система Немо отправляет Запрос регистрации заказа registerPreAuth.do.
#Система Немо перенаправляет пользователя на url, который Сервис указал в ответе на запрос регистрации для совершения операции эквайринга на стороне Сервиса.
#Периодически Система Немо отправляет запрос getOrderStatusExtended.do для получения состояния заказа до тех пор, пока Сервис не укажет в качестве orderStatus 1 или 6 при нулевом значении errorCode. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =1, процедура продолжается.
#Параллельно с завершением транзакции Сервис переадресует клиента обратно на страницу заказа (returnUrl в запросе registerPreAuth.do). В результате операции Система Немо дополнительно направляет запрос getOrderStatusExtended для получения актуального статуса оплаты. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =1, процедура продолжается.
#Система Немо выполняет оформление заказа.
##Если оформление прошло успешно, Система Немо инициирует запрос deposit.do для завершения операции эквайринга на стороне Сервиса;
##Если оформление прошло неуспешно, Система Немо инициирует запрос reverse.do;
#Процедура оплаты завершена.

===Оплата без преавторизации===
#При инициировании оплаты Система Немо отправляет Запрос регистрации заказа register.do.
#Система Немо перенаправляет пользователя на url, который Сервис указал в ответе на запрос регистрации для совершения операции эквайринга на стороне Сервиса.
#Периодически Система Немо отправляет запрос getOrderStatusExtended.do для получения состояния заказа до тех пор, пока Сервис не укажет в качестве orderStatus 2 или 6 при нулевом значении errorCode. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =2, процедура продолжается.
#Параллельно с завершением транзакции Сервис переадресует клиента обратно на страницу заказа (returnUrl в запросе register.do). В результате операции Система Немо дополнительно направляет запрос getOrderStatusExtended для получения актуального статуса оплаты.
#Если orderStatus=2 и errorCode=0, Система Немо выполняет оформление заказа.

===Возврат средств===
Для возврата средств Система Немо направляет getOrderStatusExtended.do.
*Если полученный статус заказа orderStatus=1, то Система Немо направляет запрос reverse.do,
*Если orderStatus=2, то Система Немо направляет запрос refund.do.

==Формат запросов/ответов==

Универсальный API для подключения платежных шлюзов реализован с помощью HTTP запросов/ответов методом POST.

* register.do
<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderNumber, amount, returnUrl, currency, description, language, jsonParams
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
| returnUrl || Адрес, на который требуется перенаправить пользователя в случае успешной оплаты. Значение должно представлять собой абсолютную ссылку. || Пример: "http://test.com/universal_nemo_pay__after_authorisation?billing_id=111111111".
|-
| currency || Валюта || Код валюты платежа ISO 4217.
|-
| description || Описание заказа в свободной форме || Пример: "Оплата заказа №586578 (1X96WD) с сайта http://test.com".
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
| jsonParams || Блок для передачи дополнительных параметров мерчанта. || Пример данных передаваемых Немо: {"onlyMaestro":"false","email":"test@mutelab.com","phone":"79270099000"}
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: orderId, formUrl, errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| formUrl || URL платежной формы, на который надо перенаправить браузер клиента. || -
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* registerPreAuth.do
<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderNumber, amount, returnUrl, currency, description, language, jsonParams
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
| returnUrl || Адрес, на который требуется перенаправить пользователя в случае успешной оплаты. Значение должно представлять собой абсолютную ссылку. || Пример: "http://test.com/universal_nemo_pay__after_authorisation?billing_id=111111111".
|-
| currency || Валюта || Код валюты платежа ISO 4217.
|-
| description || Описание заказа в свободной форме || Пример: "Оплата заказа №586578 (1X96WD) с сайта http://test.com".
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
| jsonParams || Блок для передачи дополнительных параметров мерчанта. || Пример данных передаваемых Немо: {"onlyMaestro":"false","email":"test@mutelab.com","phone":"79270099000"}
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: orderId, formUrl, errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| formUrl || URL платежной формы, на который надо перенаправить браузер клиента. || -
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* deposit.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId, amount.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* reverse.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* refund.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* getOrderStatusExtended.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId, language, orderNumber.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage, orderStatus и cardAuthInfo(expiration, cardholderName, approvalCode, pan).
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
| orderStatus || Состояние заказа в платежной системе. ||
* 0 - Заказ зарегистрирован, но не оплачен
* 1 - Предавторизованная сумма захолдирована (для двухстадийных платежей)
* 2 - Проведена полная авторизация суммы заказа
* 6 - Авторизация отклонена
|-
| cardAuthInfo || Тэг с атрибутами платежа. ||
* expiration - Срок истечения действия карты в формате YYYYMM.
* cardholderName - Имя держателя карты.
* approvalCode - Код авторизации платежа. Поле фиксированной длины (6 символов), может содержать цифры и латинские буквы.
* pan - Маскированный номер карты, которая использовалась для оплаты.
|-
|}
</div></div>

=См.также=
[[Платежный шлюз]]

Интеграция сервиса приёма платежей с помощью Payment Gateway API

2020-04-08T08:43:12Z

Мария Горшенева: /* Порядок подключения модуля Payment Gateway API */

Payment Gateway API представляет собой протокол для подключения платежных шлюзов. Сервис позволяет с минимальными затратами времени и ресурсов подключить любой существующий платежный шлюз, используя единую схему подключения. Преимущество метода в том, что работы по разработке интеграции заказчик выполняет на своей стороне, а значит, самостоятельно планирует сроки интеграции и независимо управляет ресурсом.

=Порядок подключения модуля Payment Gateway API=

Модуль Payment Gateway API является дополнительным. Чтобы подключиться к Nemo.travel по данному протоколу, обратитесь в коммерческий отдел по адресу connect@nemo.travel

Для подключения платёжного сервиса по представленному методу агентству необходимо:
# Оставить заявку на подключение в коммерческий отдел {{NameSystem}} по адресу connect@nemo.travel, подписать документы на эксплуатацию сервиса
# Создать тикет в проектном трекере {{NameSystem}} на подключение сервиса
# Провести интеграцию с {{NameSystem}} по протоколу Payment Gateway API, используя техническую документацию по интеграции ([[Интеграция сервиса приёма платежей с помощью Payment Gateway API#Техническая документация по интеграции с сервисом Payment Gateway API|Техническая документация по интеграции с сервисом Payment Gateway API]])
# Выполнить настройку метода оплаты ([[Интеграция сервиса приёма платежей с помощью Payment Gateway API#Настройка платёжного шлюза в {{NameSystem}}|Настройка платёжного шлюза]])
# Протестировать подключение перед началом боевой эксплуатации
# Сообщить в тикете о готовности перехода к продуктовый режим. Предоставить контакты службы поддержки сервиса по приёму платежей и тестовые реквизиты для дальнейшей поддержки сервиса

==Особенности==
Сервис не поддерживает фискализацию платежей по ФЗ 54.

==Настройка платёжного шлюза в {{NameSystem}}==

# В разделе '''Финансы и платежи → Платежные методы → Доступ с способам оплаты''' откройте доступ к способу оплаты UniversalNemoPay для пользователей/групп/компаний (подробнее о настройке см. [[Платежные методы в Nemo.travel]])
# В разделе '''Финансы и платежи → Платежные методы → Управление шлюзами''' создайте метод оплаты "UniversalNemoPay" (подробнее о настройке см. [[Платежные методы в Nemo.travel]])
# Откройте раздел "Реквизиты" созданного платёжного метода и задайте настройки доступа к платёжному шлюзу (подробнее о настройке см. [[Платежные методы в Nemo.travel]]):
#* ''URL клиентского сервера для запросов'' - адрес запросов для доступа к Сервису, например http://test.com/test
#* ''API логин'' - реквизит доступа к платёжному шлюзу, выдаётся платёжным шлюзом
#* ''Пароль'' - реквизит доступа к платёжному шлюзу, выдаётся платёжным шлюзом
#* ''Валюта'' - валюта по договору с платёжным шлюзом
#* ''Использовать двухстадийную оплату'' - если параметр включен, будет использована схема запросов с преавторизацией. Если выключен - схема запросов без преавторизации.
#* ''Разрешить оплату только картами Visa Electron и MasterCard Maestro''
#* ''Добавить локатор в начало идентификатора платежа при передаче в платежный шлюз'' - в orderNumber будет добавлен префикс с локатором.
#* ''Отображать фрэйм со страницей оплаты на странице информации о заказе '' - для оплаты во фрейме на странице заказа без перехода на странцу платёжного шлюза
#* ''Высота фрэйма со страницей оплаты'' - задайте высоту фрейма

=Техническая документация по интеграции с сервисом Payment Gateway API=

'''Используемые в разделе термины:'''
*''Система Немо'' - система бронирования Nemo Travel,
*''Сервис'' - сервис по приему платежей.

==Описание запросов==

{| class="wikitable"
! Название запроса !! Описание !! Особенности
|-
| register.do || Запрос регистрации заказа (без преавторизации)|| -
|-
| registerPreAuth.do || Запрос регистрации заказа c преавторизацией || -
|-
| deposit.do || Запрoс завершения oплаты заказа || -
|-
| reverse.do || Запрос отмены оплаты заказа || -
|-
| refund.do || Запрос возврата средств оплаты заказа || -
|-
| getOrderStatusExtended.do || Расширенный запрос состояния заказа || -
|-
|}

* Запросы, использующиеся при двухстадийной оплате (с преавторизацией): registerPreAuth.do, deposit.do.
* Запросы, использующиеся при одностадийной оплате (без преавторизации): register.do.
* Запросы reverse.do, refund.do и getOrderStatusExtended.do могут быть использованы при любой схеме оплаты.
* При необходимости возврата средств система Немо посылает запрос обновления заказа в платежный шлюз. Если полученный статус заказа - orderStatus=1, то посылается запрос reverse.do, если orderStatus=2, то посылается refund.do.

==Порядок взаимодействия Системы Немо и Сервиса==

===Оплата с преавторизацией===
#При инициировании оплаты Система Немо отправляет Запрос регистрации заказа registerPreAuth.do.
#Система Немо перенаправляет пользователя на url, который Сервис указал в ответе на запрос регистрации для совершения операции эквайринга на стороне Сервиса.
#Периодически Система Немо отправляет запрос getOrderStatusExtended.do для получения состояния заказа до тех пор, пока Сервис не укажет в качестве orderStatus 1 или 6 при нулевом значении errorCode. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =1, процедура продолжается.
#Параллельно с завершением транзакции Сервис переадресует клиента обратно на страницу заказа (returnUrl в запросе registerPreAuth.do). В результате операции Система Немо дополнительно направляет запрос getOrderStatusExtended для получения актуального статуса оплаты. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =1, процедура продолжается.
#Система Немо выполняет оформление заказа.
##Если оформление прошло успешно, Система Немо инициирует запрос deposit.do для завершения операции эквайринга на стороне Сервиса;
##Если оформление прошло неуспешно, Система Немо инициирует запрос reverse.do;
#Процедура оплаты завершена.

===Оплата без преавторизации===
#При инициировании оплаты Система Немо отправляет Запрос регистрации заказа register.do.
#Система Немо перенаправляет пользователя на url, который Сервис указал в ответе на запрос регистрации для совершения операции эквайринга на стороне Сервиса.
#Периодически Система Немо отправляет запрос getOrderStatusExtended.do для получения состояния заказа до тех пор, пока Сервис не укажет в качестве orderStatus 2 или 6 при нулевом значении errorCode. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =2, процедура продолжается.
#Параллельно с завершением транзакции Сервис переадресует клиента обратно на страницу заказа (returnUrl в запросе register.do). В результате операции Система Немо дополнительно направляет запрос getOrderStatusExtended для получения актуального статуса оплаты.
#Если orderStatus=2 и errorCode=0, Система Немо выполняет оформление заказа.

===Возврат средств===
Для возврата средств Система Немо направляет getOrderStatusExtended.do.
*Если полученный статус заказа orderStatus=1, то Система направляет запрос reverse.do,
*Если orderStatus=2, то Система направляет запрос refund.do.

==Формат запросов/ответов==

Универсальный API для подключения платежных шлюзов реализован с помощью HTTP запросов/ответов методом POST.

* register.do
<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderNumber, amount, returnUrl, currency, description, language, jsonParams
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
| returnUrl || Адрес, на который требуется перенаправить пользователя в случае успешной оплаты. Значение должно представлять собой абсолютную ссылку. || Пример: "http://test.com/universal_nemo_pay__after_authorisation?billing_id=111111111".
|-
| currency || Валюта || Код валюты платежа ISO 4217.
|-
| description || Описание заказа в свободной форме || Пример: "Оплата заказа №586578 (1X96WD) с сайта http://test.com".
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
| jsonParams || Блок для передачи дополнительных параметров мерчанта. || Пример данных передаваемых Немо: {"onlyMaestro":"false","email":"test@mutelab.com","phone":"79270099000"}
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: orderId, formUrl, errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| formUrl || URL платежной формы, на который надо перенаправить браузер клиента. || -
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* registerPreAuth.do
<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderNumber, amount, returnUrl, currency, description, language, jsonParams
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
| returnUrl || Адрес, на который требуется перенаправить пользователя в случае успешной оплаты. Значение должно представлять собой абсолютную ссылку. || Пример: "http://test.com/universal_nemo_pay__after_authorisation?billing_id=111111111".
|-
| currency || Валюта || Код валюты платежа ISO 4217.
|-
| description || Описание заказа в свободной форме || Пример: "Оплата заказа №586578 (1X96WD) с сайта http://test.com".
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
| jsonParams || Блок для передачи дополнительных параметров мерчанта. || Пример данных передаваемых Немо: {"onlyMaestro":"false","email":"test@mutelab.com","phone":"79270099000"}
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: orderId, formUrl, errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| formUrl || URL платежной формы, на который надо перенаправить браузер клиента. || -
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* deposit.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId, amount.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* reverse.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* refund.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* getOrderStatusExtended.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId, language, orderNumber.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage, orderStatus и cardAuthInfo(expiration, cardholderName, approvalCode, pan).
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
| orderStatus || Состояние заказа в платежной системе. ||
* 0 - Заказ зарегистрирован, но не оплачен
* 1 - Предавторизованная сумма захолдирована (для двухстадийных платежей)
* 2 - Проведена полная авторизация суммы заказа
* 6 - Авторизация отклонена
|-
| cardAuthInfo || Тэг с атрибутами платежа. ||
* expiration - Срок истечения действия карты в формате YYYYMM.
* cardholderName - Имя держателя карты.
* approvalCode - Код авторизации платежа. Поле фиксированной длины (6 символов), может содержать цифры и латинские буквы.
* pan - Маскированный номер карты, которая использовалась для оплаты.
|-
|}
</div></div>

=См.также=
[[Платежный шлюз]]

Интеграция сервиса приёма платежей с помощью Payment Gateway API

2020-04-08T08:29:47Z

Мария Горшенева: /* Настройка платёжного шлюза в {{NameSystem}} */

Payment Gateway API представляет собой протокол для подключения платежных шлюзов. Сервис позволяет с минимальными затратами времени и ресурсов подключить любой существующий платежный шлюз, используя единую схему подключения. Преимущество метода в том, что работы по разработке интеграции заказчик выполняет на своей стороне, а значит, самостоятельно планирует сроки интеграции и независимо управляет ресурсом.

=Порядок подключения модуля Payment Gateway API=

Модуль Payment Gateway API является дополнительным. Чтобы подключиться к Nemo.travel по данному протоколу, обратитесь в коммерческий отдел по адресу connect@nemo.travel

Для подключения платёжного сервиса по представленному методу агентству необходимо:
# Оставить заявку на подключение в коммерческий отдел {{NameSystem}} по адресу connect@nemo.travel, подписать документы на эксплуатацию сервиса
# Создать тикет в проектном трекере {{NameSystem}} на подключение сервиса
# Провести интеграцию с {{NameSystem}} по протоколу Payment Gateway API, используя техническую документацию по интеграции ([[Интеграция сервиса приёма платежей с помощью Payment Gateway API#Техническая документация по интеграции с сервисом Payment Gateway API|Техническая документация по интеграции с сервисом Payment Gateway API]])
# Выполнить настройку метода оплаты ([[Интеграция сервиса приёма платежей с помощью Payment Gateway API#Настройка платёжного шлюза в {{NameSystem}}|Настройка платёжного шлюза]])
# Протестировать подключение перед началом боевой эксплуатации

==Особенности==
Сервис не поддерживает фискализацию платежей по ФЗ 54.

==Настройка платёжного шлюза в {{NameSystem}}==

# В разделе '''Финансы и платежи → Платежные методы → Доступ с способам оплаты''' откройте доступ к способу оплаты UniversalNemoPay для пользователей/групп/компаний (подробнее о настройке см. [[Платежные методы в Nemo.travel]])
# В разделе '''Финансы и платежи → Платежные методы → Управление шлюзами''' создайте метод оплаты "UniversalNemoPay" (подробнее о настройке см. [[Платежные методы в Nemo.travel]])
# Откройте раздел "Реквизиты" созданного платёжного метода и задайте настройки доступа к платёжному шлюзу (подробнее о настройке см. [[Платежные методы в Nemo.travel]]):
#* ''URL клиентского сервера для запросов'' - адрес запросов для доступа к Сервису, например http://test.com/test
#* ''API логин'' - реквизит доступа к платёжному шлюзу, выдаётся платёжным шлюзом
#* ''Пароль'' - реквизит доступа к платёжному шлюзу, выдаётся платёжным шлюзом
#* ''Валюта'' - валюта по договору с платёжным шлюзом
#* ''Использовать двухстадийную оплату'' - если параметр включен, будет использована схема запросов с преавторизацией. Если выключен - схема запросов без преавторизации.
#* ''Разрешить оплату только картами Visa Electron и MasterCard Maestro''
#* ''Добавить локатор в начало идентификатора платежа при передаче в платежный шлюз'' - в orderNumber будет добавлен префикс с локатором.
#* ''Отображать фрэйм со страницей оплаты на странице информации о заказе '' - для оплаты во фрейме на странице заказа без перехода на странцу платёжного шлюза
#* ''Высота фрэйма со страницей оплаты'' - задайте высоту фрейма

=Техническая документация по интеграции с сервисом Payment Gateway API=

'''Используемые в разделе термины:'''
*''Система Немо'' - система бронирования Nemo Travel,
*''Сервис'' - сервис по приему платежей.

==Описание запросов==

{| class="wikitable"
! Название запроса !! Описание !! Особенности
|-
| register.do || Запрос регистрации заказа (без преавторизации)|| -
|-
| registerPreAuth.do || Запрос регистрации заказа c преавторизацией || -
|-
| deposit.do || Запрoс завершения oплаты заказа || -
|-
| reverse.do || Запрос отмены оплаты заказа || -
|-
| refund.do || Запрос возврата средств оплаты заказа || -
|-
| getOrderStatusExtended.do || Расширенный запрос состояния заказа || -
|-
|}

* Запросы, использующиеся при двухстадийной оплате (с преавторизацией): registerPreAuth.do, deposit.do.
* Запросы, использующиеся при одностадийной оплате (без преавторизации): register.do.
* Запросы reverse.do, refund.do и getOrderStatusExtended.do могут быть использованы при любой схеме оплаты.
* При необходимости возврата средств система Немо посылает запрос обновления заказа в платежный шлюз. Если полученный статус заказа - orderStatus=1, то посылается запрос reverse.do, если orderStatus=2, то посылается refund.do.

==Порядок взаимодействия Системы Немо и Сервиса==

===Оплата с преавторизацией===
#При инициировании оплаты Система Немо отправляет Запрос регистрации заказа registerPreAuth.do.
#Система Немо перенаправляет пользователя на url, который Сервис указал в ответе на запрос регистрации для совершения операции эквайринга на стороне Сервиса.
#Периодически Система Немо отправляет запрос getOrderStatusExtended.do для получения состояния заказа до тех пор, пока Сервис не укажет в качестве orderStatus 1 или 6 при нулевом значении errorCode. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =1, процедура продолжается.
#Параллельно с завершением транзакции Сервис переадресует клиента обратно на страницу заказа (returnUrl в запросе registerPreAuth.do). В результате операции Система Немо дополнительно направляет запрос getOrderStatusExtended для получения актуального статуса оплаты. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =1, процедура продолжается.
#Система Немо выполняет оформление заказа.
##Если оформление прошло успешно, Система Немо инициирует запрос deposit.do для завершения операции эквайринга на стороне Сервиса;
##Если оформление прошло неуспешно, Система Немо инициирует запрос reverse.do;
#Процедура оплаты завершена.

===Оплата без преавторизации===
#При инициировании оплаты Система Немо отправляет Запрос регистрации заказа register.do.
#Система Немо перенаправляет пользователя на url, который Сервис указал в ответе на запрос регистрации для совершения операции эквайринга на стороне Сервиса.
#Периодически Система Немо отправляет запрос getOrderStatusExtended.do для получения состояния заказа до тех пор, пока Сервис не укажет в качестве orderStatus 2 или 6 при нулевом значении errorCode. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =2, процедура продолжается.
#Параллельно с завершением транзакции Сервис переадресует клиента обратно на страницу заказа (returnUrl в запросе register.do). В результате операции Система Немо дополнительно направляет запрос getOrderStatusExtended для получения актуального статуса оплаты.
#Если orderStatus=2 и errorCode=0, Система Немо выполняет оформление заказа.

===Возврат средств===
Для возврата средств Система Немо направляет getOrderStatusExtended.do.
*Если полученный статус заказа orderStatus=1, то Система направляет запрос reverse.do,
*Если orderStatus=2, то Система направляет запрос refund.do.

==Формат запросов/ответов==

Универсальный API для подключения платежных шлюзов реализован с помощью HTTP запросов/ответов методом POST.

* register.do
<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderNumber, amount, returnUrl, currency, description, language, jsonParams
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
| returnUrl || Адрес, на который требуется перенаправить пользователя в случае успешной оплаты. Значение должно представлять собой абсолютную ссылку. || Пример: "http://test.com/universal_nemo_pay__after_authorisation?billing_id=111111111".
|-
| currency || Валюта || Код валюты платежа ISO 4217.
|-
| description || Описание заказа в свободной форме || Пример: "Оплата заказа №586578 (1X96WD) с сайта http://test.com".
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
| jsonParams || Блок для передачи дополнительных параметров мерчанта. || Пример данных передаваемых Немо: {"onlyMaestro":"false","email":"test@mutelab.com","phone":"79270099000"}
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: orderId, formUrl, errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| formUrl || URL платежной формы, на который надо перенаправить браузер клиента. || -
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* registerPreAuth.do
<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderNumber, amount, returnUrl, currency, description, language, jsonParams
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
| returnUrl || Адрес, на который требуется перенаправить пользователя в случае успешной оплаты. Значение должно представлять собой абсолютную ссылку. || Пример: "http://test.com/universal_nemo_pay__after_authorisation?billing_id=111111111".
|-
| currency || Валюта || Код валюты платежа ISO 4217.
|-
| description || Описание заказа в свободной форме || Пример: "Оплата заказа №586578 (1X96WD) с сайта http://test.com".
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
| jsonParams || Блок для передачи дополнительных параметров мерчанта. || Пример данных передаваемых Немо: {"onlyMaestro":"false","email":"test@mutelab.com","phone":"79270099000"}
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: orderId, formUrl, errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| formUrl || URL платежной формы, на который надо перенаправить браузер клиента. || -
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* deposit.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId, amount.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* reverse.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* refund.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* getOrderStatusExtended.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId, language, orderNumber.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage, orderStatus и cardAuthInfo(expiration, cardholderName, approvalCode, pan).
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
| orderStatus || Состояние заказа в платежной системе. ||
* 0 - Заказ зарегистрирован, но не оплачен
* 1 - Предавторизованная сумма захолдирована (для двухстадийных платежей)
* 2 - Проведена полная авторизация суммы заказа
* 6 - Авторизация отклонена
|-
| cardAuthInfo || Тэг с атрибутами платежа. ||
* expiration - Срок истечения действия карты в формате YYYYMM.
* cardholderName - Имя держателя карты.
* approvalCode - Код авторизации платежа. Поле фиксированной длины (6 символов), может содержать цифры и латинские буквы.
* pan - Маскированный номер карты, которая использовалась для оплаты.
|-
|}
</div></div>

=См.также=
[[Платежный шлюз]]

Интеграция сервиса приёма платежей с помощью Payment Gateway API

2020-04-08T08:28:19Z

Мария Горшенева: /* Порядок подключения модуля Payment Gateway API */

Payment Gateway API представляет собой протокол для подключения платежных шлюзов. Сервис позволяет с минимальными затратами времени и ресурсов подключить любой существующий платежный шлюз, используя единую схему подключения. Преимущество метода в том, что работы по разработке интеграции заказчик выполняет на своей стороне, а значит, самостоятельно планирует сроки интеграции и независимо управляет ресурсом.

=Порядок подключения модуля Payment Gateway API=

Модуль Payment Gateway API является дополнительным. Чтобы подключиться к Nemo.travel по данному протоколу, обратитесь в коммерческий отдел по адресу connect@nemo.travel

Для подключения платёжного сервиса по представленному методу агентству необходимо:
# Оставить заявку на подключение в коммерческий отдел {{NameSystem}} по адресу connect@nemo.travel, подписать документы на эксплуатацию сервиса
# Создать тикет в проектном трекере {{NameSystem}} на подключение сервиса
# Провести интеграцию с {{NameSystem}} по протоколу Payment Gateway API, используя техническую документацию по интеграции ([[Интеграция сервиса приёма платежей с помощью Payment Gateway API#Техническая документация по интеграции с сервисом Payment Gateway API|Техническая документация по интеграции с сервисом Payment Gateway API]])
# Выполнить настройку метода оплаты ([[Интеграция сервиса приёма платежей с помощью Payment Gateway API#Настройка платёжного шлюза в {{NameSystem}}|Настройка платёжного шлюза]])
# Протестировать подключение перед началом боевой эксплуатации

==Особенности==
Сервис не поддерживает фискализацию платежей по ФЗ 54.

==Настройка платёжного шлюза в {{NameSystem}}==

# В разделе '''Финансы и платежи → Платежные методы → Доступ с способам оплаты''' откройте доступ к способу оплаты для пользователей/групп/компаний (подробнее о настройке см. [[Платежные методы в Nemo.travel]])
# В разделе '''Финансы и платежи → Платежные методы → Управление шлюзами''' создайте метод оплаты "UniversalNemoPay" (подробнее о настройке см. [[Платежные методы в Nemo.travel]])
# Откройте раздел "Реквизиты" созданного платёжного метода и задайте настройки доступа к платёжному шлюзу (подробнее о настройке см. [[Платежные методы в Nemo.travel]]):
#* ''URL клиентского сервера для запросов'' - адрес запросов для доступа к Сервису, например http://test.com/test
#* ''API логин'' - реквизит доступа к платёжному шлюзу, выдаётся платёжным шлюзом
#* ''Пароль'' - реквизит доступа к платёжному шлюзу, выдаётся платёжным шлюзом
#* ''Валюта'' - валюта по договору с платёжным шлюзом
#* ''Использовать двухстадийную оплату'' - если параметр включен, будет использована схема запросов с преавторизацией. Если выключен - схема запросов без преавторизации.
#* ''Разрешить оплату только картами Visa Electron и MasterCard Maestro''
#* ''Добавить локатор в начало идентификатора платежа при передаче в платежный шлюз'' - в orderNumber будет добавлен префикс с локатором.
#* ''Отображать фрэйм со страницей оплаты на странице информации о заказе '' - для оплаты во фрейме на странице заказа без перехода на странцу платёжного шлюза
#* ''Высота фрэйма со страницей оплаты'' - задайте высоту фрейма

=Техническая документация по интеграции с сервисом Payment Gateway API=

'''Используемые в разделе термины:'''
*''Система Немо'' - система бронирования Nemo Travel,
*''Сервис'' - сервис по приему платежей.

==Описание запросов==

{| class="wikitable"
! Название запроса !! Описание !! Особенности
|-
| register.do || Запрос регистрации заказа (без преавторизации)|| -
|-
| registerPreAuth.do || Запрос регистрации заказа c преавторизацией || -
|-
| deposit.do || Запрoс завершения oплаты заказа || -
|-
| reverse.do || Запрос отмены оплаты заказа || -
|-
| refund.do || Запрос возврата средств оплаты заказа || -
|-
| getOrderStatusExtended.do || Расширенный запрос состояния заказа || -
|-
|}

* Запросы, использующиеся при двухстадийной оплате (с преавторизацией): registerPreAuth.do, deposit.do.
* Запросы, использующиеся при одностадийной оплате (без преавторизации): register.do.
* Запросы reverse.do, refund.do и getOrderStatusExtended.do могут быть использованы при любой схеме оплаты.
* При необходимости возврата средств система Немо посылает запрос обновления заказа в платежный шлюз. Если полученный статус заказа - orderStatus=1, то посылается запрос reverse.do, если orderStatus=2, то посылается refund.do.

==Порядок взаимодействия Системы Немо и Сервиса==

===Оплата с преавторизацией===
#При инициировании оплаты Система Немо отправляет Запрос регистрации заказа registerPreAuth.do.
#Система Немо перенаправляет пользователя на url, который Сервис указал в ответе на запрос регистрации для совершения операции эквайринга на стороне Сервиса.
#Периодически Система Немо отправляет запрос getOrderStatusExtended.do для получения состояния заказа до тех пор, пока Сервис не укажет в качестве orderStatus 1 или 6 при нулевом значении errorCode. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =1, процедура продолжается.
#Параллельно с завершением транзакции Сервис переадресует клиента обратно на страницу заказа (returnUrl в запросе registerPreAuth.do). В результате операции Система Немо дополнительно направляет запрос getOrderStatusExtended для получения актуального статуса оплаты. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =1, процедура продолжается.
#Система Немо выполняет оформление заказа.
##Если оформление прошло успешно, Система Немо инициирует запрос deposit.do для завершения операции эквайринга на стороне Сервиса;
##Если оформление прошло неуспешно, Система Немо инициирует запрос reverse.do;
#Процедура оплаты завершена.

===Оплата без преавторизации===
#При инициировании оплаты Система Немо отправляет Запрос регистрации заказа register.do.
#Система Немо перенаправляет пользователя на url, который Сервис указал в ответе на запрос регистрации для совершения операции эквайринга на стороне Сервиса.
#Периодически Система Немо отправляет запрос getOrderStatusExtended.do для получения состояния заказа до тех пор, пока Сервис не укажет в качестве orderStatus 2 или 6 при нулевом значении errorCode. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =2, процедура продолжается.
#Параллельно с завершением транзакции Сервис переадресует клиента обратно на страницу заказа (returnUrl в запросе register.do). В результате операции Система Немо дополнительно направляет запрос getOrderStatusExtended для получения актуального статуса оплаты.
#Если orderStatus=2 и errorCode=0, Система Немо выполняет оформление заказа.

===Возврат средств===
Для возврата средств Система Немо направляет getOrderStatusExtended.do.
*Если полученный статус заказа orderStatus=1, то Система направляет запрос reverse.do,
*Если orderStatus=2, то Система направляет запрос refund.do.

==Формат запросов/ответов==

Универсальный API для подключения платежных шлюзов реализован с помощью HTTP запросов/ответов методом POST.

* register.do
<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderNumber, amount, returnUrl, currency, description, language, jsonParams
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
| returnUrl || Адрес, на который требуется перенаправить пользователя в случае успешной оплаты. Значение должно представлять собой абсолютную ссылку. || Пример: "http://test.com/universal_nemo_pay__after_authorisation?billing_id=111111111".
|-
| currency || Валюта || Код валюты платежа ISO 4217.
|-
| description || Описание заказа в свободной форме || Пример: "Оплата заказа №586578 (1X96WD) с сайта http://test.com".
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
| jsonParams || Блок для передачи дополнительных параметров мерчанта. || Пример данных передаваемых Немо: {"onlyMaestro":"false","email":"test@mutelab.com","phone":"79270099000"}
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: orderId, formUrl, errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| formUrl || URL платежной формы, на который надо перенаправить браузер клиента. || -
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* registerPreAuth.do
<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderNumber, amount, returnUrl, currency, description, language, jsonParams
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
| returnUrl || Адрес, на который требуется перенаправить пользователя в случае успешной оплаты. Значение должно представлять собой абсолютную ссылку. || Пример: "http://test.com/universal_nemo_pay__after_authorisation?billing_id=111111111".
|-
| currency || Валюта || Код валюты платежа ISO 4217.
|-
| description || Описание заказа в свободной форме || Пример: "Оплата заказа №586578 (1X96WD) с сайта http://test.com".
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
| jsonParams || Блок для передачи дополнительных параметров мерчанта. || Пример данных передаваемых Немо: {"onlyMaestro":"false","email":"test@mutelab.com","phone":"79270099000"}
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: orderId, formUrl, errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| formUrl || URL платежной формы, на который надо перенаправить браузер клиента. || -
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* deposit.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId, amount.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* reverse.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* refund.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* getOrderStatusExtended.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId, language, orderNumber.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage, orderStatus и cardAuthInfo(expiration, cardholderName, approvalCode, pan).
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
| orderStatus || Состояние заказа в платежной системе. ||
* 0 - Заказ зарегистрирован, но не оплачен
* 1 - Предавторизованная сумма захолдирована (для двухстадийных платежей)
* 2 - Проведена полная авторизация суммы заказа
* 6 - Авторизация отклонена
|-
| cardAuthInfo || Тэг с атрибутами платежа. ||
* expiration - Срок истечения действия карты в формате YYYYMM.
* cardholderName - Имя держателя карты.
* approvalCode - Код авторизации платежа. Поле фиксированной длины (6 символов), может содержать цифры и латинские буквы.
* pan - Маскированный номер карты, которая использовалась для оплаты.
|-
|}
</div></div>

=См.также=
[[Платежный шлюз]]

Интеграция сервиса приёма платежей с помощью Payment Gateway API

2020-04-07T16:45:27Z

Мария Горшенева: /* Настройка платёжного шлюза в {{NameSystem}} */

Payment Gateway API представляет собой протокол для подключения платежных шлюзов. Сервис позволяет с минимальными затратами времени и ресурсов подключить любой существующий платежный шлюз, используя единую схему подключения. Преимущество метода в том, что работы по разработке интеграции заказчик выполняет на своей стороне, а значит, самостоятельно планирует сроки интеграции и независимо управляет ресурсом.

=Порядок подключения модуля Payment Gateway API=

Модуль Payment Gateway API является дополнительным. Чтобы подключиться к Nemo.travel по данному протоколу, обратитесь в коммерческий отдел по адресу connect@nemo.travel

==Особенности==
Сервис не поддерживает фискализацию платежей по ФЗ 54.

==Настройка платёжного шлюза в {{NameSystem}}==

# В разделе '''Финансы и платежи → Платежные методы → Доступ с способам оплаты''' откройте доступ к способу оплаты для пользователей/групп/компаний (подробнее о настройке см. [[Платежные методы в Nemo.travel]])
# В разделе '''Финансы и платежи → Платежные методы → Управление шлюзами''' создайте метод оплаты "UniversalNemoPay" (подробнее о настройке см. [[Платежные методы в Nemo.travel]])
# Откройте раздел "Реквизиты" созданного платёжного метода и задайте настройки доступа к платёжному шлюзу (подробнее о настройке см. [[Платежные методы в Nemo.travel]]):
#* ''URL клиентского сервера для запросов'' - адрес запросов для доступа к Сервису, например http://test.com/test
#* ''API логин'' - реквизит доступа к платёжному шлюзу, выдаётся платёжным шлюзом
#* ''Пароль'' - реквизит доступа к платёжному шлюзу, выдаётся платёжным шлюзом
#* ''Валюта'' - валюта по договору с платёжным шлюзом
#* ''Использовать двухстадийную оплату'' - если параметр включен, будет использована схема запросов с преавторизацией. Если выключен - схема запросов без преавторизации.
#* ''Разрешить оплату только картами Visa Electron и MasterCard Maestro''
#* ''Добавить локатор в начало идентификатора платежа при передаче в платежный шлюз'' - в orderNumber будет добавлен префикс с локатором.
#* ''Отображать фрэйм со страницей оплаты на странице информации о заказе '' - для оплаты во фрейме на странице заказа без перехода на странцу платёжного шлюза
#* ''Высота фрэйма со страницей оплаты'' - задайте высоту фрейма

=Техническая документация по интеграции с сервисом Payment Gateway API=

'''Используемые в разделе термины:'''
*''Система Немо'' - система бронирования Nemo Travel,
*''Сервис'' - сервис по приему платежей.

==Описание запросов==

{| class="wikitable"
! Название запроса !! Описание !! Особенности
|-
| register.do || Запрос регистрации заказа (без преавторизации)|| -
|-
| registerPreAuth.do || Запрос регистрации заказа c преавторизацией || -
|-
| deposit.do || Запрoс завершения oплаты заказа || -
|-
| reverse.do || Запрос отмены оплаты заказа || -
|-
| refund.do || Запрос возврата средств оплаты заказа || -
|-
| getOrderStatusExtended.do || Расширенный запрос состояния заказа || -
|-
|}

* Запросы, использующиеся при двухстадийной оплате (с преавторизацией): registerPreAuth.do, deposit.do.
* Запросы, использующиеся при одностадийной оплате (без преавторизации): register.do.
* Запросы reverse.do, refund.do и getOrderStatusExtended.do могут быть использованы при любой схеме оплаты.
* При необходимости возврата средств система Немо посылает запрос обновления заказа в платежный шлюз. Если полученный статус заказа - orderStatus=1, то посылается запрос reverse.do, если orderStatus=2, то посылается refund.do.

==Порядок взаимодействия Системы Немо и Сервиса==

===Оплата с преавторизацией===
#При инициировании оплаты Система Немо отправляет Запрос регистрации заказа registerPreAuth.do.
#Система Немо перенаправляет пользователя на url, который Сервис указал в ответе на запрос регистрации для совершения операции эквайринга на стороне Сервиса.
#Периодически Система Немо отправляет запрос getOrderStatusExtended.do для получения состояния заказа до тех пор, пока Сервис не укажет в качестве orderStatus 1 или 6 при нулевом значении errorCode. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =1, процедура продолжается.
#Параллельно с завершением транзакции Сервис переадресует клиента обратно на страницу заказа (returnUrl в запросе registerPreAuth.do). В результате операции Система Немо дополнительно направляет запрос getOrderStatusExtended для получения актуального статуса оплаты. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =1, процедура продолжается.
#Система Немо выполняет оформление заказа.
##Если оформление прошло успешно, Система Немо инициирует запрос deposit.do для завершения операции эквайринга на стороне Сервиса;
##Если оформление прошло неуспешно, Система Немо инициирует запрос reverse.do;
#Процедура оплаты завершена.

===Оплата без преавторизации===
#При инициировании оплаты Система Немо отправляет Запрос регистрации заказа register.do.
#Система Немо перенаправляет пользователя на url, который Сервис указал в ответе на запрос регистрации для совершения операции эквайринга на стороне Сервиса.
#Периодически Система Немо отправляет запрос getOrderStatusExtended.do для получения состояния заказа до тех пор, пока Сервис не укажет в качестве orderStatus 2 или 6 при нулевом значении errorCode. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =2, процедура продолжается.
#Параллельно с завершением транзакции Сервис переадресует клиента обратно на страницу заказа (returnUrl в запросе register.do). В результате операции Система Немо дополнительно направляет запрос getOrderStatusExtended для получения актуального статуса оплаты.
#Если orderStatus=2 и errorCode=0, Система Немо выполняет оформление заказа.

===Возврат средств===
Для возврата средств Система Немо направляет getOrderStatusExtended.do.
*Если полученный статус заказа orderStatus=1, то Система направляет запрос reverse.do,
*Если orderStatus=2, то Система направляет запрос refund.do.

==Формат запросов/ответов==

Универсальный API для подключения платежных шлюзов реализован с помощью HTTP запросов/ответов методом POST.

* register.do
<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderNumber, amount, returnUrl, currency, description, language, jsonParams
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
| returnUrl || Адрес, на который требуется перенаправить пользователя в случае успешной оплаты. Значение должно представлять собой абсолютную ссылку. || Пример: "http://test.com/universal_nemo_pay__after_authorisation?billing_id=111111111".
|-
| currency || Валюта || Код валюты платежа ISO 4217.
|-
| description || Описание заказа в свободной форме || Пример: "Оплата заказа №586578 (1X96WD) с сайта http://test.com".
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
| jsonParams || Блок для передачи дополнительных параметров мерчанта. || Пример данных передаваемых Немо: {"onlyMaestro":"false","email":"test@mutelab.com","phone":"79270099000"}
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: orderId, formUrl, errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| formUrl || URL платежной формы, на который надо перенаправить браузер клиента. || -
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* registerPreAuth.do
<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderNumber, amount, returnUrl, currency, description, language, jsonParams
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
| returnUrl || Адрес, на который требуется перенаправить пользователя в случае успешной оплаты. Значение должно представлять собой абсолютную ссылку. || Пример: "http://test.com/universal_nemo_pay__after_authorisation?billing_id=111111111".
|-
| currency || Валюта || Код валюты платежа ISO 4217.
|-
| description || Описание заказа в свободной форме || Пример: "Оплата заказа №586578 (1X96WD) с сайта http://test.com".
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
| jsonParams || Блок для передачи дополнительных параметров мерчанта. || Пример данных передаваемых Немо: {"onlyMaestro":"false","email":"test@mutelab.com","phone":"79270099000"}
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: orderId, formUrl, errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| formUrl || URL платежной формы, на который надо перенаправить браузер клиента. || -
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* deposit.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId, amount.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* reverse.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* refund.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* getOrderStatusExtended.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId, language, orderNumber.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage, orderStatus и cardAuthInfo(expiration, cardholderName, approvalCode, pan).
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
| orderStatus || Состояние заказа в платежной системе. ||
* 0 - Заказ зарегистрирован, но не оплачен
* 1 - Предавторизованная сумма захолдирована (для двухстадийных платежей)
* 2 - Проведена полная авторизация суммы заказа
* 6 - Авторизация отклонена
|-
| cardAuthInfo || Тэг с атрибутами платежа. ||
* expiration - Срок истечения действия карты в формате YYYYMM.
* cardholderName - Имя держателя карты.
* approvalCode - Код авторизации платежа. Поле фиксированной длины (6 символов), может содержать цифры и латинские буквы.
* pan - Маскированный номер карты, которая использовалась для оплаты.
|-
|}
</div></div>

=См.также=
[[Платежный шлюз]]

Интеграция сервиса приёма платежей с помощью Payment Gateway API

2020-04-07T16:30:56Z

Мария Горшенева: /* Особенности */

Payment Gateway API представляет собой протокол для подключения платежных шлюзов. Сервис позволяет с минимальными затратами времени и ресурсов подключить любой существующий платежный шлюз, используя единую схему подключения. Преимущество метода в том, что работы по разработке интеграции заказчик выполняет на своей стороне, а значит, самостоятельно планирует сроки интеграции и независимо управляет ресурсом.

=Порядок подключения модуля Payment Gateway API=

Модуль Payment Gateway API является дополнительным. Чтобы подключиться к Nemo.travel по данному протоколу, обратитесь в коммерческий отдел по адресу connect@nemo.travel

==Особенности==
Сервис не поддерживает фискализацию платежей по ФЗ 54.

==Настройка платёжного шлюза в {{NameSystem}}==

# В разделе '''Финансы и платежи → Платежные методы → Доступ с способам оплаты''' откройте доступ к способу оплаты для пользователей/групп/компаний
# В разделе '''Финансы и платежи → Платежные методы → Управление шлюзами''' создайте метод оплаты "UniversalNemoPay"
# Откройте раздел "Реквизиты" созданного платёжного метода и задайте настройки доступа к платёжному шлюзу:
#* ''URL клиентского сервера для запросов'' - адрес запросов для доступа к Сервису, например http://test.com/test
#* ''API логин'' - реквизит доступа к платёжному шлюзу, выдаётся платёжным шлюзом
#* ''Пароль'' - реквизит доступа к платёжному шлюзу, выдаётся платёжным шлюзом
#* ''Валюта'' - валюта по договору с платёжным шлюзом
#* ''Использовать двухстадийную оплату'' - если параметр включен, будет использована схема запросов с преавторизацией. Если выключен - схема запросов без преавторизации.
#* ''Разрешить оплату только картами Visa Electron и MasterCard Maestro''
#* ''Добавить локатор в начало идентификатора платежа при передаче в платежный шлюз'' - в orderNumber будет добавлен префикс с локатором.
#* ''Отображать фрэйм со страницей оплаты на странице информации о заказе '' - для оплаты во фрейме на странице заказа без перехода на странцу платёжного шлюза
#* ''Высота фрэйма со страницей оплаты'' - задайте высоту фрейма

=Техническая документация по интеграции с сервисом Payment Gateway API=

'''Используемые в разделе термины:'''
*''Система Немо'' - система бронирования Nemo Travel,
*''Сервис'' - сервис по приему платежей.

==Описание запросов==

{| class="wikitable"
! Название запроса !! Описание !! Особенности
|-
| register.do || Запрос регистрации заказа (без преавторизации)|| -
|-
| registerPreAuth.do || Запрос регистрации заказа c преавторизацией || -
|-
| deposit.do || Запрoс завершения oплаты заказа || -
|-
| reverse.do || Запрос отмены оплаты заказа || -
|-
| refund.do || Запрос возврата средств оплаты заказа || -
|-
| getOrderStatusExtended.do || Расширенный запрос состояния заказа || -
|-
|}

* Запросы, использующиеся при двухстадийной оплате (с преавторизацией): registerPreAuth.do, deposit.do.
* Запросы, использующиеся при одностадийной оплате (без преавторизации): register.do.
* Запросы reverse.do, refund.do и getOrderStatusExtended.do могут быть использованы при любой схеме оплаты.
* При необходимости возврата средств система Немо посылает запрос обновления заказа в платежный шлюз. Если полученный статус заказа - orderStatus=1, то посылается запрос reverse.do, если orderStatus=2, то посылается refund.do.

==Порядок взаимодействия Системы Немо и Сервиса==

===Оплата с преавторизацией===
#При инициировании оплаты Система Немо отправляет Запрос регистрации заказа registerPreAuth.do.
#Система Немо перенаправляет пользователя на url, который Сервис указал в ответе на запрос регистрации для совершения операции эквайринга на стороне Сервиса.
#Периодически Система Немо отправляет запрос getOrderStatusExtended.do для получения состояния заказа до тех пор, пока Сервис не укажет в качестве orderStatus 1 или 6 при нулевом значении errorCode. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =1, процедура продолжается.
#Параллельно с завершением транзакции Сервис переадресует клиента обратно на страницу заказа (returnUrl в запросе registerPreAuth.do). В результате операции Система Немо дополнительно направляет запрос getOrderStatusExtended для получения актуального статуса оплаты. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =1, процедура продолжается.
#Система Немо выполняет оформление заказа.
##Если оформление прошло успешно, Система Немо инициирует запрос deposit.do для завершения операции эквайринга на стороне Сервиса;
##Если оформление прошло неуспешно, Система Немо инициирует запрос reverse.do;
#Процедура оплаты завершена.

===Оплата без преавторизации===
#При инициировании оплаты Система Немо отправляет Запрос регистрации заказа register.do.
#Система Немо перенаправляет пользователя на url, который Сервис указал в ответе на запрос регистрации для совершения операции эквайринга на стороне Сервиса.
#Периодически Система Немо отправляет запрос getOrderStatusExtended.do для получения состояния заказа до тех пор, пока Сервис не укажет в качестве orderStatus 2 или 6 при нулевом значении errorCode. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =2, процедура продолжается.
#Параллельно с завершением транзакции Сервис переадресует клиента обратно на страницу заказа (returnUrl в запросе register.do). В результате операции Система Немо дополнительно направляет запрос getOrderStatusExtended для получения актуального статуса оплаты.
#Если orderStatus=2 и errorCode=0, Система Немо выполняет оформление заказа.

===Возврат средств===
Для возврата средств Система Немо направляет getOrderStatusExtended.do.
*Если полученный статус заказа orderStatus=1, то Система направляет запрос reverse.do,
*Если orderStatus=2, то Система направляет запрос refund.do.

==Формат запросов/ответов==

Универсальный API для подключения платежных шлюзов реализован с помощью HTTP запросов/ответов методом POST.

* register.do
<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderNumber, amount, returnUrl, currency, description, language, jsonParams
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
| returnUrl || Адрес, на который требуется перенаправить пользователя в случае успешной оплаты. Значение должно представлять собой абсолютную ссылку. || Пример: "http://test.com/universal_nemo_pay__after_authorisation?billing_id=111111111".
|-
| currency || Валюта || Код валюты платежа ISO 4217.
|-
| description || Описание заказа в свободной форме || Пример: "Оплата заказа №586578 (1X96WD) с сайта http://test.com".
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
| jsonParams || Блок для передачи дополнительных параметров мерчанта. || Пример данных передаваемых Немо: {"onlyMaestro":"false","email":"test@mutelab.com","phone":"79270099000"}
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: orderId, formUrl, errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| formUrl || URL платежной формы, на который надо перенаправить браузер клиента. || -
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* registerPreAuth.do
<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderNumber, amount, returnUrl, currency, description, language, jsonParams
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
| returnUrl || Адрес, на который требуется перенаправить пользователя в случае успешной оплаты. Значение должно представлять собой абсолютную ссылку. || Пример: "http://test.com/universal_nemo_pay__after_authorisation?billing_id=111111111".
|-
| currency || Валюта || Код валюты платежа ISO 4217.
|-
| description || Описание заказа в свободной форме || Пример: "Оплата заказа №586578 (1X96WD) с сайта http://test.com".
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
| jsonParams || Блок для передачи дополнительных параметров мерчанта. || Пример данных передаваемых Немо: {"onlyMaestro":"false","email":"test@mutelab.com","phone":"79270099000"}
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: orderId, formUrl, errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| formUrl || URL платежной формы, на который надо перенаправить браузер клиента. || -
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* deposit.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId, amount.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* reverse.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* refund.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* getOrderStatusExtended.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId, language, orderNumber.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage, orderStatus и cardAuthInfo(expiration, cardholderName, approvalCode, pan).
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
| orderStatus || Состояние заказа в платежной системе. ||
* 0 - Заказ зарегистрирован, но не оплачен
* 1 - Предавторизованная сумма захолдирована (для двухстадийных платежей)
* 2 - Проведена полная авторизация суммы заказа
* 6 - Авторизация отклонена
|-
| cardAuthInfo || Тэг с атрибутами платежа. ||
* expiration - Срок истечения действия карты в формате YYYYMM.
* cardholderName - Имя держателя карты.
* approvalCode - Код авторизации платежа. Поле фиксированной длины (6 символов), может содержать цифры и латинские буквы.
* pan - Маскированный номер карты, которая использовалась для оплаты.
|-
|}
</div></div>

=См.также=
[[Платежный шлюз]]

Интеграция сервиса приёма платежей с помощью Payment Gateway API

2020-04-07T16:29:53Z

Мария Горшенева:

Payment Gateway API представляет собой протокол для подключения платежных шлюзов. Сервис позволяет с минимальными затратами времени и ресурсов подключить любой существующий платежный шлюз, используя единую схему подключения. Преимущество метода в том, что работы по разработке интеграции заказчик выполняет на своей стороне, а значит, самостоятельно планирует сроки интеграции и независимо управляет ресурсом.

=Порядок подключения модуля Payment Gateway API=

Модуль Payment Gateway API является дополнительным. Чтобы подключиться к Nemo.travel по данному протоколу, обратитесь в коммерческий отдел по адресу connect@nemo.travel

==Особенности==
Сервис не поддерживает фискализацию платежей.

==Настройка платёжного шлюза в {{NameSystem}}==

# В разделе '''Финансы и платежи → Платежные методы → Доступ с способам оплаты''' откройте доступ к способу оплаты для пользователей/групп/компаний
# В разделе '''Финансы и платежи → Платежные методы → Управление шлюзами''' создайте метод оплаты "UniversalNemoPay"
# Откройте раздел "Реквизиты" созданного платёжного метода и задайте настройки доступа к платёжному шлюзу:
#* ''URL клиентского сервера для запросов'' - адрес запросов для доступа к Сервису, например http://test.com/test
#* ''API логин'' - реквизит доступа к платёжному шлюзу, выдаётся платёжным шлюзом
#* ''Пароль'' - реквизит доступа к платёжному шлюзу, выдаётся платёжным шлюзом
#* ''Валюта'' - валюта по договору с платёжным шлюзом
#* ''Использовать двухстадийную оплату'' - если параметр включен, будет использована схема запросов с преавторизацией. Если выключен - схема запросов без преавторизации.
#* ''Разрешить оплату только картами Visa Electron и MasterCard Maestro''
#* ''Добавить локатор в начало идентификатора платежа при передаче в платежный шлюз'' - в orderNumber будет добавлен префикс с локатором.
#* ''Отображать фрэйм со страницей оплаты на странице информации о заказе '' - для оплаты во фрейме на странице заказа без перехода на странцу платёжного шлюза
#* ''Высота фрэйма со страницей оплаты'' - задайте высоту фрейма

=Техническая документация по интеграции с сервисом Payment Gateway API=

'''Используемые в разделе термины:'''
*''Система Немо'' - система бронирования Nemo Travel,
*''Сервис'' - сервис по приему платежей.

==Описание запросов==

{| class="wikitable"
! Название запроса !! Описание !! Особенности
|-
| register.do || Запрос регистрации заказа (без преавторизации)|| -
|-
| registerPreAuth.do || Запрос регистрации заказа c преавторизацией || -
|-
| deposit.do || Запрoс завершения oплаты заказа || -
|-
| reverse.do || Запрос отмены оплаты заказа || -
|-
| refund.do || Запрос возврата средств оплаты заказа || -
|-
| getOrderStatusExtended.do || Расширенный запрос состояния заказа || -
|-
|}

* Запросы, использующиеся при двухстадийной оплате (с преавторизацией): registerPreAuth.do, deposit.do.
* Запросы, использующиеся при одностадийной оплате (без преавторизации): register.do.
* Запросы reverse.do, refund.do и getOrderStatusExtended.do могут быть использованы при любой схеме оплаты.
* При необходимости возврата средств система Немо посылает запрос обновления заказа в платежный шлюз. Если полученный статус заказа - orderStatus=1, то посылается запрос reverse.do, если orderStatus=2, то посылается refund.do.

==Порядок взаимодействия Системы Немо и Сервиса==

===Оплата с преавторизацией===
#При инициировании оплаты Система Немо отправляет Запрос регистрации заказа registerPreAuth.do.
#Система Немо перенаправляет пользователя на url, который Сервис указал в ответе на запрос регистрации для совершения операции эквайринга на стороне Сервиса.
#Периодически Система Немо отправляет запрос getOrderStatusExtended.do для получения состояния заказа до тех пор, пока Сервис не укажет в качестве orderStatus 1 или 6 при нулевом значении errorCode. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =1, процедура продолжается.
#Параллельно с завершением транзакции Сервис переадресует клиента обратно на страницу заказа (returnUrl в запросе registerPreAuth.do). В результате операции Система Немо дополнительно направляет запрос getOrderStatusExtended для получения актуального статуса оплаты. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =1, процедура продолжается.
#Система Немо выполняет оформление заказа.
##Если оформление прошло успешно, Система Немо инициирует запрос deposit.do для завершения операции эквайринга на стороне Сервиса;
##Если оформление прошло неуспешно, Система Немо инициирует запрос reverse.do;
#Процедура оплаты завершена.

===Оплата без преавторизации===
#При инициировании оплаты Система Немо отправляет Запрос регистрации заказа register.do.
#Система Немо перенаправляет пользователя на url, который Сервис указал в ответе на запрос регистрации для совершения операции эквайринга на стороне Сервиса.
#Периодически Система Немо отправляет запрос getOrderStatusExtended.do для получения состояния заказа до тех пор, пока Сервис не укажет в качестве orderStatus 2 или 6 при нулевом значении errorCode. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =2, процедура продолжается.
#Параллельно с завершением транзакции Сервис переадресует клиента обратно на страницу заказа (returnUrl в запросе register.do). В результате операции Система Немо дополнительно направляет запрос getOrderStatusExtended для получения актуального статуса оплаты.
#Если orderStatus=2 и errorCode=0, Система Немо выполняет оформление заказа.

===Возврат средств===
Для возврата средств Система Немо направляет getOrderStatusExtended.do.
*Если полученный статус заказа orderStatus=1, то Система направляет запрос reverse.do,
*Если orderStatus=2, то Система направляет запрос refund.do.

==Формат запросов/ответов==

Универсальный API для подключения платежных шлюзов реализован с помощью HTTP запросов/ответов методом POST.

* register.do
<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderNumber, amount, returnUrl, currency, description, language, jsonParams
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
| returnUrl || Адрес, на который требуется перенаправить пользователя в случае успешной оплаты. Значение должно представлять собой абсолютную ссылку. || Пример: "http://test.com/universal_nemo_pay__after_authorisation?billing_id=111111111".
|-
| currency || Валюта || Код валюты платежа ISO 4217.
|-
| description || Описание заказа в свободной форме || Пример: "Оплата заказа №586578 (1X96WD) с сайта http://test.com".
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
| jsonParams || Блок для передачи дополнительных параметров мерчанта. || Пример данных передаваемых Немо: {"onlyMaestro":"false","email":"test@mutelab.com","phone":"79270099000"}
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: orderId, formUrl, errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| formUrl || URL платежной формы, на который надо перенаправить браузер клиента. || -
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* registerPreAuth.do
<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderNumber, amount, returnUrl, currency, description, language, jsonParams
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
| returnUrl || Адрес, на который требуется перенаправить пользователя в случае успешной оплаты. Значение должно представлять собой абсолютную ссылку. || Пример: "http://test.com/universal_nemo_pay__after_authorisation?billing_id=111111111".
|-
| currency || Валюта || Код валюты платежа ISO 4217.
|-
| description || Описание заказа в свободной форме || Пример: "Оплата заказа №586578 (1X96WD) с сайта http://test.com".
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
| jsonParams || Блок для передачи дополнительных параметров мерчанта. || Пример данных передаваемых Немо: {"onlyMaestro":"false","email":"test@mutelab.com","phone":"79270099000"}
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: orderId, formUrl, errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| formUrl || URL платежной формы, на который надо перенаправить браузер клиента. || -
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* deposit.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId, amount.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* reverse.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* refund.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* getOrderStatusExtended.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId, language, orderNumber.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage, orderStatus и cardAuthInfo(expiration, cardholderName, approvalCode, pan).
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
| orderStatus || Состояние заказа в платежной системе. ||
* 0 - Заказ зарегистрирован, но не оплачен
* 1 - Предавторизованная сумма захолдирована (для двухстадийных платежей)
* 2 - Проведена полная авторизация суммы заказа
* 6 - Авторизация отклонена
|-
| cardAuthInfo || Тэг с атрибутами платежа. ||
* expiration - Срок истечения действия карты в формате YYYYMM.
* cardholderName - Имя держателя карты.
* approvalCode - Код авторизации платежа. Поле фиксированной длины (6 символов), может содержать цифры и латинские буквы.
* pan - Маскированный номер карты, которая использовалась для оплаты.
|-
|}
</div></div>

=См.также=
[[Платежный шлюз]]

Интеграция сервиса приёма платежей с помощью Payment Gateway API

2020-04-07T16:26:01Z

Мария Горшенева:

Payment Gateway API представляет собой протокол для подключения платежных шлюзов. Сервис позволяет с минимальными затратами времени и ресурсов подключить любой существующий платежный шлюз, используя единую схему подключения.

=Порядок подключения модуля Payment Gateway API=

Модуль Payment Gateway API является дополнительным. Чтобы подключиться к Nemo.travel по данному протоколу, обратитесь в коммерческий отдел по адресу connect@nemo.travel

==Особенности==
Сервис не поддерживает фискализацию платежей.

==Настройка платёжного шлюза в {{NameSystem}}==

# В разделе '''Финансы и платежи → Платежные методы → Доступ с способам оплаты''' откройте доступ к способу оплаты для пользователей/групп/компаний
# В разделе '''Финансы и платежи → Платежные методы → Управление шлюзами''' создайте метод оплаты "UniversalNemoPay"
# Откройте раздел "Реквизиты" созданного платёжного метода и задайте настройки доступа к платёжному шлюзу:
#* ''URL клиентского сервера для запросов'' - адрес запросов для доступа к Сервису, например http://test.com/test
#* ''API логин'' - реквизит доступа к платёжному шлюзу, выдаётся платёжным шлюзом
#* ''Пароль'' - реквизит доступа к платёжному шлюзу, выдаётся платёжным шлюзом
#* ''Валюта'' - валюта по договору с платёжным шлюзом
#* ''Использовать двухстадийную оплату'' - если параметр включен, будет использована схема запросов с преавторизацией. Если выключен - схема запросов без преавторизации.
#* ''Разрешить оплату только картами Visa Electron и MasterCard Maestro''
#* ''Добавить локатор в начало идентификатора платежа при передаче в платежный шлюз'' - в orderNumber будет добавлен префикс с локатором.
#* ''Отображать фрэйм со страницей оплаты на странице информации о заказе '' - для оплаты во фрейме на странице заказа без перехода на странцу платёжного шлюза
#* ''Высота фрэйма со страницей оплаты'' - задайте высоту фрейма

=Техническая документация по интеграции с сервисом Payment Gateway API=

'''Используемые в разделе термины:'''
*''Система Немо'' - система бронирования Nemo Travel,
*''Сервис'' - сервис по приему платежей.

==Описание запросов==

{| class="wikitable"
! Название запроса !! Описание !! Особенности
|-
| register.do || Запрос регистрации заказа (без преавторизации)|| -
|-
| registerPreAuth.do || Запрос регистрации заказа c преавторизацией || -
|-
| deposit.do || Запрoс завершения oплаты заказа || -
|-
| reverse.do || Запрос отмены оплаты заказа || -
|-
| refund.do || Запрос возврата средств оплаты заказа || -
|-
| getOrderStatusExtended.do || Расширенный запрос состояния заказа || -
|-
|}

* Запросы, использующиеся при двухстадийной оплате (с преавторизацией): registerPreAuth.do, deposit.do.
* Запросы, использующиеся при одностадийной оплате (без преавторизации): register.do.
* Запросы reverse.do, refund.do и getOrderStatusExtended.do могут быть использованы при любой схеме оплаты.
* При необходимости возврата средств система Немо посылает запрос обновления заказа в платежный шлюз. Если полученный статус заказа - orderStatus=1, то посылается запрос reverse.do, если orderStatus=2, то посылается refund.do.

==Порядок взаимодействия Системы Немо и Сервиса==

===Оплата с преавторизацией===
#При инициировании оплаты Система Немо отправляет Запрос регистрации заказа registerPreAuth.do.
#Система Немо перенаправляет пользователя на url, который Сервис указал в ответе на запрос регистрации для совершения операции эквайринга на стороне Сервиса.
#Периодически Система Немо отправляет запрос getOrderStatusExtended.do для получения состояния заказа до тех пор, пока Сервис не укажет в качестве orderStatus 1 или 6 при нулевом значении errorCode. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =1, процедура продолжается.
#Параллельно с завершением транзакции Сервис переадресует клиента обратно на страницу заказа (returnUrl в запросе registerPreAuth.do). В результате операции Система Немо дополнительно направляет запрос getOrderStatusExtended для получения актуального статуса оплаты. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =1, процедура продолжается.
#Система Немо выполняет оформление заказа.
##Если оформление прошло успешно, Система Немо инициирует запрос deposit.do для завершения операции эквайринга на стороне Сервиса;
##Если оформление прошло неуспешно, Система Немо инициирует запрос reverse.do;
#Процедура оплаты завершена.

===Оплата без преавторизации===
#При инициировании оплаты Система Немо отправляет Запрос регистрации заказа register.do.
#Система Немо перенаправляет пользователя на url, который Сервис указал в ответе на запрос регистрации для совершения операции эквайринга на стороне Сервиса.
#Периодически Система Немо отправляет запрос getOrderStatusExtended.do для получения состояния заказа до тех пор, пока Сервис не укажет в качестве orderStatus 2 или 6 при нулевом значении errorCode. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =2, процедура продолжается.
#Параллельно с завершением транзакции Сервис переадресует клиента обратно на страницу заказа (returnUrl в запросе register.do). В результате операции Система Немо дополнительно направляет запрос getOrderStatusExtended для получения актуального статуса оплаты.
#Если orderStatus=2 и errorCode=0, Система Немо выполняет оформление заказа.

===Возврат средств===
Для возврата средств Система Немо направляет getOrderStatusExtended.do.
*Если полученный статус заказа orderStatus=1, то Система направляет запрос reverse.do,
*Если orderStatus=2, то Система направляет запрос refund.do.

==Формат запросов/ответов==

Универсальный API для подключения платежных шлюзов реализован с помощью HTTP запросов/ответов методом POST.

* register.do
<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderNumber, amount, returnUrl, currency, description, language, jsonParams
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
| returnUrl || Адрес, на который требуется перенаправить пользователя в случае успешной оплаты. Значение должно представлять собой абсолютную ссылку. || Пример: "http://test.com/universal_nemo_pay__after_authorisation?billing_id=111111111".
|-
| currency || Валюта || Код валюты платежа ISO 4217.
|-
| description || Описание заказа в свободной форме || Пример: "Оплата заказа №586578 (1X96WD) с сайта http://test.com".
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
| jsonParams || Блок для передачи дополнительных параметров мерчанта. || Пример данных передаваемых Немо: {"onlyMaestro":"false","email":"test@mutelab.com","phone":"79270099000"}
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: orderId, formUrl, errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| formUrl || URL платежной формы, на который надо перенаправить браузер клиента. || -
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* registerPreAuth.do
<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderNumber, amount, returnUrl, currency, description, language, jsonParams
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
| returnUrl || Адрес, на который требуется перенаправить пользователя в случае успешной оплаты. Значение должно представлять собой абсолютную ссылку. || Пример: "http://test.com/universal_nemo_pay__after_authorisation?billing_id=111111111".
|-
| currency || Валюта || Код валюты платежа ISO 4217.
|-
| description || Описание заказа в свободной форме || Пример: "Оплата заказа №586578 (1X96WD) с сайта http://test.com".
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
| jsonParams || Блок для передачи дополнительных параметров мерчанта. || Пример данных передаваемых Немо: {"onlyMaestro":"false","email":"test@mutelab.com","phone":"79270099000"}
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: orderId, formUrl, errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| formUrl || URL платежной формы, на который надо перенаправить браузер клиента. || -
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* deposit.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId, amount.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* reverse.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* refund.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* getOrderStatusExtended.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId, language, orderNumber.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage, orderStatus и cardAuthInfo(expiration, cardholderName, approvalCode, pan).
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
| orderStatus || Состояние заказа в платежной системе. ||
* 0 - Заказ зарегистрирован, но не оплачен
* 1 - Предавторизованная сумма захолдирована (для двухстадийных платежей)
* 2 - Проведена полная авторизация суммы заказа
* 6 - Авторизация отклонена
|-
| cardAuthInfo || Тэг с атрибутами платежа. ||
* expiration - Срок истечения действия карты в формате YYYYMM.
* cardholderName - Имя держателя карты.
* approvalCode - Код авторизации платежа. Поле фиксированной длины (6 символов), может содержать цифры и латинские буквы.
* pan - Маскированный номер карты, которая использовалась для оплаты.
|-
|}
</div></div>

=См.также=
[[Платежный шлюз]]

Интеграция сервиса приёма платежей с помощью Payment Gateway API

2020-04-07T16:23:42Z

Мария Горшенева: /* Возврат средств */

PAYMENT GATEWAY API представляет собой протокол для подключения платежных шлюзов. Сервис позволяет с минимальными затратами времени и ресурсов подключить любой существующий платежный шлюз, используя единую схему подключения.

=Порядок подключения модуля PAYMENT GATEWAY API=

Модуль PAYMENT GATEWAY API является дополнительным. Чтобы подключиться к Nemo.travel по данному протоколу, обратитесь в коммерческий отдел по адресу connect@nemo.travel

==Особенности==
Сервис не поддерживает фискализацию платежей.

==Настройка платёжного шлюза в {{NameSystem}}==

# В разделе '''Финансы и платежи → Платежные методы → Доступ с способам оплаты''' откройте доступ к способу оплаты для пользователей/групп/компаний
# В разделе '''Финансы и платежи → Платежные методы → Управление шлюзами''' создайте метод оплаты "UniversalNemoPay"
# Откройте раздел "Реквизиты" созданного платёжного метода и задайте настройки доступа к платёжному шлюзу:
#* ''URL клиентского сервера для запросов'' - адрес запросов для доступа к Сервису, например http://test.com/test
#* ''API логин'' - реквизит доступа к платёжному шлюзу, выдаётся платёжным шлюзом
#* ''Пароль'' - реквизит доступа к платёжному шлюзу, выдаётся платёжным шлюзом
#* ''Валюта'' - валюта по договору с платёжным шлюзом
#* ''Использовать двухстадийную оплату'' - если параметр включен, будет использована схема запросов с преавторизацией. Если выключен - схема запросов без преавторизации.
#* ''Разрешить оплату только картами Visa Electron и MasterCard Maestro''
#* ''Добавить локатор в начало идентификатора платежа при передаче в платежный шлюз'' - в orderNumber будет добавлен префикс с локатором.
#* ''Отображать фрэйм со страницей оплаты на странице информации о заказе '' - для оплаты во фрейме на странице заказа без перехода на странцу платёжного шлюза
#* ''Высота фрэйма со страницей оплаты'' - задайте высоту фрейма

=Техническая документация по интеграции с сервисом PAYMENT GATEWAY API=

'''Используемые в разделе термины:'''
*''Система Немо'' - система бронирования Nemo Travel,
*''Сервис'' - сервис по приему платежей.

==Описание запросов==

{| class="wikitable"
! Название запроса !! Описание !! Особенности
|-
| register.do || Запрос регистрации заказа (без преавторизации)|| -
|-
| registerPreAuth.do || Запрос регистрации заказа c преавторизацией || -
|-
| deposit.do || Запрoс завершения oплаты заказа || -
|-
| reverse.do || Запрос отмены оплаты заказа || -
|-
| refund.do || Запрос возврата средств оплаты заказа || -
|-
| getOrderStatusExtended.do || Расширенный запрос состояния заказа || -
|-
|}

* Запросы, использующиеся при двухстадийной оплате (с преавторизацией): registerPreAuth.do, deposit.do.
* Запросы, использующиеся при одностадийной оплате (без преавторизации): register.do.
* Запросы reverse.do, refund.do и getOrderStatusExtended.do могут быть использованы при любой схеме оплаты.
* При необходимости возврата средств система Немо посылает запрос обновления заказа в платежный шлюз. Если полученный статус заказа - orderStatus=1, то посылается запрос reverse.do, если orderStatus=2, то посылается refund.do.

==Порядок взаимодействия Системы Немо и Сервиса==

===Оплата с преавторизацией===
#При инициировании оплаты Система Немо отправляет Запрос регистрации заказа registerPreAuth.do.
#Система Немо перенаправляет пользователя на url, который Сервис указал в ответе на запрос регистрации для совершения операции эквайринга на стороне Сервиса.
#Периодически Система Немо отправляет запрос getOrderStatusExtended.do для получения состояния заказа до тех пор, пока Сервис не укажет в качестве orderStatus 1 или 6 при нулевом значении errorCode. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =1, процедура продолжается.
#Параллельно с завершением транзакции Сервис переадресует клиента обратно на страницу заказа (returnUrl в запросе registerPreAuth.do). В результате операции Система Немо дополнительно направляет запрос getOrderStatusExtended для получения актуального статуса оплаты. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =1, процедура продолжается.
#Система Немо выполняет оформление заказа.
##Если оформление прошло успешно, Система Немо инициирует запрос deposit.do для завершения операции эквайринга на стороне Сервиса;
##Если оформление прошло неуспешно, Система Немо инициирует запрос reverse.do;
#Процедура оплаты завершена.

===Оплата без преавторизации===
#При инициировании оплаты Система Немо отправляет Запрос регистрации заказа register.do.
#Система Немо перенаправляет пользователя на url, который Сервис указал в ответе на запрос регистрации для совершения операции эквайринга на стороне Сервиса.
#Периодически Система Немо отправляет запрос getOrderStatusExtended.do для получения состояния заказа до тех пор, пока Сервис не укажет в качестве orderStatus 2 или 6 при нулевом значении errorCode. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =2, процедура продолжается.
#Параллельно с завершением транзакции Сервис переадресует клиента обратно на страницу заказа (returnUrl в запросе register.do). В результате операции Система Немо дополнительно направляет запрос getOrderStatusExtended для получения актуального статуса оплаты.
#Если orderStatus=2 и errorCode=0, Система Немо выполняет оформление заказа.

===Возврат средств===
Для возврата средств Система Немо направляет getOrderStatusExtended.do.
*Если полученный статус заказа orderStatus=1, то Система направляет запрос reverse.do,
*Если orderStatus=2, то Система направляет запрос refund.do.

==Формат запросов/ответов==

Универсальный API для подключения платежных шлюзов реализован с помощью HTTP запросов/ответов методом POST.

* register.do
<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderNumber, amount, returnUrl, currency, description, language, jsonParams
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
| returnUrl || Адрес, на который требуется перенаправить пользователя в случае успешной оплаты. Значение должно представлять собой абсолютную ссылку. || Пример: "http://test.com/universal_nemo_pay__after_authorisation?billing_id=111111111".
|-
| currency || Валюта || Код валюты платежа ISO 4217.
|-
| description || Описание заказа в свободной форме || Пример: "Оплата заказа №586578 (1X96WD) с сайта http://test.com".
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
| jsonParams || Блок для передачи дополнительных параметров мерчанта. || Пример данных передаваемых Немо: {"onlyMaestro":"false","email":"test@mutelab.com","phone":"79270099000"}
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: orderId, formUrl, errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| formUrl || URL платежной формы, на который надо перенаправить браузер клиента. || -
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* registerPreAuth.do
<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderNumber, amount, returnUrl, currency, description, language, jsonParams
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
| returnUrl || Адрес, на который требуется перенаправить пользователя в случае успешной оплаты. Значение должно представлять собой абсолютную ссылку. || Пример: "http://test.com/universal_nemo_pay__after_authorisation?billing_id=111111111".
|-
| currency || Валюта || Код валюты платежа ISO 4217.
|-
| description || Описание заказа в свободной форме || Пример: "Оплата заказа №586578 (1X96WD) с сайта http://test.com".
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
| jsonParams || Блок для передачи дополнительных параметров мерчанта. || Пример данных передаваемых Немо: {"onlyMaestro":"false","email":"test@mutelab.com","phone":"79270099000"}
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: orderId, formUrl, errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| formUrl || URL платежной формы, на который надо перенаправить браузер клиента. || -
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* deposit.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId, amount.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* reverse.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* refund.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* getOrderStatusExtended.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId, language, orderNumber.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage, orderStatus и cardAuthInfo(expiration, cardholderName, approvalCode, pan).
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
| orderStatus || Состояние заказа в платежной системе. ||
* 0 - Заказ зарегистрирован, но не оплачен
* 1 - Предавторизованная сумма захолдирована (для двухстадийных платежей)
* 2 - Проведена полная авторизация суммы заказа
* 6 - Авторизация отклонена
|-
| cardAuthInfo || Тэг с атрибутами платежа. ||
* expiration - Срок истечения действия карты в формате YYYYMM.
* cardholderName - Имя держателя карты.
* approvalCode - Код авторизации платежа. Поле фиксированной длины (6 символов), может содержать цифры и латинские буквы.
* pan - Маскированный номер карты, которая использовалась для оплаты.
|-
|}
</div></div>

=См.также=
[[Платежный шлюз]]

Интеграция сервиса приёма платежей с помощью Payment Gateway API

2020-04-07T16:23:04Z

Мария Горшенева:

PAYMENT GATEWAY API представляет собой протокол для подключения платежных шлюзов. Сервис позволяет с минимальными затратами времени и ресурсов подключить любой существующий платежный шлюз, используя единую схему подключения.

=Порядок подключения модуля PAYMENT GATEWAY API=

Модуль PAYMENT GATEWAY API является дополнительным. Чтобы подключиться к Nemo.travel по данному протоколу, обратитесь в коммерческий отдел по адресу connect@nemo.travel

==Особенности==
Сервис не поддерживает фискализацию платежей.

==Настройка платёжного шлюза в {{NameSystem}}==

# В разделе '''Финансы и платежи → Платежные методы → Доступ с способам оплаты''' откройте доступ к способу оплаты для пользователей/групп/компаний
# В разделе '''Финансы и платежи → Платежные методы → Управление шлюзами''' создайте метод оплаты "UniversalNemoPay"
# Откройте раздел "Реквизиты" созданного платёжного метода и задайте настройки доступа к платёжному шлюзу:
#* ''URL клиентского сервера для запросов'' - адрес запросов для доступа к Сервису, например http://test.com/test
#* ''API логин'' - реквизит доступа к платёжному шлюзу, выдаётся платёжным шлюзом
#* ''Пароль'' - реквизит доступа к платёжному шлюзу, выдаётся платёжным шлюзом
#* ''Валюта'' - валюта по договору с платёжным шлюзом
#* ''Использовать двухстадийную оплату'' - если параметр включен, будет использована схема запросов с преавторизацией. Если выключен - схема запросов без преавторизации.
#* ''Разрешить оплату только картами Visa Electron и MasterCard Maestro''
#* ''Добавить локатор в начало идентификатора платежа при передаче в платежный шлюз'' - в orderNumber будет добавлен префикс с локатором.
#* ''Отображать фрэйм со страницей оплаты на странице информации о заказе '' - для оплаты во фрейме на странице заказа без перехода на странцу платёжного шлюза
#* ''Высота фрэйма со страницей оплаты'' - задайте высоту фрейма

=Техническая документация по интеграции с сервисом PAYMENT GATEWAY API=

'''Используемые в разделе термины:'''
*''Система Немо'' - система бронирования Nemo Travel,
*''Сервис'' - сервис по приему платежей.

==Описание запросов==

{| class="wikitable"
! Название запроса !! Описание !! Особенности
|-
| register.do || Запрос регистрации заказа (без преавторизации)|| -
|-
| registerPreAuth.do || Запрос регистрации заказа c преавторизацией || -
|-
| deposit.do || Запрoс завершения oплаты заказа || -
|-
| reverse.do || Запрос отмены оплаты заказа || -
|-
| refund.do || Запрос возврата средств оплаты заказа || -
|-
| getOrderStatusExtended.do || Расширенный запрос состояния заказа || -
|-
|}

* Запросы, использующиеся при двухстадийной оплате (с преавторизацией): registerPreAuth.do, deposit.do.
* Запросы, использующиеся при одностадийной оплате (без преавторизации): register.do.
* Запросы reverse.do, refund.do и getOrderStatusExtended.do могут быть использованы при любой схеме оплаты.
* При необходимости возврата средств система Немо посылает запрос обновления заказа в платежный шлюз. Если полученный статус заказа - orderStatus=1, то посылается запрос reverse.do, если orderStatus=2, то посылается refund.do.

==Порядок взаимодействия Системы Немо и Сервиса==

===Оплата с преавторизацией===
#При инициировании оплаты Система Немо отправляет Запрос регистрации заказа registerPreAuth.do.
#Система Немо перенаправляет пользователя на url, который Сервис указал в ответе на запрос регистрации для совершения операции эквайринга на стороне Сервиса.
#Периодически Система Немо отправляет запрос getOrderStatusExtended.do для получения состояния заказа до тех пор, пока Сервис не укажет в качестве orderStatus 1 или 6 при нулевом значении errorCode. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =1, процедура продолжается.
#Параллельно с завершением транзакции Сервис переадресует клиента обратно на страницу заказа (returnUrl в запросе registerPreAuth.do). В результате операции Система Немо дополнительно направляет запрос getOrderStatusExtended для получения актуального статуса оплаты. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =1, процедура продолжается.
#Система Немо выполняет оформление заказа.
##Если оформление прошло успешно, Система Немо инициирует запрос deposit.do для завершения операции эквайринга на стороне Сервиса;
##Если оформление прошло неуспешно, Система Немо инициирует запрос reverse.do;
#Процедура оплаты завершена.

===Оплата без преавторизации===
#При инициировании оплаты Система Немо отправляет Запрос регистрации заказа register.do.
#Система Немо перенаправляет пользователя на url, который Сервис указал в ответе на запрос регистрации для совершения операции эквайринга на стороне Сервиса.
#Периодически Система Немо отправляет запрос getOrderStatusExtended.do для получения состояния заказа до тех пор, пока Сервис не укажет в качестве orderStatus 2 или 6 при нулевом значении errorCode. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =2, процедура продолжается.
#Параллельно с завершением транзакции Сервис переадресует клиента обратно на страницу заказа (returnUrl в запросе register.do). В результате операции Система Немо дополнительно направляет запрос getOrderStatusExtended для получения актуального статуса оплаты.
#Если orderStatus=2 и errorCode=0, Система Немо выполняет оформление заказа.

===Возврат средств===
Для возврата средств Система Немо направляет getOrderStatusExtended.do.
*Если полученный статус заказа orderStatus=1, то посылается запрос reverse.do,
*Если orderStatus=2, то посылается refund.do.

==Формат запросов/ответов==

Универсальный API для подключения платежных шлюзов реализован с помощью HTTP запросов/ответов методом POST.

* register.do
<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderNumber, amount, returnUrl, currency, description, language, jsonParams
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
| returnUrl || Адрес, на который требуется перенаправить пользователя в случае успешной оплаты. Значение должно представлять собой абсолютную ссылку. || Пример: "http://test.com/universal_nemo_pay__after_authorisation?billing_id=111111111".
|-
| currency || Валюта || Код валюты платежа ISO 4217.
|-
| description || Описание заказа в свободной форме || Пример: "Оплата заказа №586578 (1X96WD) с сайта http://test.com".
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
| jsonParams || Блок для передачи дополнительных параметров мерчанта. || Пример данных передаваемых Немо: {"onlyMaestro":"false","email":"test@mutelab.com","phone":"79270099000"}
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: orderId, formUrl, errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| formUrl || URL платежной формы, на который надо перенаправить браузер клиента. || -
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* registerPreAuth.do
<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderNumber, amount, returnUrl, currency, description, language, jsonParams
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
| returnUrl || Адрес, на который требуется перенаправить пользователя в случае успешной оплаты. Значение должно представлять собой абсолютную ссылку. || Пример: "http://test.com/universal_nemo_pay__after_authorisation?billing_id=111111111".
|-
| currency || Валюта || Код валюты платежа ISO 4217.
|-
| description || Описание заказа в свободной форме || Пример: "Оплата заказа №586578 (1X96WD) с сайта http://test.com".
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
| jsonParams || Блок для передачи дополнительных параметров мерчанта. || Пример данных передаваемых Немо: {"onlyMaestro":"false","email":"test@mutelab.com","phone":"79270099000"}
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: orderId, formUrl, errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| formUrl || URL платежной формы, на который надо перенаправить браузер клиента. || -
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* deposit.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId, amount.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* reverse.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* refund.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* getOrderStatusExtended.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId, language, orderNumber.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage, orderStatus и cardAuthInfo(expiration, cardholderName, approvalCode, pan).
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
| orderStatus || Состояние заказа в платежной системе. ||
* 0 - Заказ зарегистрирован, но не оплачен
* 1 - Предавторизованная сумма захолдирована (для двухстадийных платежей)
* 2 - Проведена полная авторизация суммы заказа
* 6 - Авторизация отклонена
|-
| cardAuthInfo || Тэг с атрибутами платежа. ||
* expiration - Срок истечения действия карты в формате YYYYMM.
* cardholderName - Имя держателя карты.
* approvalCode - Код авторизации платежа. Поле фиксированной длины (6 символов), может содержать цифры и латинские буквы.
* pan - Маскированный номер карты, которая использовалась для оплаты.
|-
|}
</div></div>

=См.также=
[[Платежный шлюз]]

Интеграция сервиса приёма платежей с помощью Payment Gateway API

2020-04-07T16:21:41Z

Мария Горшенева: Мария Горшенева переименовал страницу Универсальный API для подключения платежных шлюзов в [[Интеграция сервиса приёма платежей с помо…

Универсальный API для подключения платежных шлюзов обеспечивает единый протокол, с помощью которого вы можете с минимальными затратами времени и ресурсов подключить любой существующий платежный шлюз, используя одну универсальную схему подключения.

=Порядок подключения модуля PAYMENT GATEWAY API=

Модуль PAYMENT GATEWAY API является дополнительным. Чтобы подключиться к Nemo.travel по данному протоколу, обратитесь в коммерческий отдел по адресу connect@nemo.travel

==Особенности==
Сервис не поддерживает фискализацию платежей.

==Настройка платёжного шлюза в {{NameSystem}}==

# В разделе '''Финансы и платежи → Платежные методы → Доступ с способам оплаты''' откройте доступ к способу оплаты для пользователей/групп/компаний
# В разделе '''Финансы и платежи → Платежные методы → Управление шлюзами''' создайте метод оплаты "UniversalNemoPay"
# Откройте раздел "Реквизиты" созданного платёжного метода и задайте настройки доступа к платёжному шлюзу:
#* ''URL клиентского сервера для запросов'' - адрес запросов для доступа к Сервису, например http://test.com/test
#* ''API логин'' - реквизит доступа к платёжному шлюзу, выдаётся платёжным шлюзом
#* ''Пароль'' - реквизит доступа к платёжному шлюзу, выдаётся платёжным шлюзом
#* ''Валюта'' - валюта по договору с платёжным шлюзом
#* ''Использовать двухстадийную оплату'' - если параметр включен, будет использована схема запросов с преавторизацией. Если выключен - схема запросов без преавторизации.
#* ''Разрешить оплату только картами Visa Electron и MasterCard Maestro''
#* ''Добавить локатор в начало идентификатора платежа при передаче в платежный шлюз'' - в orderNumber будет добавлен префикс с локатором.
#* ''Отображать фрэйм со страницей оплаты на странице информации о заказе '' - для оплаты во фрейме на странице заказа без перехода на странцу платёжного шлюза
#* ''Высота фрэйма со страницей оплаты'' - задайте высоту фрейма

=Техническая документация по интеграции с сервисом PAYMENT GATEWAY API=

'''Используемые в разделе термины:'''
*''Система Немо'' - система бронирования Nemo Travel,
*''Сервис'' - сервис по приему платежей.

==Описание запросов==

{| class="wikitable"
! Название запроса !! Описание !! Особенности
|-
| register.do || Запрос регистрации заказа (без преавторизации)|| -
|-
| registerPreAuth.do || Запрос регистрации заказа c преавторизацией || -
|-
| deposit.do || Запрoс завершения oплаты заказа || -
|-
| reverse.do || Запрос отмены оплаты заказа || -
|-
| refund.do || Запрос возврата средств оплаты заказа || -
|-
| getOrderStatusExtended.do || Расширенный запрос состояния заказа || -
|-
|}

* Запросы, использующиеся при двухстадийной оплате (с преавторизацией): registerPreAuth.do, deposit.do.
* Запросы, использующиеся при одностадийной оплате (без преавторизации): register.do.
* Запросы reverse.do, refund.do и getOrderStatusExtended.do могут быть использованы при любой схеме оплаты.
* При необходимости возврата средств система Немо посылает запрос обновления заказа в платежный шлюз. Если полученный статус заказа - orderStatus=1, то посылается запрос reverse.do, если orderStatus=2, то посылается refund.do.

==Порядок взаимодействия Системы Немо и Сервиса==

===Оплата с преавторизацией===
#При инициировании оплаты Система Немо отправляет Запрос регистрации заказа registerPreAuth.do.
#Система Немо перенаправляет пользователя на url, который Сервис указал в ответе на запрос регистрации для совершения операции эквайринга на стороне Сервиса.
#Периодически Система Немо отправляет запрос getOrderStatusExtended.do для получения состояния заказа до тех пор, пока Сервис не укажет в качестве orderStatus 1 или 6 при нулевом значении errorCode. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =1, процедура продолжается.
#Параллельно с завершением транзакции Сервис переадресует клиента обратно на страницу заказа (returnUrl в запросе registerPreAuth.do). В результате операции Система Немо дополнительно направляет запрос getOrderStatusExtended для получения актуального статуса оплаты. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =1, процедура продолжается.
#Система Немо выполняет оформление заказа.
##Если оформление прошло успешно, Система Немо инициирует запрос deposit.do для завершения операции эквайринга на стороне Сервиса;
##Если оформление прошло неуспешно, Система Немо инициирует запрос reverse.do;
#Процедура оплаты завершена.

===Оплата без преавторизации===
#При инициировании оплаты Система Немо отправляет Запрос регистрации заказа register.do.
#Система Немо перенаправляет пользователя на url, который Сервис указал в ответе на запрос регистрации для совершения операции эквайринга на стороне Сервиса.
#Периодически Система Немо отправляет запрос getOrderStatusExtended.do для получения состояния заказа до тех пор, пока Сервис не укажет в качестве orderStatus 2 или 6 при нулевом значении errorCode. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =2, процедура продолжается.
#Параллельно с завершением транзакции Сервис переадресует клиента обратно на страницу заказа (returnUrl в запросе register.do). В результате операции Система Немо дополнительно направляет запрос getOrderStatusExtended для получения актуального статуса оплаты.
#Если orderStatus=2 и errorCode=0, Система Немо выполняет оформление заказа.

===Возврат средств===
Для возврата средств Система Немо направляет getOrderStatusExtended.do.
*Если полученный статус заказа orderStatus=1, то посылается запрос reverse.do,
*Если orderStatus=2, то посылается refund.do.

==Формат запросов/ответов==

Универсальный API для подключения платежных шлюзов реализован с помощью HTTP запросов/ответов методом POST.

* register.do
<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderNumber, amount, returnUrl, currency, description, language, jsonParams
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
| returnUrl || Адрес, на который требуется перенаправить пользователя в случае успешной оплаты. Значение должно представлять собой абсолютную ссылку. || Пример: "http://test.com/universal_nemo_pay__after_authorisation?billing_id=111111111".
|-
| currency || Валюта || Код валюты платежа ISO 4217.
|-
| description || Описание заказа в свободной форме || Пример: "Оплата заказа №586578 (1X96WD) с сайта http://test.com".
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
| jsonParams || Блок для передачи дополнительных параметров мерчанта. || Пример данных передаваемых Немо: {"onlyMaestro":"false","email":"test@mutelab.com","phone":"79270099000"}
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: orderId, formUrl, errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| formUrl || URL платежной формы, на который надо перенаправить браузер клиента. || -
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* registerPreAuth.do
<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderNumber, amount, returnUrl, currency, description, language, jsonParams
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
| returnUrl || Адрес, на который требуется перенаправить пользователя в случае успешной оплаты. Значение должно представлять собой абсолютную ссылку. || Пример: "http://test.com/universal_nemo_pay__after_authorisation?billing_id=111111111".
|-
| currency || Валюта || Код валюты платежа ISO 4217.
|-
| description || Описание заказа в свободной форме || Пример: "Оплата заказа №586578 (1X96WD) с сайта http://test.com".
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
| jsonParams || Блок для передачи дополнительных параметров мерчанта. || Пример данных передаваемых Немо: {"onlyMaestro":"false","email":"test@mutelab.com","phone":"79270099000"}
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: orderId, formUrl, errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| formUrl || URL платежной формы, на который надо перенаправить браузер клиента. || -
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* deposit.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId, amount.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* reverse.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* refund.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* getOrderStatusExtended.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId, language, orderNumber.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage, orderStatus и cardAuthInfo(expiration, cardholderName, approvalCode, pan).
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
| orderStatus || Состояние заказа в платежной системе. ||
* 0 - Заказ зарегистрирован, но не оплачен
* 1 - Предавторизованная сумма захолдирована (для двухстадийных платежей)
* 2 - Проведена полная авторизация суммы заказа
* 6 - Авторизация отклонена
|-
| cardAuthInfo || Тэг с атрибутами платежа. ||
* expiration - Срок истечения действия карты в формате YYYYMM.
* cardholderName - Имя держателя карты.
* approvalCode - Код авторизации платежа. Поле фиксированной длины (6 символов), может содержать цифры и латинские буквы.
* pan - Маскированный номер карты, которая использовалась для оплаты.
|-
|}
</div></div>

=См.также=
[[Платежный шлюз]]

Универсальный API для подключения платежных шлюзов

2020-04-07T16:21:41Z

#перенаправление [[Интеграция сервиса приёма платежей с помощью Payment Gateway API]]

Интеграция сервиса приёма платежей с помощью Payment Gateway API

2020-04-07T16:15:33Z

Мария Горшенева: /* Настройка платёжного шлюза в {{NameSystem}} */

Интеграция сервиса приёма платежей с помощью Payment Gateway API

2020-04-07T16:11:26Z

Мария Горшенева:

Универсальный API для подключения платежных шлюзов обеспечивает единый протокол, с помощью которого вы можете с минимальными затратами времени и ресурсов подключить любой существующий платежный шлюз, используя одну универсальную схему подключения.

=Порядок подключения модуля PAYMENT GATEWAY API=

Модуль PAYMENT GATEWAY API является дополнительным. Чтобы подключиться к Nemo.travel по данному протоколу, обратитесь в коммерческий отдел по адресу connect@nemo.travel

==Особенности==
Сервис не поддерживает фискализацию платежей.

==Настройка платёжного шлюза в {{NameSystem}}==

# В разделе '''Финансы и платежи → Платежные методы → Доступ с способам оплаты''' откройте доступ к способу оплаты для пользователей/групп/компаний
# В разделе '''Финансы и платежи → Платежные методы → Управление шлюзами''' создайте метод оплаты "UniversalNemoPay"
# Откройте раздел "Реквизиты" созданного платёжного метода и задайте настройки доступа к платёжному шлюзу:
#* URL клиентского сервера для запросов - адрес запросов для доступа к Сервису, например http://test.com/test
#* API логин - реквизит доступа к платёжному шлюзу, выдаётся платёжным шлюзом
#* Пароль - реквизит доступа к платёжному шлюзу, выдаётся платёжным шлюзом
#* Валюта - валюта по договору с платёжным шлюзом
#* Использовать двухстадийную оплату - если параметр включен, будет использована схема запросов с преавторизацией. Если выключен - схема запросов без преавторизации.
#* Разрешить оплату только картами Visa Electron и MasterCard Maestro
#* Добавить локатор в начало идентификатора платежа при передаче в платежный шлюз - в orderNumber добавляется префикс с локатором.
#* Отображать фрэйм со страницей оплаты на странице информации о заказе
#* Высота фрэйма со страницей оплаты

=Техническая документация по интеграции с сервисом PAYMENT GATEWAY API=

'''Используемые в разделе термины:'''
*''Система Немо'' - система бронирования Nemo Travel,
*''Сервис'' - сервис по приему платежей.

==Описание запросов==

{| class="wikitable"
! Название запроса !! Описание !! Особенности
|-
| register.do || Запрос регистрации заказа (без преавторизации)|| -
|-
| registerPreAuth.do || Запрос регистрации заказа c преавторизацией || -
|-
| deposit.do || Запрoс завершения oплаты заказа || -
|-
| reverse.do || Запрос отмены оплаты заказа || -
|-
| refund.do || Запрос возврата средств оплаты заказа || -
|-
| getOrderStatusExtended.do || Расширенный запрос состояния заказа || -
|-
|}

* Запросы, использующиеся при двухстадийной оплате (с преавторизацией): registerPreAuth.do, deposit.do.
* Запросы, использующиеся при одностадийной оплате (без преавторизации): register.do.
* Запросы reverse.do, refund.do и getOrderStatusExtended.do могут быть использованы при любой схеме оплаты.
* При необходимости возврата средств система Немо посылает запрос обновления заказа в платежный шлюз. Если полученный статус заказа - orderStatus=1, то посылается запрос reverse.do, если orderStatus=2, то посылается refund.do.

==Порядок взаимодействия Системы Немо и Сервиса==

===Оплата с преавторизацией===
#При инициировании оплаты Система Немо отправляет Запрос регистрации заказа registerPreAuth.do.
#Система Немо перенаправляет пользователя на url, который Сервис указал в ответе на запрос регистрации для совершения операции эквайринга на стороне Сервиса.
#Периодически Система Немо отправляет запрос getOrderStatusExtended.do для получения состояния заказа до тех пор, пока Сервис не укажет в качестве orderStatus 1 или 6 при нулевом значении errorCode. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =1, процедура продолжается.
#Параллельно с завершением транзакции Сервис переадресует клиента обратно на страницу заказа (returnUrl в запросе registerPreAuth.do). В результате операции Система Немо дополнительно направляет запрос getOrderStatusExtended для получения актуального статуса оплаты. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =1, процедура продолжается.
#Система Немо выполняет оформление заказа.
##Если оформление прошло успешно, Система Немо инициирует запрос deposit.do для завершения операции эквайринга на стороне Сервиса;
##Если оформление прошло неуспешно, Система Немо инициирует запрос reverse.do;
#Процедура оплаты завершена.

===Оплата без преавторизации===
#При инициировании оплаты Система Немо отправляет Запрос регистрации заказа register.do.
#Система Немо перенаправляет пользователя на url, который Сервис указал в ответе на запрос регистрации для совершения операции эквайринга на стороне Сервиса.
#Периодически Система Немо отправляет запрос getOrderStatusExtended.do для получения состояния заказа до тех пор, пока Сервис не укажет в качестве orderStatus 2 или 6 при нулевом значении errorCode. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =2, процедура продолжается.
#Параллельно с завершением транзакции Сервис переадресует клиента обратно на страницу заказа (returnUrl в запросе register.do). В результате операции Система Немо дополнительно направляет запрос getOrderStatusExtended для получения актуального статуса оплаты.
#Если orderStatus=2 и errorCode=0, Система Немо выполняет оформление заказа.

===Возврат средств===
Для возврата средств Система Немо направляет getOrderStatusExtended.do.
*Если полученный статус заказа orderStatus=1, то посылается запрос reverse.do,
*Если orderStatus=2, то посылается refund.do.

==Формат запросов/ответов==

Универсальный API для подключения платежных шлюзов реализован с помощью HTTP запросов/ответов методом POST.

* register.do
<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderNumber, amount, returnUrl, currency, description, language, jsonParams
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
| returnUrl || Адрес, на который требуется перенаправить пользователя в случае успешной оплаты. Значение должно представлять собой абсолютную ссылку. || Пример: "http://test.com/universal_nemo_pay__after_authorisation?billing_id=111111111".
|-
| currency || Валюта || Код валюты платежа ISO 4217.
|-
| description || Описание заказа в свободной форме || Пример: "Оплата заказа №586578 (1X96WD) с сайта http://test.com".
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
| jsonParams || Блок для передачи дополнительных параметров мерчанта. || Пример данных передаваемых Немо: {"onlyMaestro":"false","email":"test@mutelab.com","phone":"79270099000"}
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: orderId, formUrl, errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| formUrl || URL платежной формы, на который надо перенаправить браузер клиента. || -
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* registerPreAuth.do
<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderNumber, amount, returnUrl, currency, description, language, jsonParams
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
| returnUrl || Адрес, на который требуется перенаправить пользователя в случае успешной оплаты. Значение должно представлять собой абсолютную ссылку. || Пример: "http://test.com/universal_nemo_pay__after_authorisation?billing_id=111111111".
|-
| currency || Валюта || Код валюты платежа ISO 4217.
|-
| description || Описание заказа в свободной форме || Пример: "Оплата заказа №586578 (1X96WD) с сайта http://test.com".
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
| jsonParams || Блок для передачи дополнительных параметров мерчанта. || Пример данных передаваемых Немо: {"onlyMaestro":"false","email":"test@mutelab.com","phone":"79270099000"}
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: orderId, formUrl, errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| formUrl || URL платежной формы, на который надо перенаправить браузер клиента. || -
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* deposit.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId, amount.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* reverse.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* refund.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* getOrderStatusExtended.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId, language, orderNumber.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage, orderStatus и cardAuthInfo(expiration, cardholderName, approvalCode, pan).
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
| orderStatus || Состояние заказа в платежной системе. ||
* 0 - Заказ зарегистрирован, но не оплачен
* 1 - Предавторизованная сумма захолдирована (для двухстадийных платежей)
* 2 - Проведена полная авторизация суммы заказа
* 6 - Авторизация отклонена
|-
| cardAuthInfo || Тэг с атрибутами платежа. ||
* expiration - Срок истечения действия карты в формате YYYYMM.
* cardholderName - Имя держателя карты.
* approvalCode - Код авторизации платежа. Поле фиксированной длины (6 символов), может содержать цифры и латинские буквы.
* pan - Маскированный номер карты, которая использовалась для оплаты.
|-
|}
</div></div>

=См.также=
[[Платежный шлюз]]

Интеграция сервиса приёма платежей с помощью Payment Gateway API

2020-04-07T16:10:41Z

Мария Горшенева: /* Настройка шлюза */

Универсальный API для подключения платежных шлюзов обеспечивает единый протокол, с помощью которого вы можете с минимальными затратами времени и ресурсов подключить любой существующий платежный шлюз, используя одну универсальную схему подключения.

=Порядок подключения модуля PAYMENT GATEWAY API=

Модуль PAYMENT GATEWAY API является дополнительным. Чтобы подключиться к Nemo.travel по данному протоколу, обратитесь в коммерческий отдел по адресу connect@nemo.travel

==Особенности==
Сервис не поддерживает фискализацию платежей.

==Настройка платёжного шлюза в {{NameSystem}}==

# В разделе '''Финансы и платежи → Платежные методы → Доступ с способам оплаты''' откройте доступ к способу оплаты для пользователей/групп/компаний
# В разделе '''Финансы и платежи → Платежные методы → Управление шлюзами''' создайте метод оплаты "UniversalNemoPay"
# Откройте раздел "Реквизиты" созданного платёжного метода и задайте настройки доступа к платёжному шлюзу:
#* URL клиентского сервера для запросов - адрес запросов для доступа к Сервису, например http://test.com/test
#* API логин - реквизит доступа к платёжному шлюзу, выдаётся платёжным шлюзом
#* Пароль - реквизит доступа к платёжному шлюзу, выдаётся платёжным шлюзом
#* Валюта - валюта по договору с платёжным шлюзом
#* Использовать двухстадийную оплату - если параметр включен, будет использована схема запросов с преавторизацией. Если выключен - схема запросов без преавторизации.
#* Разрешить оплату только картами Visa Electron и MasterCard Maestro
#* Добавить локатор в начало идентификатора платежа при передаче в платежный шлюз - в orderNumber добавляется префикс с локатором.
#* Отображать фрэйм со страницей оплаты на странице информации о заказе
#* Высота фрэйма со страницей оплаты

=Техническая документация по интеграции с сервисом PAYMENT GATEWAY API=

'''Используемые в разделе термины:'''
*''Система Немо'' - система бронирования Nemo Travel,
*''Сервис'' - сервис по приему платежей.

==Описание запросов==

{| class="wikitable"
! Название запроса !! Описание !! Особенности
|-
| register.do || Запрос регистрации заказа (без предавторизации)|| -
|-
| registerPreAuth.do || Запрос регистрации заказа c предавторизацией || -
|-
| deposit.do || Запрoс завершения oплаты заказа || -
|-
| reverse.do || Запрос отмены оплаты заказа || -
|-
| refund.do || Запрос возврата средств оплаты заказа || -
|-
| getOrderStatusExtended.do || Расширенный запрос состояния заказа || -
|-
|}

* Запросы, использующиеся при двухстадийной оплате (с предавторизацией): registerPreAuth.do, deposit.do.
* Запросы, использующиеся при одностадийной оплате (без предавторизации): register.do.
* Запросы reverse.do, refund.do и getOrderStatusExtended.do могут быть использованы при любой схеме оплаты.
* При необходимости возврата средств система Немо посылает запрос обновления заказа в платежный шлюз. Если полученный статус заказа - orderStatus=1, то посылается запрос reverse.do, если orderStatus=2, то посылается refund.do.

==Порядок взаимодействия Системы Немо и Сервиса==

===Оплата с предавторизацией===
#При инициировании оплаты Система Немо отправляет Запрос регистрации заказа registerPreAuth.do.
#Система Немо перенаправляет пользователя на url, который Сервис указал в ответе на запрос регистрации для совершения операции эквайринга на стороне Сервиса.
#Периодически Система Немо отправляет запрос getOrderStatusExtended.do для получения состояния заказа до тех пор, пока Сервис не укажет в качестве orderStatus 1 или 6 при нулевом значении errorCode. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =1, процедура продолжается.
#Параллельно с завершением транзакции Сервис переадресует клиента обратно на страницу заказа (returnUrl в запросе registerPreAuth.do). В результате операции Система Немо дополнительно направляет запрос getOrderStatusExtended для получения актуального статуса оплаты. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =1, процедура продолжается.
#Система Немо выполняет оформление заказа.
##Если оформление прошло успешно, Система Немо инициирует запрос deposit.do для завершения операции эквайринга на стороне Сервиса;
##Если оформление прошло неуспешно, Система Немо инициирует запрос reverse.do;
#Процедура оплаты завершена.

===Оплата без предавторизации===
#При инициировании оплаты Система Немо отправляет Запрос регистрации заказа register.do.
#Система Немо перенаправляет пользователя на url, который Сервис указал в ответе на запрос регистрации для совершения операции эквайринга на стороне Сервиса.
#Периодически Система Немо отправляет запрос getOrderStatusExtended.do для получения состояния заказа до тех пор, пока Сервис не укажет в качестве orderStatus 2 или 6 при нулевом значении errorCode. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =2, процедура продолжается.
#Параллельно с завершением транзакции Сервис переадресует клиента обратно на страницу заказа (returnUrl в запросе register.do). В результате операции Система Немо дополнительно направляет запрос getOrderStatusExtended для получения актуального статуса оплаты.
#Если orderStatus=2 и errorCode=0, Система Немо выполняет оформление заказа.

===Возврат средств===
Для возврата средств Система Немо направляет getOrderStatusExtended.do.
*Если полученный статус заказа orderStatus=1, то посылается запрос reverse.do,
*Если orderStatus=2, то посылается refund.do.

==Формат запросов/ответов==

Универсальный API для подключения платежных шлюзов реализован с помощью HTTP запросов/ответов методом POST.

* register.do
<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderNumber, amount, returnUrl, currency, description, language, jsonParams
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
| returnUrl || Адрес, на который требуется перенаправить пользователя в случае успешной оплаты. Значение должно представлять собой абсолютную ссылку. || Пример: "http://test.com/universal_nemo_pay__after_authorisation?billing_id=111111111".
|-
| currency || Валюта || Код валюты платежа ISO 4217.
|-
| description || Описание заказа в свободной форме || Пример: "Оплата заказа №586578 (1X96WD) с сайта http://test.com".
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
| jsonParams || Блок для передачи дополнительных параметров мерчанта. || Пример данных передаваемых Немо: {"onlyMaestro":"false","email":"test@mutelab.com","phone":"79270099000"}
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: orderId, formUrl, errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| formUrl || URL платежной формы, на который надо перенаправить браузер клиента. || -
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* registerPreAuth.do
<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderNumber, amount, returnUrl, currency, description, language, jsonParams
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
| returnUrl || Адрес, на который требуется перенаправить пользователя в случае успешной оплаты. Значение должно представлять собой абсолютную ссылку. || Пример: "http://test.com/universal_nemo_pay__after_authorisation?billing_id=111111111".
|-
| currency || Валюта || Код валюты платежа ISO 4217.
|-
| description || Описание заказа в свободной форме || Пример: "Оплата заказа №586578 (1X96WD) с сайта http://test.com".
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
| jsonParams || Блок для передачи дополнительных параметров мерчанта. || Пример данных передаваемых Немо: {"onlyMaestro":"false","email":"test@mutelab.com","phone":"79270099000"}
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: orderId, formUrl, errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| formUrl || URL платежной формы, на который надо перенаправить браузер клиента. || -
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* deposit.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId, amount.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* reverse.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* refund.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* getOrderStatusExtended.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId, language, orderNumber.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage, orderStatus и cardAuthInfo(expiration, cardholderName, approvalCode, pan).
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
| orderStatus || Состояние заказа в платежной системе. ||
* 0 - Заказ зарегистрирован, но не оплачен
* 1 - Предавторизованная сумма захолдирована (для двухстадийных платежей)
* 2 - Проведена полная авторизация суммы заказа
* 6 - Авторизация отклонена
|-
| cardAuthInfo || Тэг с атрибутами платежа. ||
* expiration - Срок истечения действия карты в формате YYYYMM.
* cardholderName - Имя держателя карты.
* approvalCode - Код авторизации платежа. Поле фиксированной длины (6 символов), может содержать цифры и латинские буквы.
* pan - Маскированный номер карты, которая использовалась для оплаты.
|-
|}
</div></div>

=См.также=
[[Платежный шлюз]]

Интеграция сервиса приёма платежей с помощью Payment Gateway API

2020-04-07T15:59:08Z

Мария Горшенева: /* Техническая документация по интеграции с сервисом PAYMENT GATEWAY API */

Универсальный API для подключения платежных шлюзов обеспечивает единый протокол, с помощью которого вы можете с минимальными затратами времени и ресурсов подключить любой существующий платежный шлюз, используя одну универсальную схему подключения.

=Порядок подключения модуля PAYMENT GATEWAY API=

Модуль PAYMENT GATEWAY API является дополнительным. Чтобы подключиться к Nemo.travel по данному протоколу, обратитесь в коммерческий отдел по адресу connect@nemo.travel

==Особенности==
Сервис не поддерживает фискализацию платежей.

==Настройка шлюза==

Доступные настройки:
* URL клиентского сервера для запросов - указывается адрес запросов, например http://test.com/test
* API логин - от Платежного шлюза
* Пароль - от Платежного шлюза
* Валюта
* Использовать двухстадийную оплату - если параметр включен, будет использована схема запросов с преавторизацией. Если выключен - схема запросов без преавторизации.
* Разрешить оплату только картами Visa Electron и MasterCard Maestro Сбербанка
* Добавить локатор в начало идентификатора платежа при передаче в платежный шлюз - в orderNumber добавляется префикс с локатором.
* Отображать фрэйм со страницей оплаты на странице информации о заказе
* Высота фрэйма со страницей оплаты

=Техническая документация по интеграции с сервисом PAYMENT GATEWAY API=

'''Используемые в разделе термины:'''
*''Система Немо'' - система бронирования Nemo Travel,
*''Сервис'' - сервис по приему платежей.

==Описание запросов==

{| class="wikitable"
! Название запроса !! Описание !! Особенности
|-
| register.do || Запрос регистрации заказа (без предавторизации)|| -
|-
| registerPreAuth.do || Запрос регистрации заказа c предавторизацией || -
|-
| deposit.do || Запрoс завершения oплаты заказа || -
|-
| reverse.do || Запрос отмены оплаты заказа || -
|-
| refund.do || Запрос возврата средств оплаты заказа || -
|-
| getOrderStatusExtended.do || Расширенный запрос состояния заказа || -
|-
|}

* Запросы, использующиеся при двухстадийной оплате (с предавторизацией): registerPreAuth.do, deposit.do.
* Запросы, использующиеся при одностадийной оплате (без предавторизации): register.do.
* Запросы reverse.do, refund.do и getOrderStatusExtended.do могут быть использованы при любой схеме оплаты.
* При необходимости возврата средств система Немо посылает запрос обновления заказа в платежный шлюз. Если полученный статус заказа - orderStatus=1, то посылается запрос reverse.do, если orderStatus=2, то посылается refund.do.

==Порядок взаимодействия Системы Немо и Сервиса==

===Оплата с предавторизацией===
#При инициировании оплаты Система Немо отправляет Запрос регистрации заказа registerPreAuth.do.
#Система Немо перенаправляет пользователя на url, который Сервис указал в ответе на запрос регистрации для совершения операции эквайринга на стороне Сервиса.
#Периодически Система Немо отправляет запрос getOrderStatusExtended.do для получения состояния заказа до тех пор, пока Сервис не укажет в качестве orderStatus 1 или 6 при нулевом значении errorCode. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =1, процедура продолжается.
#Параллельно с завершением транзакции Сервис переадресует клиента обратно на страницу заказа (returnUrl в запросе registerPreAuth.do). В результате операции Система Немо дополнительно направляет запрос getOrderStatusExtended для получения актуального статуса оплаты. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =1, процедура продолжается.
#Система Немо выполняет оформление заказа.
##Если оформление прошло успешно, Система Немо инициирует запрос deposit.do для завершения операции эквайринга на стороне Сервиса;
##Если оформление прошло неуспешно, Система Немо инициирует запрос reverse.do;
#Процедура оплаты завершена.

===Оплата без предавторизации===
#При инициировании оплаты Система Немо отправляет Запрос регистрации заказа register.do.
#Система Немо перенаправляет пользователя на url, который Сервис указал в ответе на запрос регистрации для совершения операции эквайринга на стороне Сервиса.
#Периодически Система Немо отправляет запрос getOrderStatusExtended.do для получения состояния заказа до тех пор, пока Сервис не укажет в качестве orderStatus 2 или 6 при нулевом значении errorCode. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =2, процедура продолжается.
#Параллельно с завершением транзакции Сервис переадресует клиента обратно на страницу заказа (returnUrl в запросе register.do). В результате операции Система Немо дополнительно направляет запрос getOrderStatusExtended для получения актуального статуса оплаты.
#Если orderStatus=2 и errorCode=0, Система Немо выполняет оформление заказа.

===Возврат средств===
Для возврата средств Система Немо направляет getOrderStatusExtended.do.
*Если полученный статус заказа orderStatus=1, то посылается запрос reverse.do,
*Если orderStatus=2, то посылается refund.do.

==Формат запросов/ответов==

Универсальный API для подключения платежных шлюзов реализован с помощью HTTP запросов/ответов методом POST.

* register.do
<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderNumber, amount, returnUrl, currency, description, language, jsonParams
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
| returnUrl || Адрес, на который требуется перенаправить пользователя в случае успешной оплаты. Значение должно представлять собой абсолютную ссылку. || Пример: "http://test.com/universal_nemo_pay__after_authorisation?billing_id=111111111".
|-
| currency || Валюта || Код валюты платежа ISO 4217.
|-
| description || Описание заказа в свободной форме || Пример: "Оплата заказа №586578 (1X96WD) с сайта http://test.com".
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
| jsonParams || Блок для передачи дополнительных параметров мерчанта. || Пример данных передаваемых Немо: {"onlyMaestro":"false","email":"test@mutelab.com","phone":"79270099000"}
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: orderId, formUrl, errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| formUrl || URL платежной формы, на который надо перенаправить браузер клиента. || -
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* registerPreAuth.do
<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderNumber, amount, returnUrl, currency, description, language, jsonParams
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
| returnUrl || Адрес, на который требуется перенаправить пользователя в случае успешной оплаты. Значение должно представлять собой абсолютную ссылку. || Пример: "http://test.com/universal_nemo_pay__after_authorisation?billing_id=111111111".
|-
| currency || Валюта || Код валюты платежа ISO 4217.
|-
| description || Описание заказа в свободной форме || Пример: "Оплата заказа №586578 (1X96WD) с сайта http://test.com".
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
| jsonParams || Блок для передачи дополнительных параметров мерчанта. || Пример данных передаваемых Немо: {"onlyMaestro":"false","email":"test@mutelab.com","phone":"79270099000"}
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: orderId, formUrl, errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| formUrl || URL платежной формы, на который надо перенаправить браузер клиента. || -
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* deposit.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId, amount.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* reverse.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* refund.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* getOrderStatusExtended.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId, language, orderNumber.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage, orderStatus и cardAuthInfo(expiration, cardholderName, approvalCode, pan).
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
| orderStatus || Состояние заказа в платежной системе. ||
* 0 - Заказ зарегистрирован, но не оплачен
* 1 - Предавторизованная сумма захолдирована (для двухстадийных платежей)
* 2 - Проведена полная авторизация суммы заказа
* 6 - Авторизация отклонена
|-
| cardAuthInfo || Тэг с атрибутами платежа. ||
* expiration - Срок истечения действия карты в формате YYYYMM.
* cardholderName - Имя держателя карты.
* approvalCode - Код авторизации платежа. Поле фиксированной длины (6 символов), может содержать цифры и латинские буквы.
* pan - Маскированный номер карты, которая использовалась для оплаты.
|-
|}
</div></div>

=См.также=
[[Платежный шлюз]]

Интеграция сервиса приёма платежей с помощью Payment Gateway API

2020-04-07T15:57:16Z

Мария Горшенева:

Универсальный API для подключения платежных шлюзов обеспечивает единый протокол, с помощью которого вы можете с минимальными затратами времени и ресурсов подключить любой существующий платежный шлюз, используя одну универсальную схему подключения.

=Порядок подключения модуля PAYMENT GATEWAY API=

Модуль PAYMENT GATEWAY API является дополнительным. Чтобы подключиться к Nemo.travel по данному протоколу, обратитесь в коммерческий отдел по адресу connect@nemo.travel

==Особенности==
Сервис не поддерживает фискализацию платежей.

==Настройка шлюза==

Доступные настройки:
* URL клиентского сервера для запросов - указывается адрес запросов, например http://test.com/test
* API логин - от Платежного шлюза
* Пароль - от Платежного шлюза
* Валюта
* Использовать двухстадийную оплату - если параметр включен, будет использована схема запросов с преавторизацией. Если выключен - схема запросов без преавторизации.
* Разрешить оплату только картами Visa Electron и MasterCard Maestro Сбербанка
* Добавить локатор в начало идентификатора платежа при передаче в платежный шлюз - в orderNumber добавляется префикс с локатором.
* Отображать фрэйм со страницей оплаты на странице информации о заказе
* Высота фрэйма со страницей оплаты

=Техническая документация по интеграции с сервисом PAYMENT GATEWAY API=

'''Здесь и далее:'''
*Система Немо - система бронирования Nemo Travel,
*Сервис - сервис по приему платежей.

==Описание запросов==

{| class="wikitable"
! Название запроса !! Описание !! Особенности
|-
| register.do || Запрос регистрации заказа (без предавторизации)|| -
|-
| registerPreAuth.do || Запрос регистрации заказа c предавторизацией || -
|-
| deposit.do || Запрoс завершения oплаты заказа || -
|-
| reverse.do || Запрос отмены оплаты заказа || -
|-
| refund.do || Запрос возврата средств оплаты заказа || -
|-
| getOrderStatusExtended.do || Расширенный запрос состояния заказа || -
|-
|}

* Запросы, использующиеся при двухстадийной оплате (с предавторизацией): registerPreAuth.do, deposit.do.
* Запросы, использующиеся при одностадийной оплате (без предавторизации): register.do.
* Запросы reverse.do, refund.do и getOrderStatusExtended.do могут быть использованы при любой схеме оплаты.
* При необходимости возврата средств система Немо посылает запрос обновления заказа в платежный шлюз. Если полученный статус заказа - orderStatus=1, то посылается запрос reverse.do, если orderStatus=2, то посылается refund.do.

==Порядок взаимодействия Системы Немо и Сервиса==

===Оплата с предавторизацией===
#При инициировании оплаты Система Немо отправляет Запрос регистрации заказа registerPreAuth.do.
#Система Немо перенаправляет пользователя на url, который Сервис указал в ответе на запрос регистрации для совершения операции эквайринга на стороне Сервиса.
#Периодически Система Немо отправляет запрос getOrderStatusExtended.do для получения состояния заказа до тех пор, пока Сервис не укажет в качестве orderStatus 1 или 6 при нулевом значении errorCode. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =1, процедура продолжается.
#Параллельно с завершением транзакции Сервис переадресует клиента обратно на страницу заказа (returnUrl в запросе registerPreAuth.do). В результате операции Система Немо дополнительно направляет запрос getOrderStatusExtended для получения актуального статуса оплаты. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =1, процедура продолжается.
#Система Немо выполняет оформление заказа.
##Если оформление прошло успешно, Система Немо инициирует запрос deposit.do для завершения операции эквайринга на стороне Сервиса;
##Если оформление прошло неуспешно, Система Немо инициирует запрос reverse.do;
#Процедура оплаты завершена.

===Оплата без предавторизации===
#При инициировании оплаты Система Немо отправляет Запрос регистрации заказа register.do.
#Система Немо перенаправляет пользователя на url, который Сервис указал в ответе на запрос регистрации для совершения операции эквайринга на стороне Сервиса.
#Периодически Система Немо отправляет запрос getOrderStatusExtended.do для получения состояния заказа до тех пор, пока Сервис не укажет в качестве orderStatus 2 или 6 при нулевом значении errorCode. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =2, процедура продолжается.
#Параллельно с завершением транзакции Сервис переадресует клиента обратно на страницу заказа (returnUrl в запросе register.do). В результате операции Система Немо дополнительно направляет запрос getOrderStatusExtended для получения актуального статуса оплаты.
#Если orderStatus=2 и errorCode=0, Система Немо выполняет оформление заказа.

===Возврат средств===
Для возврата средств Система Немо направляет getOrderStatusExtended.do.
*Если полученный статус заказа orderStatus=1, то посылается запрос reverse.do,
*Если orderStatus=2, то посылается refund.do.

==Формат запросов/ответов==

Универсальный API для подключения платежных шлюзов реализован с помощью HTTP запросов/ответов методом POST.

* register.do
<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderNumber, amount, returnUrl, currency, description, language, jsonParams
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
| returnUrl || Адрес, на который требуется перенаправить пользователя в случае успешной оплаты. Значение должно представлять собой абсолютную ссылку. || Пример: "http://test.com/universal_nemo_pay__after_authorisation?billing_id=111111111".
|-
| currency || Валюта || Код валюты платежа ISO 4217.
|-
| description || Описание заказа в свободной форме || Пример: "Оплата заказа №586578 (1X96WD) с сайта http://test.com".
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
| jsonParams || Блок для передачи дополнительных параметров мерчанта. || Пример данных передаваемых Немо: {"onlyMaestro":"false","email":"test@mutelab.com","phone":"79270099000"}
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: orderId, formUrl, errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| formUrl || URL платежной формы, на который надо перенаправить браузер клиента. || -
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* registerPreAuth.do
<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderNumber, amount, returnUrl, currency, description, language, jsonParams
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
| returnUrl || Адрес, на который требуется перенаправить пользователя в случае успешной оплаты. Значение должно представлять собой абсолютную ссылку. || Пример: "http://test.com/universal_nemo_pay__after_authorisation?billing_id=111111111".
|-
| currency || Валюта || Код валюты платежа ISO 4217.
|-
| description || Описание заказа в свободной форме || Пример: "Оплата заказа №586578 (1X96WD) с сайта http://test.com".
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
| jsonParams || Блок для передачи дополнительных параметров мерчанта. || Пример данных передаваемых Немо: {"onlyMaestro":"false","email":"test@mutelab.com","phone":"79270099000"}
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: orderId, formUrl, errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| formUrl || URL платежной формы, на который надо перенаправить браузер клиента. || -
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* deposit.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId, amount.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* reverse.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* refund.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* getOrderStatusExtended.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId, language, orderNumber.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage, orderStatus и cardAuthInfo(expiration, cardholderName, approvalCode, pan).
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
| orderStatus || Состояние заказа в платежной системе. ||
* 0 - Заказ зарегистрирован, но не оплачен
* 1 - Предавторизованная сумма захолдирована (для двухстадийных платежей)
* 2 - Проведена полная авторизация суммы заказа
* 6 - Авторизация отклонена
|-
| cardAuthInfo || Тэг с атрибутами платежа. ||
* expiration - Срок истечения действия карты в формате YYYYMM.
* cardholderName - Имя держателя карты.
* approvalCode - Код авторизации платежа. Поле фиксированной длины (6 символов), может содержать цифры и латинские буквы.
* pan - Маскированный номер карты, которая использовалась для оплаты.
|-
|}
</div></div>

=См.также=
[[Платежный шлюз]]

Интеграция сервиса приёма платежей с помощью Payment Gateway API

2020-04-07T15:56:51Z

Мария Горшенева:

Универсальный API для подключения платежных шлюзов обеспечивает единый протокол, с помощью которого вы можете с минимальными затратами времени и ресурсов подключить любой существующий платежный шлюз, используя одну универсальную схему подключения.

=Порядок подключения модуля PAYMENT GATEWAY API=

Модуль PAYMENT GATEWAY API является дополнительным. Чтобы подключиться к Nemo.travel по данному протоколу, обратитесь в коммерческий отдел по адресу connect@nemo.travel

=Особенности=
Сервис не поддерживает фискализацию платежей.

=Настройка шлюза=

Доступные настройки:
* URL клиентского сервера для запросов - указывается адрес запросов, например http://test.com/test
* API логин - от Платежного шлюза
* Пароль - от Платежного шлюза
* Валюта
* Использовать двухстадийную оплату - если параметр включен, будет использована схема запросов с преавторизацией. Если выключен - схема запросов без преавторизации.
* Разрешить оплату только картами Visa Electron и MasterCard Maestro Сбербанка
* Добавить локатор в начало идентификатора платежа при передаче в платежный шлюз - в orderNumber добавляется префикс с локатором.
* Отображать фрэйм со страницей оплаты на странице информации о заказе
* Высота фрэйма со страницей оплаты

=Техническая документация по интеграции с сервисом PAYMENT GATEWAY API=

'''Здесь и далее:'''
*Система Немо - система бронирования Nemo Travel,
*Сервис - сервис по приему платежей.

==Описание запросов==

{| class="wikitable"
! Название запроса !! Описание !! Особенности
|-
| register.do || Запрос регистрации заказа (без предавторизации)|| -
|-
| registerPreAuth.do || Запрос регистрации заказа c предавторизацией || -
|-
| deposit.do || Запрoс завершения oплаты заказа || -
|-
| reverse.do || Запрос отмены оплаты заказа || -
|-
| refund.do || Запрос возврата средств оплаты заказа || -
|-
| getOrderStatusExtended.do || Расширенный запрос состояния заказа || -
|-
|}

* Запросы, использующиеся при двухстадийной оплате (с предавторизацией): registerPreAuth.do, deposit.do.
* Запросы, использующиеся при одностадийной оплате (без предавторизации): register.do.
* Запросы reverse.do, refund.do и getOrderStatusExtended.do могут быть использованы при любой схеме оплаты.
* При необходимости возврата средств система Немо посылает запрос обновления заказа в платежный шлюз. Если полученный статус заказа - orderStatus=1, то посылается запрос reverse.do, если orderStatus=2, то посылается refund.do.

==Порядок взаимодействия Системы Немо и Сервиса==

===Оплата с предавторизацией===
#При инициировании оплаты Система Немо отправляет Запрос регистрации заказа registerPreAuth.do.
#Система Немо перенаправляет пользователя на url, который Сервис указал в ответе на запрос регистрации для совершения операции эквайринга на стороне Сервиса.
#Периодически Система Немо отправляет запрос getOrderStatusExtended.do для получения состояния заказа до тех пор, пока Сервис не укажет в качестве orderStatus 1 или 6 при нулевом значении errorCode. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =1, процедура продолжается.
#Параллельно с завершением транзакции Сервис переадресует клиента обратно на страницу заказа (returnUrl в запросе registerPreAuth.do). В результате операции Система Немо дополнительно направляет запрос getOrderStatusExtended для получения актуального статуса оплаты. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =1, процедура продолжается.
#Система Немо выполняет оформление заказа.
##Если оформление прошло успешно, Система Немо инициирует запрос deposit.do для завершения операции эквайринга на стороне Сервиса;
##Если оформление прошло неуспешно, Система Немо инициирует запрос reverse.do;
#Процедура оплаты завершена.

===Оплата без предавторизации===
#При инициировании оплаты Система Немо отправляет Запрос регистрации заказа register.do.
#Система Немо перенаправляет пользователя на url, который Сервис указал в ответе на запрос регистрации для совершения операции эквайринга на стороне Сервиса.
#Периодически Система Немо отправляет запрос getOrderStatusExtended.do для получения состояния заказа до тех пор, пока Сервис не укажет в качестве orderStatus 2 или 6 при нулевом значении errorCode. При получении orderStatus = 6 процедура оплаты в Системе Немо завершается как неуспешная. Если orderStatus =2, процедура продолжается.
#Параллельно с завершением транзакции Сервис переадресует клиента обратно на страницу заказа (returnUrl в запросе register.do). В результате операции Система Немо дополнительно направляет запрос getOrderStatusExtended для получения актуального статуса оплаты.
#Если orderStatus=2 и errorCode=0, Система Немо выполняет оформление заказа.

===Возврат средств===
Для возврата средств Система Немо направляет getOrderStatusExtended.do.
*Если полученный статус заказа orderStatus=1, то посылается запрос reverse.do,
*Если orderStatus=2, то посылается refund.do.

==Формат запросов/ответов==

Универсальный API для подключения платежных шлюзов реализован с помощью HTTP запросов/ответов методом POST.

* register.do
<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderNumber, amount, returnUrl, currency, description, language, jsonParams
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
| returnUrl || Адрес, на который требуется перенаправить пользователя в случае успешной оплаты. Значение должно представлять собой абсолютную ссылку. || Пример: "http://test.com/universal_nemo_pay__after_authorisation?billing_id=111111111".
|-
| currency || Валюта || Код валюты платежа ISO 4217.
|-
| description || Описание заказа в свободной форме || Пример: "Оплата заказа №586578 (1X96WD) с сайта http://test.com".
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
| jsonParams || Блок для передачи дополнительных параметров мерчанта. || Пример данных передаваемых Немо: {"onlyMaestro":"false","email":"test@mutelab.com","phone":"79270099000"}
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: orderId, formUrl, errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| formUrl || URL платежной формы, на который надо перенаправить браузер клиента. || -
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* registerPreAuth.do
<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderNumber, amount, returnUrl, currency, description, language, jsonParams
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
| returnUrl || Адрес, на который требуется перенаправить пользователя в случае успешной оплаты. Значение должно представлять собой абсолютную ссылку. || Пример: "http://test.com/universal_nemo_pay__after_authorisation?billing_id=111111111".
|-
| currency || Валюта || Код валюты платежа ISO 4217.
|-
| description || Описание заказа в свободной форме || Пример: "Оплата заказа №586578 (1X96WD) с сайта http://test.com".
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
| jsonParams || Блок для передачи дополнительных параметров мерчанта. || Пример данных передаваемых Немо: {"onlyMaestro":"false","email":"test@mutelab.com","phone":"79270099000"}
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: orderId, formUrl, errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| formUrl || URL платежной формы, на который надо перенаправить браузер клиента. || -
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* deposit.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId, amount.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| amount || Сумма к оплате || Сумма платежа в копейках (или центах)
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* reverse.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* refund.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
|}
</div></div>

* getOrderStatusExtended.do

<div class="toccolours mw-collapsible mw-collapsed">
Параметры запроса: userName, password, orderId, language, orderNumber.
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| userName || API логин || Логин магазина, полученный при подключении
|-
| password || Пароль || Пароль магазина, полученный при подключении
|-
| orderId || Номер заказа в платежной системе. Уникален в пределах системы. || -
|-
| orderNumber || Номер (идентификатор) заказа в системе магазина, уникален для каждого магазина в пределах системы || Номер биллинга
|-
| language || Язык в кодировке ISO 639-1. || Пример: "ru".
|-
|}
</div></div>

<div class="toccolours mw-collapsible mw-collapsed">
Параметры ответа: errorCode, errorMessage, orderStatus и cardAuthInfo(expiration, cardholderName, approvalCode, pan).
<div class="mw-collapsible-content">
{| class="wikitable"
! Название параметра !! Описание !! Особенности
|-
| errorCode || Код ошибки. || Любое значение отличное от "0" воспринимается нашей системой как неуспешный ответ.
|-
| errorMessage || Описание ошибки на языке, переданном в параметре language в запросе. || -
|-
| orderStatus || Состояние заказа в платежной системе. ||
* 0 - Заказ зарегистрирован, но не оплачен
* 1 - Предавторизованная сумма захолдирована (для двухстадийных платежей)
* 2 - Проведена полная авторизация суммы заказа
* 6 - Авторизация отклонена
|-
| cardAuthInfo || Тэг с атрибутами платежа. ||
* expiration - Срок истечения действия карты в формате YYYYMM.
* cardholderName - Имя держателя карты.
* approvalCode - Код авторизации платежа. Поле фиксированной длины (6 символов), может содержать цифры и латинские буквы.
* pan - Маскированный номер карты, которая использовалась для оплаты.
|-
|}
</div></div>

=См.также=
[[Платежный шлюз]]

Обработка неподтвержденных сегментов - Блокировка перелётов

2019-10-11T17:30:28Z

Мария Горшенева: Мария Горшенева переименовал страницу Блокировка перелётов в Обработка неподтвержденных сегментов - Блокировка перелётов

==Назначение==
Данный функционал предназначен для временного удаления [[Результаты поиска|из выдачи результатов поиска]] перелетов, процесс проверки доступности или попытка [[Бронирование (Авиабилеты)|бронирования]] которых ранее завершились ошибкой, чтобы предлагать на выдаче результатов поиска только доступные перелеты.

==Принцип работы==
Функционал работает следующим образом: [[Пользователь|пользователь]] запускает поисковый запрос, после получения [[Результаты_поиска|результатов поиска]] выбирает конкретный перелет, и, если в процессе актуализации перелета или в момент [[Бронирование|бронирования]] система получает ошибку от поставщика (например, выбранный [[Класс_бронирования_(подкласс)|класс бронирования]] уже недоступен) по данному рейсу, то перелет будет занесен в список блокировки. При последующих поисках в зависимости от заданных настроек, описанных ниже, данный рейс не будет попадать в выдачу результатов.

Процесс проверки доступности или бронирования может завершиться ошибкой по следующим причинам:
* невалидный статус сегмента (статусы: NN, UC, UN, US, UU, DL, HQ, NO, PN, PQ, WK, WL, WN, XM, HX, LL, HL, BL, DS, GL, IX, JL, NA, OX, TL, CLO, NAV, UX, UNS, X, XX, YK),
* запрашиваемый [[тариф]] или [[Класс бронирования (подкласс)|класс]] недоступен,
* нет цен для указанного перелёта,
* для одного из [[сегмент]]ов перелёта нет доступных рейсов,
* изменилась стоимость перелета,
* прочие причины.
- Если известно, на каком [[Сегмент|сегменте]] перелета и литере недоступны места и данный сегмент не может продаваться отдельно, то блокируются все сегменты данной [[Авиакомпания|авиакомпании]].<br/>
- Если сегмент может продаваться отдельно, то блокируется только конкретный недоступный сегмент.<br/>
- Если неизвестно, какой именно сегмент имеет проблемный статус (например, в случае невозможности [[Тарификация|тарификации]]), то блокируются все сегменты.<br/>

{{Attention|Функционал, предложенный в Nemo.Travel и в Nemo.Connect настраивается и работает независимо друг от друга.}}

==Блокировка в Nemo.Travel ==

[[Категория:Модули]] [[Категория:Встроенные модули]]
'''Обработка неподтвержденных сегментов''' — модуль [http://nemo.travel системы онлайн-бронирования {{NameSystem}}].

# [[Фильтры результатов поиска (Авиабилеты)|Фильтр результатов поиска]] удаляет из выдачи перелеты, помещенные в список заблокированных перелетов.
# Если проблема повторилась до истечения времени первой блокировки перелета, то перелет повторно помещается в список на период повторной блокировки.
# Если проблема повторилась в течение суток после окончания повторной блокировки, перелёт помещается в список снова на период повторной блокировки.
# Если проблема не повторилась, то перелет удаляется из списка заблокированных перелетов.
# Если проблема возникла с перелетом, ранее удалённым из списка заблокированных, он помещается в список на период первой блокировки.

Временные интервалы первой и повторной блокировок устанавливаются в настройках модуля.

===Включение и настройка модуля===
Чтобы включить блокировку:
# Зайдите в раздел '''Управление продажами → Процессы → Фильтры результатов'''.
# Создайте правило фильтрации и включите в нем фильтр '''«... + перелёт заблокирован»'''.
# Зайдите в раздел '''Управление продажами → Процессы → Тонкая настройка'''.
# Установите:
#* ''Фильтры результатов включены'' в активное положение.
#* ''Время первой блокировки перелёта'' в часах (по умолчанию равно 1 часу).
#* ''Время повторной блокировки перелёта'' в часах (по умолчанию равно 1 часу).

{| class="wikitable"
|-
|[[Файл:фильтр блокировки.png|450px]]
|-
|Настройки фильтра блокировки перелета
|}

{| class="wikitable"
|-
|[[Файл:Время первой и повторной блокировки перелета.png|500px]]
|-
|Настройки времени блокировки перелета
|}

===Логирование заблокированных перелетов===
Для отслеживания заблокированных перелетов в {{NameSystem}} предусмотрено логирование на этапе проверки доступности и бронирования, которое доступно менеджеру агентства.
<div class="toccolours mw-collapsible mw-collapsed" style="width:800px">
<u>'''Пример лога блокировки перелета'''</u>
<div class="mw-collapsible-content">
<syntaxhighlight lang="text" enclose="div" style="font-size:9pt;background: #F9F9F9; padding: 10px 5px; margin: 10px 0;">
[DB] Новая запись "list_flights_banned(0)"
Array
(
[$bind] => Array
(
[ban_until] => 2016-05-12 17:47:18 время блокировки перелета
[flight_id] => 1272120004 идентификатор заблокированного перелета
[agency_id] => 2410 идентификатор агентства
[flight_begin] => 2016-07-01 дата вылета
)

[$result] => 1
)
</syntaxhighlight>
</div>
</div>

==Блокировка в Nemo.Connect==

Функционал настраивается в Nemo.Travel, но работает на стороне веб-сервисов ''Nemo.Connect'', следовательно, рейс будет блокироваться и при поиске напрямую через ''API Nemo.Connect''.

{{Attention|Перелёты из [[SITA_Gabriel|'''SITA Gabriel''']] не блокируются.}}

===Включение и настройка===
Настройки находятся по адресу: '''«Управление продажами» → «Авиабилеты» → «Процессы» → «Процесс поиска» → «[[Поиск (Авиабилеты)|Тонкая настройка]]»'''.

[[Файл:Bansettings.png|1000px]]

1) Для активации блокировки необходимо включить настройку '''Блокировать недоступные перелёты''' ''(включена по-умолчанию)''.

При ''выключенном'' состоянии сбор данных по недоступным перелётам продолжается, но фильтрация результатов не происходит.

2) '''Тип используемой блокировки недоступных перелётов''':

* ''В рамках GDS и PCC'' - выборка перелётов для блокировки происходит по всем значениям (описаны в таблице ниже) в связке GDS + PCC ''(по-умолчанию)'';

* ''В рамках GDS и Локации'' - выборка недоступных перелётов выполняется в связке GDS + Локация (страна) без [[PCC|PCC]]. Если страна в параметрах реквизита [[Глобальная_распределительная_система|GDS]] не задана, то она считается несуществующей, и блокировка будет применяться среди всех таких реквизитов данной GDS;

* ''В рамках GDS'' - выборка недоступных перелётов происходит в рамках одной GDS.
Пример:
Пакет реквизитов настроен таким образом, что поиск происходит в одних реквизитах в локации RU, а бронирование - в других реквизитах в локации US. Допустим, в процессе бронирования в ответе поставщика система получила ту или иную ошибку. В таком случае с большой долей вероятности при повторной попытке бронирования этот же перелёт пойдёт опять в локацию US и ошибка повторится, поэтому в результатах поиска его желательно блокировать.

3) '''Время блокировки недоступных перелётов''' - время, в течение которого недоступный перелёт будет заблокирован. Настройка задаётся в минутах, максимальное значение - 60 ''(по-умолчанию: 30)''.

===Просмотр блокировок===
Реализована возможность просмотра списка заблокированных в Nemo.Connect перелётов. Данная страница доступна только менеджеру корневого агентства и главному администратору.

Страница расположена в настройках в разделе '''«Управление продажами» → «Авиабилеты » → «Процессы» → «Процесс поиска» → «Блокировки недоступных рейсов»'''.

[[Файл:Banlist.png|1200px]]

* ''Значения:''
<table class="wikitable">
<tr>
<td>Столбец</td>
<td>Пример</td>
<td>Описание</td>
</tr>
<tr>
<td>Сегмент</td>
<td>0219/LED-DME/U692/O</td>
<td>0219 - месяц и число рейса, LED-DME - аэропорты отправления и прибытия, U6 - маркетинговый перевозчик, 92 - номер рейса, O - литера класса бронирования</td>
</tr>
<tr>
<td>Поставщик </td>
<td>Sabre</td>
<td>ГДС</td>
</tr>
<tr>
<td>Реквизиты</td>
<td>7DYG</td>
<td>реквизиты подключения ГДС</td>
</tr>
<tr>
<td>Расположение</td>
<td>RU</td>
<td>локация</td>
</tr>
<tr>
<td>Дата и время</td>
<td>2018-02-13T12:24:40</td>
<td>ГГГГ-ММ-ДД ЧЧ:ММ:СС - время занесения в список</td>
</tr>
<tr>
<td>ID события</td>
<td>142285179</td>
<td>уникальный номер события в логах Nemo Connect, по которому рейс был заблокирован</td>
</tr>
<tr>
<td>Тип блокировки</td>
<td>C</td>
<td>тип блокировки. Возможные значения: F (no fare), C (no booking class)</td>
</tr>
</table>

* Чтобы очистить список блокировок у агентства, необходимо использовать кнопку '''«Очистить кэш блокировок»''' над списком.

==См. также==
* [[Результаты поиска]]
* [[Поиск (Авиабилеты)]]
* [[Фильтры результатов поиска (Авиабилеты)]]

[[Категория:Настройки]]
''Ключевые слова: бан перелетов, бан сегментов''

Блокировка перелётов

2019-10-11T17:30:28Z

#перенаправление [[Обработка неподтвержденных сегментов - Блокировка перелётов]]

MoneyWall

2019-08-16T12:24:49Z

Мария Горшенева: /* Настройка платежного шлюза MoneyWall на стороне Nemo */

'''MoneyWall''' — сервис оплаты авиабилетов частями. С помощью сервиса Moneywall вы можете покупать авиабилеты, разделив оплату на три равные части. Всё, что для этого требуется, – заполнить форму с паспортными данными, загрузить фото паспорта и авторизоваться через социальную сеть. Весь процесс занимает 2 минуты.

== Преимущества сервиса ==
* простота оформления – требуются только паспорт и авторизация в социальной сети.
* моментальное решение по кредиту – ваша бронь авиабилетов не будет отменена.
* фиксированная цена услуги – никаких скрытых комиссий и платных услуг.
* нет штрафа за досрочное погашение – в любой момент вы можете погасить кредит.

== Условия ==
* стоимость услуги: от 0 до 20% от стоимости заказа.
* 0% при погашении в течение 7 дней со дня одобрения.
* сумма покупки должна быть не более 500 000 рублей.
* оплата банковской картой.
* максимальный срок рассрочки: 64 дня.

== Как купить авиабилет с оплатой частями? ==
* выберите нужный авиабилет и забронируйте его.
* на странице оплаты выберите Moneywall и заполните анкету.
* внесите первый платеж и моментально получите на почту электронный билет.

== Как происходит дальнейшая оплата? ==
* очередной платеж автоматически спишется с вашей карты в день погашения кредита.
* если с вашей картой что-то случилось, вы можете привязать другую в личном кабинете на сайте www.moneywall.io.

== Досрочное погашение ==
В любой момент можно оплатить билет полностью или частично в личном кабинете на сайте www.moneywall.io
Подробнее об условиях можно узнать на сайте www.moneywall.io и по телефону +7 499 110-93-17.

== Настройка платежного шлюза MoneyWall на стороне Nemo ==
Для данного способа оплаты доступны следующие настройки:
* '''Включить тестовый режим''' - активация тестового режима.
* '''Секретный ключ''' - уникальный код, который предоставляется службой технической поддержки MoneyWall.
* '''Оплата во фрейме''' (ID договора/проекта) – включает режим отображения во фрейме.
* '''Высота фрейма''' - необязательное поле. Позволяет корректировать высоту фрейма.

== Взаимодействие между Nemo и MoneyWall==
# На поисковой выдаче отображается размер ежемесячного платежа. [[Файл:Ежемесячный_платеж.png|center]]
# Пользователь бронирует заказ и выбирает способ оплаты MoneyWall. [[Файл:Отображение_шлюза_на_чекауте.png|center]]
# После перехода на страницу MoneyWall нажимает кнопку '''«Оформить заявку»'''. Подтверждение заявки требует некоторого времени. Заявка может быть отклонена.[[Файл:Оформление_заявки.png|center]]
# Отображается страница для ввода SMS кода, отправленного на указанный телефонный номер в блоке '''Покупатель''' на форме бронирования. [[Файл:Ввод_SMS_кода.png|center]]
# Пользователь вводит код из SMS и происходит переход на страницу ввода паспортных данных. [[Файл:Ввод_паспортных_данных.png|center]]
# Пользователь нажимает на кнопку '''Далее''' и происходит переход на страницу привязки профилей социальных сетей, где необходимо привязать хотя бы одну социальную сеть. [[Файл:Социальные_сети.png|center]]
# Пользователь нажимает на кнопку '''Далее''' и происходит переход на страницу загрузки фотографий документов. [[Файл:Фотографии_документов.png|center]]
# Пользователь нажимает на кнопку '''Отправить заявку'''и происходит переход на страницу вноса первоначального платежа. [[Файл:Первоначальный_платеж.png|center]]
# Пользователь нажимает на кнопку '''Сделать первоначальный платеж''' и переходит на страницу ввода данных карты или к списку выбора ранее сохраненных карт. [[Файл:Выбор_карты.png|center]] [[Файл:Ввод_данных_карты.png|center]]
# Пользователь нажимает на кнопку '''Оплатить''' и переходит на страницу подтверждения платежа,где необходимо кликнуть на знак большого пальца вверх, после чего происходит переход на страницу с заказом. [[Файл:Подтверждение_платежа.png|center]]

== Процесс подключения к MoneyWall==
Связаться с moneywall.io и получить секретный ключ.

== Языковые переменные ==
new-passinfo-priceCalc__formula__total - Цена авиабилета

new-passinfo-priceCalc__formula__first_payment - Первый из 3-х платежей

payments_gatewayMoneyWall_header - Оплата частями

== См. также ==
* [[Платежные шлюзы]]

MoneyWall

2019-05-30T14:30:17Z

Мария Горшенева: /* Возможности и преимущества сервиса */

'''MoneyWall''' — сервис оплаты авиабилетов частями. MoneyWall позволит разделить стоимость авиабилета на 3 равных платежа с погашением в течение 64 дней.

== Возможности и преимущества сервиса ==
* простота оформления – клиенту требуется только паспорт и авторизация в социальной сети
* моментальное решение по кредиту – бронь авиабилетов не будет отменена
* фиксированная цена услуги – никаких скрытых комиссий и платных услуг
* очередной платеж спишется с карты клиента в день погашения кредита
* партнер получает полную стоимость авиабилета сразу, как при обычной продаже
* Moneywall выплачивает комиссию партнеру

== Настройка платежного шлюза MoneyWall на стороне Nemo ==
Для данного способа оплаты доступны следующие настройки:
* '''Включить тестовый режим''' - активация тестового режима.
* '''Секретный ключ''' - уникальный код, который предоставляется службой технической поддержки MoneyWall.
* '''Оплата во фрейме''' (ID договора/проекта) – включает режим отображения во фрейме.
* '''Высота фрейма''' - позволяет задать значение высоты фрейма.

== Взаимодействие между Nemo и MoneyWall==
# На поисковой выдаче отображается размер ежемесячного платежа. [[Файл:Ежемесячный_платеж.png|center]]
# Пользователь бронирует заказ и выбирает способ оплаты MoneyWall. [[Файл:Отображение_шлюза_на_чекауте.png|center]]
# После перехода на страницу MoneyWall нажимает кнопку '''«Оформить заявку»'''. Подтверждение заявки требует некоторого времени. Заявка может быть отклонена.[[Файл:Оформление_заявки.png|center]]
# Отображается страница для ввода SMS кода, отправленного на указанный телефонный номер в блоке '''Покупатель''' на форме бронирования. [[Файл:Ввод_SMS_кода.png|center]]
# Пользователь вводит код из SMS и происходит переход на страницу ввода паспортных данных. [[Файл:Ввод_паспортных_данных.png|center]]
# Пользователь нажимает на кнопку '''Далее''' и происходит переход на страницу привязки профилей социальных сетей, где необходимо привязать хотя бы одну социальную сеть. [[Файл:Социальные_сети.png|center]]
# Пользователь нажимает на кнопку '''Далее''' и происходит переход на страницу загрузки фотографий документов. [[Файл:Фотографии_документов.png|center]]
# Пользователь нажимает на кнопку '''Отправить заявку'''и происходит переход на страницу вноса первоначального платежа. [[Файл:Первоначальный_платеж.png|center]]
# Пользователь нажимает на кнопку '''Сделать первоначальный платеж''' и переходит на страницу ввода данных карты или к списку выбора ранее сохраненных карт. [[Файл:Выбор_карты.png|center]] [[Файл:Ввод_данных_карты.png|center]]
# Пользователь нажимает на кнопку '''Оплатить''' и переходит на страницу подтверждения платежа,где необходимо кликнуть на знак большого пальца вверх, после чего происходит переход на страницу с заказом. [[Файл:Подтверждение_платежа.png|center]]

== Процесс подключения к MoneyWall==
Связаться с moneywall.io и получить секретный ключ.

== Языковые переменные ==
new-passinfo-priceCalc__formula__total - Цена авиабилета

new-passinfo-priceCalc__formula__first_payment - Первый из 3-х платежей

== См. также ==
* [[Платежные шлюзы]]

MoneyWall

2019-05-30T14:29:58Z

Мария Горшенева:

'''MoneyWall''' — сервис оплаты авиабилетов частями. MoneyWall позволит разделить стоимость авиабилета на 3 равных платежа с погашением в течение 64 дней.

== Возможности и преимущества сервиса ==
* простота оформления – клиенту требуется только паспорт и авторизация в социальной сети
* моментальное решение по кредиту – бронь авиабилетов не будет отменена
* фиксированная цена услуги – никаких скрытых комиссий и платных услуг
* очередной платеж спишется с карты клиента в день погашения кредита
* партнер получает полную стоимость авиабилета сразу, как при обычной продаже

Moneywall выплачивает комиссию партнеру
== Настройка платежного шлюза MoneyWall на стороне Nemo ==
Для данного способа оплаты доступны следующие настройки:
* '''Включить тестовый режим''' - активация тестового режима.
* '''Секретный ключ''' - уникальный код, который предоставляется службой технической поддержки MoneyWall.
* '''Оплата во фрейме''' (ID договора/проекта) – включает режим отображения во фрейме.
* '''Высота фрейма''' - позволяет задать значение высоты фрейма.

== Взаимодействие между Nemo и MoneyWall==
# На поисковой выдаче отображается размер ежемесячного платежа. [[Файл:Ежемесячный_платеж.png|center]]
# Пользователь бронирует заказ и выбирает способ оплаты MoneyWall. [[Файл:Отображение_шлюза_на_чекауте.png|center]]
# После перехода на страницу MoneyWall нажимает кнопку '''«Оформить заявку»'''. Подтверждение заявки требует некоторого времени. Заявка может быть отклонена.[[Файл:Оформление_заявки.png|center]]
# Отображается страница для ввода SMS кода, отправленного на указанный телефонный номер в блоке '''Покупатель''' на форме бронирования. [[Файл:Ввод_SMS_кода.png|center]]
# Пользователь вводит код из SMS и происходит переход на страницу ввода паспортных данных. [[Файл:Ввод_паспортных_данных.png|center]]
# Пользователь нажимает на кнопку '''Далее''' и происходит переход на страницу привязки профилей социальных сетей, где необходимо привязать хотя бы одну социальную сеть. [[Файл:Социальные_сети.png|center]]
# Пользователь нажимает на кнопку '''Далее''' и происходит переход на страницу загрузки фотографий документов. [[Файл:Фотографии_документов.png|center]]
# Пользователь нажимает на кнопку '''Отправить заявку'''и происходит переход на страницу вноса первоначального платежа. [[Файл:Первоначальный_платеж.png|center]]
# Пользователь нажимает на кнопку '''Сделать первоначальный платеж''' и переходит на страницу ввода данных карты или к списку выбора ранее сохраненных карт. [[Файл:Выбор_карты.png|center]] [[Файл:Ввод_данных_карты.png|center]]
# Пользователь нажимает на кнопку '''Оплатить''' и переходит на страницу подтверждения платежа,где необходимо кликнуть на знак большого пальца вверх, после чего происходит переход на страницу с заказом. [[Файл:Подтверждение_платежа.png|center]]

== Процесс подключения к MoneyWall==
Связаться с moneywall.io и получить секретный ключ.

== Языковые переменные ==
new-passinfo-priceCalc__formula__total - Цена авиабилета

new-passinfo-priceCalc__formula__first_payment - Первый из 3-х платежей

== См. также ==
* [[Платежные шлюзы]]

MoneyWall

2019-05-30T14:29:40Z

Мария Горшенева:

'''MoneyWall''' — сервис оплаты авиабилетов частями. Moneywall позволит разделить стоимость авиабилета на 3 равных платежа с погашением в течение 64 дней.

== Возможности и преимущества сервиса ==
* простота оформления – клиенту требуется только паспорт и авторизация в социальной сети
* моментальное решение по кредиту – бронь авиабилетов не будет отменена
* фиксированная цена услуги – никаких скрытых комиссий и платных услуг
* очередной платеж спишется с карты клиента в день погашения кредита
* партнер получает полную стоимость авиабилета сразу, как при обычной продаже

Moneywall выплачивает комиссию партнеру
== Настройка платежного шлюза MoneyWall на стороне Nemo ==
Для данного способа оплаты доступны следующие настройки:
* '''Включить тестовый режим''' - активация тестового режима.
* '''Секретный ключ''' - уникальный код, который предоставляется службой технической поддержки MoneyWall.
* '''Оплата во фрейме''' (ID договора/проекта) – включает режим отображения во фрейме.
* '''Высота фрейма''' - позволяет задать значение высоты фрейма.

== Взаимодействие между Nemo и MoneyWall==
# На поисковой выдаче отображается размер ежемесячного платежа. [[Файл:Ежемесячный_платеж.png|center]]
# Пользователь бронирует заказ и выбирает способ оплаты MoneyWall. [[Файл:Отображение_шлюза_на_чекауте.png|center]]
# После перехода на страницу MoneyWall нажимает кнопку '''«Оформить заявку»'''. Подтверждение заявки требует некоторого времени. Заявка может быть отклонена.[[Файл:Оформление_заявки.png|center]]
# Отображается страница для ввода SMS кода, отправленного на указанный телефонный номер в блоке '''Покупатель''' на форме бронирования. [[Файл:Ввод_SMS_кода.png|center]]
# Пользователь вводит код из SMS и происходит переход на страницу ввода паспортных данных. [[Файл:Ввод_паспортных_данных.png|center]]
# Пользователь нажимает на кнопку '''Далее''' и происходит переход на страницу привязки профилей социальных сетей, где необходимо привязать хотя бы одну социальную сеть. [[Файл:Социальные_сети.png|center]]
# Пользователь нажимает на кнопку '''Далее''' и происходит переход на страницу загрузки фотографий документов. [[Файл:Фотографии_документов.png|center]]
# Пользователь нажимает на кнопку '''Отправить заявку'''и происходит переход на страницу вноса первоначального платежа. [[Файл:Первоначальный_платеж.png|center]]
# Пользователь нажимает на кнопку '''Сделать первоначальный платеж''' и переходит на страницу ввода данных карты или к списку выбора ранее сохраненных карт. [[Файл:Выбор_карты.png|center]] [[Файл:Ввод_данных_карты.png|center]]
# Пользователь нажимает на кнопку '''Оплатить''' и переходит на страницу подтверждения платежа,где необходимо кликнуть на знак большого пальца вверх, после чего происходит переход на страницу с заказом. [[Файл:Подтверждение_платежа.png|center]]

== Процесс подключения к MoneyWall==
Связаться с moneywall.io и получить секретный ключ.

== Языковые переменные ==
new-passinfo-priceCalc__formula__total - Цена авиабилета

new-passinfo-priceCalc__formula__first_payment - Первый из 3-х платежей

== См. также ==
* [[Платежные шлюзы]]

Микшер Nemo Connect

2019-04-03T11:36:49Z

Мария Горшенева: /* Включение микшера Авиа сервера */

==Назначение==
Микшер Авиа сервера используется для удаления дубликатов перелетов полученные из нескольких источников, оставляя самый выгодный для агентства (по ценовому признаку или по поставщику). По своему функционалу схож с [[Микшер_результатов_поиска_(Авиабилеты)#Микшер результатов поиска {{NameProject2}}|микшером результатов поиска {{NameProject2}}]], за исключением того, что правила а также настройки для его включения задаются в админ панели Немо Тревел 1.0.

{{Attention| Репрайсинг возможен только с включенным микшером. }}
{{Attention|Для корректного взаимодействия плагинов используйте ''Микшер результатов поиска {{NameProject2}}'' только если ''[[Фильтры результатов поиска {{NameProject2}}|Фильтры результатов]]'' включены тоже на {{NameProject2}}.}}

==Включение микшера Авиа сервера==

{| class="wikitable" align="center" style="margin-left:1em"
|-
|[[Файл:Микшер Nemo Connect.png|справа|1100px|Внешний вид таблицы с правилами]]
|-
|Внешний вид таблицы с правилами
|}

Чтобы включить микшер Авиа сервера
'''Администратору необходимо''':
# Зайдите в раздел '''Для техподдержки → {{NameProject2}} Вебсервисы → Настройки Взаимодействия'''.
# Включить опцию '''Настройки микшера''' в разделе '''Использовать настройки в Авиа сервере из Немо 1 для разделов'''. В случае, если данная настройка включена не будет, то при включении маршрутизатор {{NameProject2}} настройки будут подтягиваться из админ панели {{NameProject2}}

'''Менеджеру необходимо''':
# Зайдите в раздел '''Управление продажами → Авиабилеты → Процессы → Процесс поиска → Тонкая настройка'''.
# '''Включите''' опцию '''Использовать маршрутизатор {{NameProject2}}'''.
# '''Включите''' опцию '''Объединение поисков для {{NameProject2}}'''.
# '''Включите''' опцию '''Выполнять ценообразование на сервере NEMO2.0'''.
# '''Включите''' опцию '''Микшер результатов включен'''
# '''Выберите''' опцию '''Каким образом определять дубликаты перелетов'''
#*'''По литере''' — микширование результатов по классу бронирования пассажира самолета, путешествующего в определенном классе.
#*'''По базовому классу''' — микширование результатов по классу обслуживания (эконом, бизнес, первый и др.).
#*'''По семействам тарифов''' - микширование перелётов в рамках RBD(литеры)/базового класса/семейства тарифов.

== Создание правил микширования для Авиа сервера==

Чтобы создать правило маршрутизации:

# Зайдите в раздел '''Управление продажами → Авиабилеты → Поисковые настройки → Процессы → Процесс поиска → Микшер результатов → {{NameProject2}}'''
# Нажмите '''Создать новую запись'''.
# Задайте параметры правила (см. [[Микшер_результатов_поиска_(Авиабилеты)#Создание правила микширования результатов поиска для указанных авиакомпаний|Создание правила микширования результатов поиска для указанных авиакомпаний]])
# Нажмите кнопку '''Сохранить'''.
{| class="wikitable" align="center" style="margin-left:1em"
|-
|[[Файл:Создание микшера.png|справа|1100px|Создание правила]]
|-
|Создание правила
|}

== Импорт и отладка правил микширования ==
Помимо создания правил, вы можете импортировать правила из Админ панели {{NameProject2}}. Система полностью перенесет все настройки из связанного агентства {{NameProject2}}.
Агентство задается под администратором в разделе '''Для техподдержки → {{NameProject2}} Вебсервисы → Настройки взаимодействия'''. Там нужно заполнить следующие поля:
* Идентификатор пользователя в {{NameProject2}}.
* Логин пользователя в {{NameProject2}}.
* Пароль пользователя в {{NameProject2}}.
* Используемая среда .net серверов
После импорта в целях отладки и проверки совпадения настроек можно включить настройку '''Включить логирование отличия настроек Nemo Travel от {{NameProject2}} для: → Псевдопоиск перелётов''' в разделе '''Для техподдержки → {{NameProject2}} Вебсервисы → Настройки взаимодействия''' . Если настройки Nemo Travel будут отличаться от настроек {{NameProject2}}, вы увидите в сервисных логах следующее сообщение: '''Различия в параметрах настроек псевдопоиска перелётов Nemo1 и Nemo2.''' Если же настройки будут идентичны, то сообщения не будет.

При создании правил в панели администрирования {{NameProject1}} в разделе '''Управление продажами → Процессы → Процессы поиска → Микшер результатов → {{NameProject2}}''' необходимо обратить внимание на то, что данные настройки должны соответствовать тем настройкам, которые заведены в панели администрирования {{NameProject2}} в разделе '''Настройки Авиа → Поисковые настройки → Настройки микшера'''. В случае не соответствия, в логах результатов поиска можно получить сообщение о таком несоответствии. Важно учитывать, что данное сообщение не является сообщением об ошибке системы , а является лишь предупреждением об отличиях в настройках микшеров {{NameProject1}} и {{NameProject2}}.

{{Attention|При импорте настроек ваши текущие правила микширования удаляются. }}

== См. также==
*[[Маршрутизатор поисковых запросов]]
*[[Маршрутизатор поисковых запросов Немо Тревел 1.0]]
*[[Маршрутизатор поисковых запросов {{NameProject2}}]]
*[[Поиск (Авиабилеты)]]
*[[Пакеты реквизитов {{NameProject2}}]]
*[[Микшер результатов поиска (Авиабилеты)]]
*[[Псевдопоиск перелётов]]

Farelogix

2019-04-02T08:21:40Z

Мария Горшенева: /* Farelogix */

= Farelogix=
'''Farelogix NDC API''' — API, разработанное компанией Farelogix по новому формату NDC (New Distribution Capability), разработанному в IATA.

На данный момент в Farelogix поддерживаются а/к Lufthansa Group, основными из которых являются Lufthansa(LH), Austrian(OS), Swiss(LX), Brussels(SN), Aegean Airlines (A3) и Olympic Air (OA).

== Подключение Farelogix NDC в Nemo.Travel ==
В результате обращения и согласования условий с Farelogix агент должен получить необходимые реквизиты.

Полученные реквизиты нужно передать в {{NameSystem}} для формирования боевой конфигурации подключения.

При запросе новых PCC выдаются учетные записи для доступа к системе SPARK по адресу https://dcwebc.farelogix.com/sprk-multi/ , а так же для доступа к XML шлюзам, которые используются только для указания в реквизитах на стороне {{NameSystem}}.

{{Attention|В связи со строгим ограничением look2book со стороны поставщика, после подключения реквизита необходимо создать [[Фильтры поисковых запросов (Авиабилеты)|фильтры запросов]] по расписанию авиакомпаний в панели администрирования.}}

== Особенности Farelogix==
# Разделение (split) PNR разрешено только для пассажиров с контактными данными.
# Реализовано довнесение и модификация пассажирских данных в брони.
# Реализовано внесение карточек лояльности.
# Модификация бронирования запрещена после выписки.
# Хотя бы у одного пассажира должна быть контактная информация.
# Возраст детей определяется по 1му сегменту перелёта.
# Есть ограничение на количество символов в ФИО равное 32 символам в сумме для каждого из пассажиров.
# Комиссия Авиакомпании определяется на стороне шлюза автоматически.
# На данный момент валюта выдачи настраивается только на стороне поставщика.
# Размножение из пакетов с валютой отличной от пакета Farelogix невозможно.
# Для паспортных данных пассажира установлено ограничение в 15 символов.

== См. также ==
* [[Пакеты реквизитов Nemo Connect]]
* [[S7 NDC]]
* [[Фильтры поисковых запросов (Авиабилеты)]]

Отели

2019-03-28T07:35:03Z

Мария Горшенева: /* Особенности работы с Отели 2.0 */

[[Категория: Настройки]]
[[Категория:Модули]]
[[Категория:Дополнительные модули]]
'''Отели 2.0''' — [[компонент]] системы {{NameSystemLink}}.

==Описание==
[[Файл:Результаты поиска.png|thumb|300px|Результаты поиска]]
Компонент '''Отели 2.0''' подключается администратором {{NameSystem}} по запросу агентства. Для подключения опции для агентства направьте запрос в проектный трекер системы.

'''Компонент располагает следующими возможностями:'''
* '''Поиск''' отелей по следующему набору критериев:
** фиксированные даты заезда/выезда из отеля,
** количество ночей,
** количество номеров,
** количество человек в номере,
** местоположение объекта. <br>Программа позволяет осуществлять поиск до 4 номеров одновременно на группу не более 9 человек.
Поиск отелей (комнат, готовых к бронированию) по умолчанию осуществляется среди комнат со "свободной продажей". Для отелей от поставщиков ContentInn, Akadem и Travelport есть возможность получать для бронирования комнаты "по-запросу". Для включения функционала в реквизитах поставщика нужно обратиться к администратору системы {{NameSystem}}. 
* '''Результаты поиска''' отелей выдаются списки доступных для бронирования отелей, с возможностью перейти к '''детальной информации''' при выборе конкретного отеля. <br>На поисковой выдаче доступны следующие '''фильтры''':
** по названию отеля,
** по цене за 1 ночь,
** по звездности,
** по набору услуг и удобств,
** а также по специальным предложениям. [[Файл:Выбор_номеров.png|thumb|300px|Выбор номеров]]
* После перехода на этап просмотра детальной информации об отеле необходимо выбрать подходящий номер для перехода на '''форму бронирования''', так же на этом этапе доступны для просмотра следующие информационные разделы:
** информация об отеле,
** удобства,
** правила отеля.
* Форма бронирования содержит поля ввода данных о пользователях услуг, необходимых для завершения транзакции бронирования: пол, ФИО, даты рождения, электронная почта. <br>После выбора способа оплаты и клика на "продолжить", система производит действительное бронирование. После того, как бронирование успешно завершено, ваучер отправляется на указанный адрес электронной почты, также ваучер доступен по клику на '''Мои билеты'''.
===Карта лояльности===
Многие сетевые отели имеют карты лояльности. Они созданы для того, чтобы посетитель отеля в будущем выбирал именно их сеть отелей. В системе Nemo.travel реализована возможность указания на форме номера своей карты. Для этого нужно нажать на кнопку "Карта лояльности" и ввести туда название сети отелей и номер своей карты. В данный момент работу с картами лояльности поддерживает только поставщик Travelport. [[Файл:Loyaltycard.jpg|thumb|right|400px|Ввод карты лояльности]]

==Настройка компонента==
===Параметры для настройки поиска===
Параметры для настройки поиска расположены в разделе '''Управление продажами → Отели → Настройки поиска'''.

Реквизиты для поиска отелей — сообщает системе, каким поставщикам отельного контента необходимо отправлять запрос. Если нужно опрашивать несколько поставщиков, то следует отметить галочками требуемых поставщиков контента. Предварительно нужно убедиться, что для текущего агентства специалистами технической поддержки прописаны реквизиты подключения.

* '''Реквизиты для поиска отелей''':
** '''''Все''''' - для поиска отелей будут использоваться все реквизиты.
** '''''Выбранные''''' - выберите один реквизит или несколько реквизитов для поиска.

===Управление ценами===
Подробное описание возможностей системы по управлению ценами и инструкцию по настройке смотрите в разделе [[Ценообразование (Отели)]].

===Параметры для настройки ваучера отелей===
Шаблон, по которому формируется ваучер, настраивается на странице '''Настройки системы → Нотификации и документы → Документы → Ваучер для отеля'''.

Перед настройкой необходимо выбрать необходимый '''Тип документа''', то есть поставщика, для которого будет работать данный шаблон:
* Hotelston
* Academ_net
* Travelport
* ContentInn
* Ostrovok
* Amadeus Hotels

====Переменные шаблона====
<div class="toccolours mw-collapsible mw-collapsed" style="width:800px">
<u>'''Справочник шаблонных переменных ваучера для отелей'''</u>
<div class="mw-collapsible-content">

{| class="wikitable" id="keys" style="width: 100%" border="1" cellpadding="5" cellspacing="0"
|-
! Переменная
! Описание переменной
|-
|%AGENCY_NAME%
|Название агентства
|-
|%AGENCY_LOGO%
|Лого агентства (изображение логотипа агентства должно быть в формате JPG или PNG)
|-
|%AGENCY_ADDRESS%
|Адрес агентства
|-
|%AGENCY_PHONE%
|Телефон агентства
|-
|%CLIENT_NAME%
|Имя заказчика
|-
|%CLIENT_PHONE%
|Телефон заказчика
|-
|%BOOKING_ID%
|ID услуги в системе
|-
|%DATA%
|Дата
|-
|%%FORM_OF_PAYMENT%
|Форма оплаты
|-
|%PAYMENT_DATE%
|Дата оплаты
|-
|%TOTAL_PRICE%
|Стоимость заказа (в валюте агентства)
|-
|%DATE_IN%
|Дата въезда
|-
|%DATE_OUT%
|Дата выезда
|-
|%ROOMS_COUNT%
|Количество номеров
|-
|%Nights%
|Количество ночей
|-
|%ROOM_NAME%
|Название номера
|-
|%ROOM_MEALS%
|Питание в номере
|-
|%ROOM_PERSON_LASTNAME%
|Фамилия туриста (в комнате)
|-
|%ROOM_PERSON_NAME%
|Имя туриста (в комнате)
|-
|%ROOM_PERSON_PATRONYMIC%
|Отчество туриста (в комнате)
|-
|%ROOM_PERSON_TYPE%
|Тип туриста (в комнате)
|-
|%ROOM_PERSON_AGE%
|Возраст туриста (в комнате)
|-
|%HOTEL_NAME%
|Название отеля
|-
|%CITY%
|Город
|-
|%COUNTRY%
|Страна
|}

</div>
</div>

Чтобы указать в маршрут-квитанции информацию о нескольких пассажирах, используются группы. Они лишь объединяют другие переменные и самостоятельными параметрами не обладают, на данный момент доступны две группы:
* для информации по номерам используйте группу %ROOM%,
* для информации о постояльцах в комнатах группу %ROOM_PERSON%.

== Особенности работы с Отели 2.0 ==

Так как для модулей «Поиск авиабилетов 2.0» и «Отели 2.0» используются схожие формы бронирования, изменять настройки отображения формы бронирования модуля «Отели 2.0» возможно в разделе настроек '''Управление продажами → Авиабилеты → Процессы → Форма бронирования'''.

Если для выбранного номера на момент оформления заказа нет штрафов за отмену брони, либо штрафы вступают в силу, начиная с определенной даты в будущем, то оформление заказа (бронь совместно с выпиской) возможно без оплаты. Клиент в таком случае может оплатить заказ позже. Если на момент наступления штрафов заказ не будет оплачен, он аннулируется системой автоматически.

* {{Attention|для корректного отображения места расположения отеля на карте настоятельно рекомендуется получить и внести API ключ для доступа к сервису Google Maps в разделе настроек '''Управление сайтом → Домены и протоколы''', настройка «API GOOGLE MAP ключ»; а также "Ключ для Google Maps API" в разделе '''Настройка системы → Интеграция → Nemo1.0(JSON API)'''.}}

== См. также ==

* [[ContentInn]]
* [[Академсервис]]
* [[Бронирование]]
* [[Туроператор (ТО)]]
* [[Статистика#Статистика поставщиков|Статистика поставщиков]]
* [[Объект размещения#Функциональные возможности поставщиков наземных услуг|Функциональные возможности поставщиков наземных услуг]]

Ostrovok

2019-03-28T07:34:26Z

Мария Горшенева: /* Особенности работы с Ostrovok.ru */

[[Категория:Поставщики наземных услуг]]
'''Ostrovok.ru''' — [[Файл:Ostrovok.png|right|400px|ContentInn.jpg]] это cервис онлайн-бронирования отелей в 220 странах мира. Был основан в 2011 году, офис компании базируется в Москве. Всего на сайте можно найти свыше 900 000 вариантов отелей, хостелов и апартаментов по всему миру.

== Подключение к Ostrovok.ru==
Для подключения компонента [[Отели]] системы {{NameSystem}}, работающего с системой Ostrovok.ru, клиенту необходимо обратиться в [https://partner.ostrovok.ru/affiliate/ Ostrovok.ru] за реквизитами подключения. После того, как реквизиты будут получены, необходимо создать заявку на подключение модуля в проектном трекере [http://helpdesk.nemo.travel helpdesk.nemo.travel], предоставив данные реквизиты (key_id, key).

{{Attention| Подключение и настройка реквизитов подключения к данному поставщику для компонента «Отели 2.0» производится администратором системы {{NameSystem}}.}}

== Особенности работы с Ostrovok.ru==

Поставщик Ostrovok.ru имеет следующие особенности:

* Поддерживается поиск только одной комнаты в запросе
* В комнате может быть не более 6 взрослых, но не менее одного, и не более 4 детей
* Возраст ребенка не должен превышать 17 лет
* Возраст детей при поиске указывать обязательно
* При подтверждении бронирования поставщику передается IP-адрес конечного пользователя
* При подтверждении необходимо передавать действующие e-mail адрес и контактный номер клиента
* Данные гостей при подтверждении будут отправлены поставщику в транслитерированном виде

При работе в тестовой среде накладываются дополнительные ограничения

* Фамилии всех гостей должны быть Ostrovok.ru
* Бронирование доступно только в тестовом отеле (ID: test_hotel, город Белогорск)
* Бронирования, созданные в тестовой среде, являются настоящими бронированиями, с такими же финансовыми обязательствами, как при бронировании настоящего отеля. По этой причине попытка подтверждения бронирования с невозвратным тарифом в тестовой среде вызовет ошибку. Кроме того, необходимо отменять '''все''' тестовые бронирования.

* {{Attention|для корректного отображения места расположения отеля на карте настоятельно рекомендуется получить и внести API ключ для доступа к сервису Google Maps в разделе настроек '''Управление сайтом → Домены и протоколы''', настройка «API GOOGLE MAP ключ»; а также "Ключ для Google Maps API" в разделе '''Настройка системы → Интеграция → Nemo1.0(JSON API)'''.}}

== Возможные ошибки ==
=== При поиске ===
{| class="wikitable"
! Ошибка !! Описание
|-
| Search for multiple rooms is not supported by Ostrovok || Попытка поиска по нескольким комнатам. Не поддерживается поставщиком
|-
| Check out date must be within 30 days after check in || Дата выезда должна быть не позднее 30 дней от даты заезда
|-
| In a room must be at least 1 adult || В комнате должен присутствовать как минимум один взрослый
|-
| Maximum number of adults in room is 6 || В комнате должно быть не более 6 взрослых
|-
| Maximum number of children in room is 4 || В комнате должно быть не более 4 детей
|-
| Only guests 17 years old or younger are considered to be children || Возраст ребенка не может превышать 17 лет
|}
=== При бронировании ===
{| class="wikitable"
! Ошибка !! Описание
|-
| Email is required for booking || Для бронирования необходим адрес электронной почты клиента
|-
| Phone number is required for booking || Для бронирования необходим номер телефона клиента
|-
| Guest name is not valid || Имя или фамилия гостя некорректны. Имя должно состоять из латинских и кириллических символов, может содержать пробелы, точки и тире
|-
| cannot_reserve_via_api || Вы не можете бронировать через API. Обратитесь в техническую поддержку
|-
| credit_card_required || Для бронирования нужны данные кредитной карты
|-
| insufficient_b2b_balance || Недостаточно средств на балансе b2b бронирований
|-
| invalid_email || Недействительный email. Необходимо использовать настоящий адрес
|-
| luhn_algorithm_error || Карта не прошла проверку по алгоритму Луна (алгоритм валидации номера карты по контрольной сумме)
|-
| rate_expired / rate_not_found || Тариф не найден. С момента поиска прошло много времени или номер был забронирован. Нужно повторить поиск

|}



Следующие ошибки могут возникнуть во время процесса подтверждения бронирования. Обратите внимание, что бронирование в этом случае считается неуспешным, но сохраняется у поставщика. Необходимо создать новое бронирование.
{| class="wikitable"
! Ошибка !! Описание
|-
| not_allowed || Попытка(и) бронирования заблокирована(ы). При возникновении данной ошибки, следует обратиться в службу поддержки, уточнив, что возникает ошибка при попытке бронирования
|-
| soldout || Тариф более недоступен на момент попытки бронирования, т.к. был распродан
|-
| provider || Техническая ошибка у источника тарифа
|-
| bank || Банк отменил транзакцию
|-
| block / charge || Ошибка авторизации карты
|-
| amount_exceed_balance || Недостаточно средств
|-
| 3ds || Невалидный 3ds код
|}
=== При аннуляции ===
{| class="wikitable"
! Ошибка !! Описание
|-
| cancellation_unavailable_status || Некорректный статус бронирования. Можно отменить только бронирования со статусом Booked, New или Confirmed
|-
| cancellation_error_policy || Нарушение политики отмены
|-
| cancellation_error_provider || Ошибка провайдера. Свяжитесь со службой технической поддержки
|-
| cancellation_error_unknown || Внутренняя ошибка поставщика
|}

== Поддержка валют в Ostrovok.ru==

Ostrovok.ru поддерживает большое количество валют разных стран, в число которых входит RUB (российский рубль), USD (доллар США), EUR (евро), GBP (фунт стерлингов), AUD (австралийский доллар)
<div class="toccolours mw-collapsible mw-collapsed" style="width:800px; margin-bottom:10px;">
=== Полный список ===
<div class="mw-collapsible-content">
AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BRL, BSD, BTN, BWP, BYN,
BYR, BZD, CAD, CHF, CLP, CNY, COP, CRC, CUP, CVE, CZK, DJF, DKK, DOP, DZD, EGP, ERN, ETB, EUR, FJD, FKP, GBP, GEL, GHS,
GIP, GMD, GNF, GTQ, GYD, HKD, HNL, HRK, HTG, HUF, IDR, ILS, INR, IRR, ISK, JMD, JOD, JPY, KES, KGS, KHR, KMF, KRW, KWD,
KYD, KZT, LAK, LBP, LKR, LRD, LSL, LYD, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MRO, MUR, MVR, MWK, MXN, MYR, MZN, NAD, NGN,
NIO, NOK, NPR, NZD, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, RWF, SAR, SBD, SCR, SEK, SGD, SLL, SOS,
SRD, STD, SYP, SZL, THB, TJS, TMT, TND, TRY, TTD, TWD, TZS, UAH, UGX, USD, UYU, UZS, VEF, VND, VUV, WST, XAF, XCD, XOF,
XPF, YER, ZAR, ZMW
</div>
</div>
== См. также ==

* [[Отели]]
* [[Бронирование]]
* [[Объект размещения#Функциональные возможности поставщиков наземных услуг|Функциональные возможности поставщиков наземных услуг]]

S7 NDC

2019-02-28T13:59:12Z

Мария Горшенева: /* Особенности S7 NDC */

=S7 NDC=
S7 Airlines первой в России внедрила новый отраслевой стандарт дистрибуции авиабилетов — NDC.

NDC (New Distribution Capability) – новый стандарт обмена данными между авиакомпаниями и агентами по продаже авиабилетов, разработанный Международной ассоциацией воздушного транспорта (IATA). Использование NDC позволяет онлайн-агентам напрямую получать максимально полную информацию о рейсах и услугах авиакомпании в едином стандартизованном формате.

С введением нового стандарта онлайн-агенты смогут предлагать на своих сайтах все дополнительные услуги, доступные на сайте авиакомпании. Например, выбор комфортного места на борту, дополнительный багаж и другие. Пассажиры, в свою очередь, получают возможность существенно экономить за счет доступа ко всей линейке тарифов и услуг авиакомпании.

NDC позволяет представить все данные о перелете в том же виде, что и на сайте авиакомпании. Использование нового стандарта позволяет исключить ситуации, когда пассажир выбрал неподходящий тариф или услугу.

== Подключение S7 NDC в Nemo.Travel ==
* В результате обращения и согласования условий с системой S7 агент должен получить необходимые реквизиты для подключения в production среде.
* Необходимо открыть задачу в проекте [https://s7airlines.atlassian.net/browse/AAS s7airlines.atlassian.net], в рамках которой создать запрос на сертификат для production среды. [https://s7airlines.atlassian.net/wiki/spaces/GAAPI/pages/300023812/Quick+Start+for+Agents+S7+Agent+API Инструкция]
* Полученные реквизиты, сертификат и пароль (который вводился во время генерации запроса на сертификат) для доступа к production среде нужно передать в {{NameSystem}} для формирования production конфигурации подключения.

==Особенности S7 NDC==
#У поставщика всего 3 типа пассажиров ADT CHD INF, указание INS недоступно.
#Перелеты могут быть только двух классов эконом и бизнес.
#Пассажиры должны быть указаны с паспортными данными, бронирование без документов - невозможно.
#У поставщика отсутствует привязка младенцев к взрослым пассажирам.
#Поддерживается только довнесение контактных данных, модификация остальных данных не поддерживается.
#Выписка билета выполняется отдельно на каждого пассажира.
#Войдирование выполняется отдельно на каждого пассажира.
#Работа с дополнительными услугами находится на стадии разработки у провайдера.
#Максимальное кол-во символов, передаваемое в узле Endorsements (включая пробелы) с учётом эндорсментов передаваемых по умолчанию = 145 символов.

{{Attention|Актуализация и репрайсинг происходят только за счет получения цены для перелета, так как у поставщика отсутствует проверка доступности мест, что может приводить к невозможности бронирования перелётов, которые успешно прошли через процесс актуализации и репрайсинга.}}

==Трехсторонние соглашения / 3D Flow==
Данный режим работы используется, когда поставщику необходимо идентифицировать кто из корпорантов сделал заказ. Для работы необходимо:
# В поисковом запросе передать код корпоративного клиента в блоке Restrictions.ThreeDomainAgreementNumber.
# В запросе актуализации/семейств передать код корпоративного клиента в блоке OperationsRestrictions.PricingInfo.ThreeDomainAgreementNumber.
# При бронировании передать FQTS SSR ремарку с кодом корпоративного клиента


<div class="toccolours mw-collapsible mw-collapsed" style="width:1000px">
==== Пример передачи SSR ремарки в запросе бронирования Nemo Conneсt:====
<div class="mw-collapsible-content">
<ns1:DataItem>
<ns1:ID>1</ns1:ID>
<ns1:TravellerRef>
<ns1:Ref>1</ns1:Ref>
</ns1:TravellerRef>
<ns1:SegmentRef>
<ns1:Ref>1</ns1:Ref>
</ns1:SegmentRef>
<ns1:Type>SSR</ns1:Type>
<ns1:Remark xsi:nil="true"/>
<ns1:TimeLimits xsi:nil="true"/>
<ns1:SSR>
<ns1:Code>FQTS</ns1:Code>
<ns1:Text>QUW1725</ns1:Text>
<ns1:Status xsi:nil="true"/>
<ns1:StatusCode xsi:nil="true"/>
</ns1:SSR>
</ns1:DataItem>
</div>
</div>
{{Attention|Работа с трехсторонними соглашениями поддерживается только через API-проект «{{NameProject2}}», описанный в документации по [http://docs.nemo.travel/ ссылке] .}}

==Ошибки при взаимодействии с S7 NDC==

'''«matching.passenger.not.found»''' — такая ошибка говорит об окончании бланков на стоке. Необходимо проверить количество, их должно быть больше 10.

== См. также ==
* [http://support.nemo.travel/ru/%D0%A6%D0%B5%D0%BD%D0%BE%D0%BE%D0%B1%D1%80%D0%B0%D0%B7%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5_(%D0%90%D0%B2%D0%B8%D0%B0%D0%B1%D0%B8%D0%BB%D0%B5%D1%82%D1%8B) Ценообразование (Авиабилеты)]
* [[Пакеты реквизитов {{NameProject2}}]]

Отели

2019-02-27T11:03:09Z

Мария Горшенева: /* Параметры для настройки ваучера отелей */

[[Категория: Настройки]]
[[Категория:Модули]]
[[Категория:Дополнительные модули]]
'''Отели 2.0''' — [[компонент]] системы {{NameSystemLink}}.

==Описание==
[[Файл:Результаты поиска.png|thumb|300px|Результаты поиска]]
Компонент '''Отели 2.0''' подключается администратором {{NameSystem}} по запросу агентства. Для подключения опции для агентства направьте запрос в проектный трекер системы.

'''Компонент располагает следующими возможностями:'''
* '''Поиск''' отелей по следующему набору критериев:
** фиксированные даты заезда/выезда из отеля,
** количество ночей,
** количество номеров,
** количество человек в номере,
** местоположение объекта. <br>Программа позволяет осуществлять поиск до 4 номеров одновременно на группу не более 9 человек.
Поиск отелей (комнат готовых к бронированию) по умолчанию осуществляется среди комнат со "свободной продажей". Для отелей от поставщиков ContentInn, Akadem и Travelport есть возможность получать для бронирования комнаты "по-запросу". Для включения функционала в реквизитах поставщика нужно обратиться к администратору системы {{NameSystem}}. 
* '''Результаты поиска''' отелей выдаются списки доступных для бронирования отелей, с возможностью перейти к '''детальной информации''' при выборе конкретного отеля. <br>На поисковой выдаче доступны следующие '''фильтры''':
** по названию отеля,
** по цене за 1 ночь,
** по звездности,
** по набору услуг и удобств,
** а также по специальным предложениям. [[Файл:Выбор_номеров.png|thumb|300px|Выбор номеров]]
* После перехода на этап просмотра детальной информации об отеле необходимо выбрать подходящий номер для перехода на '''форму бронирования''', так же на этом этапе доступны для просмотра следующие информационные разделы:
** информация об отеле,
** удобства,
** правила отеля.
* Форма бронирования содержит поля ввода данных о пользователях услуг, необходимых для завершения транзакции бронирования: пол, ФИО, даты рождения, электронная почта. <br>После выбора способа оплаты и клике на продолжить, система производит действительное бронирование. После того, как бронирование успешно завершено, ваучер отправляется на указанный адрес электронной почты, так же ваучер доступен по клику на '''Мои билеты'''.
===Карта лояльности===
Многие сетевые отели имеют карты лояльности. Они созданы для того, чтобы посетитель отеля в будущем выбирал именно их сеть отелей. В системе Nemo.travel реализована возможность указания на форме номера своей карты. Для этого нужно нажать на кнопку "Карта лояльности" и ввести туда название сети отелей и номер своей карты. В данный момент работу с картами лояльности поддерживает только поставщик Travelport. [[Файл:Loyaltycard.jpg|thumb|right|400px|Ввод карты лояльности]]

==Настройка компонента==
===Параметры для настройки поиска===
Параметры для настройки поиска расположены в разделе '''Управление продажами → Отели → Настройки поиска'''.

Реквизиты для поиска отелей — сообщает системе, каким поставщикам отельного контента необходимо отправлять запрос. Если нужно опрашивать несколько поставщиков, то следует отметить галочками требуемых поставщиков контента. Предварительно нужно убедиться, что для текущего агентства специалистами технической поддержки прописаны реквизиты подключения.

* '''Реквизиты для поиска отелей''':
** '''''Все''''' - для поиска отелей будут использоваться все реквизиты.
** '''''Выбранные''''' - выберите один реквизит или несколько реквизитов для поиска.

===Управление ценами===
Подробное описание возможностей системы по управлению ценами и инструкцию по настройке смотрите в разделе [[Ценообразование (Отели)]].

===Параметры для настройки ваучера отелей===
Шаблон, по которому формируется ваучер, настраивается на странице '''Настройки системы → Нотификации и документы → Документы → Ваучер для отеля'''.

Перед настройкой необходимо выбрать необходимый '''Тип документа''', то есть поставщика, для которого будет работать данный шаблон:
* Hotelston
* Academ_net
* Travelport
* ContentInn
* Ostrovok
* Amadeus Hotels

====Переменные шаблона====
<div class="toccolours mw-collapsible mw-collapsed" style="width:800px">
<u>'''Справочник шаблонных переменных ваучера для отелей'''</u>
<div class="mw-collapsible-content">

{| class="wikitable" id="keys" style="width: 100%" border="1" cellpadding="5" cellspacing="0"
|-
! Переменная
! Описание переменной
|-
|%AGENCY_NAME%
|Название агентства
|-
|%AGENCY_LOGO%
|Лого агентства (изображение логотипа агентства должно быть в формате JPG или PNG)
|-
|%AGENCY_ADDRESS%
|Адрес агентства
|-
|%AGENCY_PHONE%
|Телефон агентства
|-
|%CLIENT_NAME%
|Имя заказчика
|-
|%CLIENT_PHONE%
|Телефон заказчика
|-
|%BOOKING_ID%
|ID услуги в системе
|-
|%DATA%
|Дата
|-
|%%FORM_OF_PAYMENT%
|Форма оплаты
|-
|%PAYMENT_DATE%
|Дата оплаты
|-
|%TOTAL_PRICE%
|Стоимость заказа (в валюте агентства)
|-
|%DATE_IN%
|Дата въезда
|-
|%DATE_OUT%
|Дата выезда
|-
|%ROOMS_COUNT%
|Количество номеров
|-
|%Nights%
|Количество ночей
|-
|%ROOM_NAME%
|Название номера
|-
|%ROOM_MEALS%
|Питание в номере
|-
|%ROOM_PERSON_LASTNAME%
|Фамилия туриста (в комнате)
|-
|%ROOM_PERSON_NAME%
|Имя туриста (в комнате)
|-
|%ROOM_PERSON_PATRONYMIC%
|Отчество туриста (в комнате)
|-
|%ROOM_PERSON_TYPE%
|Тип туриста (в комнате)
|-
|%ROOM_PERSON_AGE%
|Возраст туриста (в комнате)
|-
|%HOTEL_NAME%
|Название отеля
|-
|%CITY%
|Город
|-
|%COUNTRY%
|Страна
|}

</div>
</div>

Чтобы указать в маршрут-квитанции информацию о нескольких пассажирах, используются группы. Они лишь объединяют другие переменные и самостоятельными параметрами не обладают, на данный момент доступны две группы:
* для информации по номерам используйте группу %ROOM%,
* для информации о постояльцах в комнатах группу %ROOM_PERSON%.

== Особенности работы с Отели 2.0 ==

Так как для модулей «Поиск авиабилетов 2.0» и «Отели 2.0» используются схожие формы бронирования, изменять настройки отображения формы бронирования модуля «Отели 2.0» возможно в разделе настроек '''Управление продажами → Авиабилеты → Процессы → Форма бронирования'''.

Если для выбранного номера на момент оформления заказа нет штрафов за отмену брони, либо штрафы вступают в силу начиная с определенной даты в будущем, то оформление заказа (бронь совместно с выпиской) возможно без оплаты. Клиент в таком случае может оплатить заказ позже. Если на момент наступления штрафов заказ не будет оплачен, он аннулируется системой автоматически.

== См. также ==

* [[ContentInn]]
* [[Академсервис]]
* [[Бронирование]]
* [[Туроператор (ТО)]]
* [[Статистика#Статистика поставщиков|Статистика поставщиков]]
* [[Объект размещения#Функциональные возможности поставщиков наземных услуг|Функциональные возможности поставщиков наземных услуг]]

Ценообразование (Авиабилеты)

2019-02-26T12:27:19Z

Мария Горшенева:

[[Категория:Модули]] [[Категория:Встроенные модули]]

==Назначение==
Модуль '''Ценообразование''' автоматизирует процесс расчета [[Комиссия (термин)|комиссий]] и [[Комиссия (термин)|сборов]] для [[Билет#Авиабилеты|авиабилетов]], управления комиссионными правилами [[Перевозчик|перевозчиков]], сборами [[Агентство|агентства]] и комиссионными вознаграждениями субагентов.

* позволяет быстро настроить даже сложные комиссионные правила,
* позволяет построить удобную и понятную схему ценообразования,
* точно соблюдать сложные условия, предоставляемые авиакомпаниями,
* гарантирует правильные расчеты,
* предоставляет инструмент контроля за корректностью расчетов.

==Принцип работы==
Работа модуля основана на правилах ценообразования, которые заводит агентство.

'''Правило''' — набор ''значений комиссий и сборов'' и ''условия их применения''. <br />
'''Значения комиссий и сборов''' — это:<br />
*комиссия от авиакомпании, <br />
*бонус авиакомпании, <br />
*сбор агентства, <br />
*комиссия субагентам. <br />
'''Условие применения комиссий и сборов''' — набор параметров перелетов, к которым будут применяться комиссии и сборы правила (''валидирующий перевозчик'', ''ГРС'', ''тип рейса'', ''типы пассажиров'' и пр.)

Правила ценообразования задаются в таблице в файле формата XLS или XLSX, где:

*''Строка таблицы'' — правило. <br />
*''Ячейка строки'' — значение параметра. <br />
*''Заголовок столбца'' — название параметра. <br /> Каждая строка является отдельным правилом. <br /> '''К одному перелету выбирается по критериям и применяется только одно правило'''

Прежде чем рассчитать комиссии, модуль ценообразования определяет доступность перелета к выписке и правило, по которому рассчитываются комиссии и сборы, по алгоритму:

# Модуль фиксирует, какую авиакомпанию [[ГРС]] определила как [[Валидирующий перевозчик|валидирующую]];
# Находит в файле ценообразования все правила для данной [[Авиакомпания|авиакомпании]];
# Подбирает правила, которые соответствуют перелету по всем параметрам;
# Выбирает по критериям приоритета '''одно''' из подходящих правил;
#* Если сработавшее правило не содержит переопределения валидирующего перевозчика, устанавливается валидирующий перевозчик, полученный от ГРС.
#* Если сработавшее правило содержит переопределение валидирующего перевозчика, устанавливается переопределенный валидирующий перевозчик.
# Правило применяется.

Агентство может [[Выписка|выписывать]] онлайн перелеты только '''контрактных авиакомпаний'''. Авиакомпания считается контрактной, если для нее заведено хотя бы 1 правило в загруженном файле ценообразования.

{{Attention|Перелет '''не может быть выписан''', если:}}
* правила для авиакомпании не заведены. Такие перелеты рекомендуется удалять из выдачи [[Фильтры результатов поиска (Авиабилеты)|фильтром результатов поиска]] «А/к не является контрактной».
* правила для авиакомпании заведены, но параметры перелета не соответствуют параметрам правила.
Порядок работы модуля приведен в схеме:

{| class="wikitable"
|-
|[[Файл:Схема_ценообразование.png|1000px]]
|-
|Схема работы модуля Ценообразование
|}

Комиссии и сборы '''рассчитываются при каждом обновлении [[Заказы|заказа]] по правилам, загруженным в систему на момент проверки''':
*при формировании выдачи результатов поиска,
*при [[Бронирование (Авиабилеты)|бронировании]],
*при переходе к оплате и выписке билетов,
*при обновлении страницы заказа.

Если в промежуток между бронированием и выпиской '''''правила изменили''''', после бронирования заказа комиссии будут рассчитываться по новым правилам, таким образом цена при бронировании и цена при выписке может отличаться. Поведение системы при возникновении такой ситуации задается параметром '''''Пересчитать сервисный сбор''''' в разделе Настройки системы → Фоновые процессы → События синхронизации. Расчет комиссий, действующих на момент бронирования, можно отследить в логах по заказу.

В детализации стоимости (на странице заказа) и в маршрут-квитанции информация по сборам представлена в соответствии с одним из '''режимов разделения сбора на пассажиров''':
* Поровну между ненулевыми стоимостями билетов - сбор агентства, субагентства разделяется поровну между всеми пассажирами, у которых сумма тарифа и такс больше 0. Этот режим выбран по умолчанию.
* Поровну между всеми тарифами - сбор агентства, субагентства разделяется поровну между всеми пассажирами.
* Пропорционально тарифам - сбора агентства, субагентства разделяется пропорционально стоимости тарифа для конкретного пассажира в общей сумме заказа, т.е. чем больше стоимость тарифа, тем большая часть сбора на него отводится.
* Только первому типу пассажира - сбор агентства, субагентства определяется первому типу пассажира.
''Сборы в детализации стоимости представлены с учетом разбиения только если скрыты в таксы XP/XX, а иначе отображаются отдельной строкой без разделения.'' <br>
Настройка находится в разделе '''«Управление продажами - Авиабилеты - Ценообразование - Настройки - Режим разделения сбора на пассажиров».'''

=== Расчет комиссий для неконтрактных авиакомпаний ===

Агентство может '''выписывать билеты ''неконтрактных'' авиакомпаний''' на условиях '''чистого [[Интерлайн (термин)|интерлайна]]''' между авиакомпаниями.

Например,
* У агентства нет контракта с авиакомпанией «АА».
* У агентства есть контракт с авиакомпанией «ВВ».
* Между компаниями «АА» и «BB» интерлайн-соглашение, позволяющее выписывать билеты для «АА» на бланке «ВВ».

Чтобы выписывать билеты авиакомпании «АА», агенство заводит правило для авиакомпанией «АА», в котором заданы:
# валидирующий перевозчик: '''''«АА»''''',
# переопределенный перевозчик: '''''«BB»''''',
# доля сегментов интерлайнов: '''''«1»''''',
# комиссия авиакомпании: ''укажите размер комиссионного вознаграждения, предоставляемого компанией «ВВ» за билеты со 100% долей интерлайн [[Сегмент|сегментов]]''.

{{Attention|Система {{NameSystem}} не отслеживает наличие интерлайн-соглашений между перевозчиками. Ответственность за переопределение полностью лежит на агентстве.}}

=== Выбор правила для расчета ===
Комиссии для перелета рассчитываются по одному правилу. Если для перелета подходит несколько правил, система выбирает правило для расчета по критериям приоритета. Правила сравниваются по первому критерию, если критерий в данном случае не срабатывает, по второму и так далее, пока не будет определено одно правило.

Порядок сравнения правил для выбора правила для расчета:
#'''По колонке ''Приоритет''''' - если у сработавших правил указан приоритет, то выбирается правило с наибольшим приоритетом.
#'''По наличию переопределенного перевозчика''' - если срабатывает несколько правил с одинаковым приоритетом (или приоритет не указан), выбирается правило с переопределенным ВП.
#'''По непустой ячейке ''Комиссия''''' - приоритет правил с установленной комиссией (даже в 0%) выше, чем у правил с пустой ячейкой комиссии.
#''' Дополнительный приоритет''' - ''устанавливается вручную'' в разделе '''Управление продажами → Авиабилеты → Ценообразование → Настройки'''  параметром '''''Дополнительный приоритет''''':
#*'''''Нет''''' - не установлен дополнительный приоритет.
#*'''''Максимальная комиссия авиакомпании''''' - выбирается правило с максимальной комиссией от авиакомпании.
#*'''''По количеству параметров в правиле''''' - выбирается правило с наибольшим числом непустых параметров.
#''' Порядковый номер правила''' - если ни один из приоритетов не применим, приоритетным считается более новое правило (расположенное таблице ниже других).

== Тестирование и отладка срабатывания правил ==
Все расчеты на каждом этапе их применения [[Логи системы|логируются]] и отображаются в таблице отладки. Таблица отладки используется для контроля срабатывания правил, предоставляя информацию о применении правил к выбранному перелету.

Ссылка на таблицу отладки доступна менеджеру агентства:
* на выдаче результатов поиска для каждого перелета по ссылке '''''Комиссия''''', 
* на странице заказа в детализации стоимости перелета по щелчку на сумму комиссии или сбора.

{| class="wikitable"
|-
|[[Файл:Ссылка на таблицу отладки на странице поиска.png|800px]]
|-
|Ссылка на таблицу отладки на странице поиска
|}

{| class="wikitable"
|-
|[[Файл:Страница заказа.png|700px]]
|-
|Ссылка на детализацию стоимости на странице заказа
|}

{| class="wikitable"
|-
|[[Файл:Детализация_стоимости.png|600px]]
|-
|Ссылки на таблицу отладки на странице детализации стоимости
|}

'''Столбцы таблицы''' — параметры ценообразования. <br />
'''Заголовок столбца''' — значения параметров ценообразования для проверяемого перелета. <br />
'''Строки таблицы''' — правила ценообразования ''для валидирующего перевозчика'' перелета.


В таблице отражается порядок проверки параметров.

Параметры каждого правила сравниваются в параметрами перелета:
# если они совпадают:
## ячейка подсвечивается зеленым,
## проверяется следующей параметр;
# если значение параметра перелета не совпадает со значением параметра правила:
## ячейка подсвечивается красным цветом,
## проверка правила прекращается.
'''Если правило подошло по всем параметрам, то правило применяется, комиссии и сборы подсвечиваются зеленым светом, рядом отображаются их вычисленные значения.'''

{| class="wikitable"
|-
|[[Файл:Таблица_отладки.png|1200px]]
|-
|Таблица отладки
|}

== Включение модуля. Импорт и экспорт правил ==

Чтобы включить расчет комиссий с использованием Ценообразования, включите опции '''Комиссии 2.0''' и '''Сборы и скидки 2.0''' в разделе Управление продажами → Авиабилеты → Ценообразование → Настройки.

Чтобы задать правило ценообразования:
# Зайдите в раздел Управление продажами → Авиабилеты → Ценообразование → Импорт/экспорт Excel.
# Нажмите '''Выгрузка в формате "xls"''' или '''Выгрузка в формате "xlsx"'''. Откройте файл для редактирования.
# Установите правило: '''заполните параметры строки'''. Формат внесения данных в каждый столбец должен соответствовать строго определенному формату (см. [[Ценообразование (Авиабилеты)#Импорт правил|Импорт правил]]). <br /> Обязательные параметры для заполнения:
#* '''''валидирующий перевозчик'''''
#* '''''комиссия'''''
# Сохраните изменения в файле.
# На странице '''Импорт/экспорт Excel''' в панели администрирования нажмите '''Обзор''', откройте файл.
# Нажмите '''Отправить''' для загрузки файла в систему.

При импорте система валидирует все введенные значения. Если в какой-то ячейке значение внесено в некорректном формате, система сообщит об ошибке, сохранив при этом все корректно заданные правила.

{| class="wikitable"
|-
|[[Файл:Ошибки_импорта_Ценообразование.png|500px]]
|-
|Ошибки при валидации параметров
|}

После валидации на странице отображается таблица, в которой в сжатой форме отражены все загруженные правила.

{| class="wikitable"
|-
|[[Файл:Правила ценообразования.png|900px]]
|-
|Правила ценообразования
|}

В таблице предусмотрено цветовое выделение правил, которые на данный момент недействительны:
* правила, срок действия которых ещё не наступил (дата начала продажи больше текущей даты, см. раздел [[Ценообразование (Авиабилеты)#Параметры правил ценообразования|Параметры правил ценообразования]]), выделяются оранжевым цветом,
* правила, срок действия которых истёк (дата окончания продажи больше текущей даты), выделяются фиолетовым цветом.

== Параметры правил ценообразования==
'''Шаблон файла для внесения правил ценообразования:'''<br/>[[File:CommImportExampleV1.0.5.xlsx]]

{{Attention|Запрещено переименовывать столбцы!}}<br/> При этом допускается менять столбцы местами и удалять ненужные столбцы.

Для просмотра описания параметров <span style="background-color:gold">разверните таблицу</span>:

{| class="wikitable mw-collapsible mw-collapsed"
|colspan="5"| '''Параметры правил ценообразования'''
|-
! scope="col" | Заголовок
! scope="col" | Внутреннее название
! scope="col" | Описание
! scope="col" | Допустимые значения
! scope="col" | Примеры
|-
| id
| <span id="id">id</span>
| Уникальный номер записи из любой внешней системы (или БД). Необязательный параметр. Не участвует в логике расчетов и используются для удобства идентификации правила.
| любое значение
| 123
|-
| валидирующий перевозчик GDS
| <span id="valCompanyId">valCompanyId</span>
| Авиакомпания, для которой задается правило. Должна являться контрактной авиакомпанией агента. Если необходимо проводить выписку на стоке другой авиакомпании (по интерлайну), валидирующий перевозчик переопределяется (см. [[Ценообразование (Авиабилеты)#Переопределенный валидирующий перевозчик|Переопределенный валидирующий перевозчик]]). Если валидирующий перевозчик от ГРС недопустим указанными правилами ценообразования и не переопределен — перелет считается недопустимым к выписке и удаляется из результатов поиска при соответствующих настройках фильтрации результатов.
| width="20%"| пустое игнорируется

2-значный IATA-код авиакомпании
| SU

LH
|-
| переопределенный вп
| <span id="manualVV">manualVV</span>
| Если валидирующий перевозчик, предложенный ГРС не является контрактным или не устраивает агента по комиссии, его можно переопределить принудительно через это поле. В поле ВП указывается ВП от ГРС (или оно оставляется пустым), а в этом поле указывается переопределенный агентством перевозчик.

Ответственность за допустимость замены и за адекватность цены перелета (которая была рассчитана GDS по предложенному ей перевозчику) берет на себя агент. Приоритет у правил с переопределением выше, чем у правил без него.
| пустое игнорируется

2-значный IATA-код авиакомпании
| SU

LH
|-
| перевозчики первого сегмента
| <span id="airlines">airlines</span>
| Набор допустимых маркетинговых перевозчиков первого сегмента маршрута.
| пустое = любые<br/>КОД,КОД...<br/><>КОД,КОД...(кроме)
| SU,LH,BA

<>S7,SU
|-
| перевозчики любого сегмента
| <span id="airlinesAny">airlinesAny</span>
| Набор допустимых маркетинговых перевозчиков (интерлайнов) любого сегмента маршрута.

Допустимые варианты ввода:
* КОД,КОД,КОД : правило применится, если хотя бы один маркетинговый перевозчик из перелета есть в списке.
* КОД,КОД,КОД! : правило применится, если каждый маркетинговый перевозчик из перелета встречается в списке
* <>КОД,КОД,КОД : правило не применится, если хотя бы один маркетинговый перевозчик из перелета встречается в этом списке
* <>КОД,КОД,КОД! : правило не применится, если все маркетинговые перевозчики из перелета встретятся в этом списке
| пустое = любые<br/>- одно или несколько значений (см. описание)
| SU,LH,BA<br/>SU,LH!<br/><>S7,SU<br/><>S7,BA!
|-
| код-шеринг
| <span id="codeSharing">codeSharing</span>
| Допустимость выполнения рейса другой (оперирующей) авиакомпанией
| пустое — все перелеты<br/>1 — код-шеринг обязателен <br/>0 — код шеринг запрещён
| 0

1
|-
| операторы
| <span id="operatingAirlines">operatingAirlines</span>
| Допустимые оперирующие авиакомпании (проверяются на всех сегментах).

Варианты ввода:
* КОД,КОД,КОД : правило применится, если хотя бы один оперирующий перевозчик перелета встречается в списке.
* КОД,КОД,КОД! : правило применится, если каждый оперирующий перевозчик перелета есть в списке.
* <>КОД,КОД,КОД : правило не применится, если хотя бы один оперирующий перевозчик перелета встречается в списке.
* <>КОД,КОД,КОД! : правило не применится, если все оперирующие перевозчики перелета есть в списке.
| пустое = любые<br/>- одно или несколько значений (см. описание)
| SU,LH,BA<br/>SU,LH!<br/><>S7,SU<br/><>S7,BA!
|-
| доля собственных сегментов
| <span id="ownPart">ownPart</span>
| Минимально допустимая доля собственных сегментов (сегментов, где валидирующий перевозчик равен маркетинговому) должна быть больше или равна заданному значению (любое число от 0 до 1):
* 1 — все сегменты собственные
* 0.5 — половина или больше собственных сегментов
* 0.25 — четверть или больше собственных сегментов
* 0.01 — присутствует минимум один собственный сегмент
* 0 — все сегменты интерлайны
| пустое = любое количество<br/>
любое число от 0 до 1
| 0.88
|-
| доля сегментов интерлайнов
| <span id="interlinePart">interlinePart</span>
| Минимально допустимая доля несобственных сегментов (сегментов, где валидирующий перевозчик не равен маркетинговому) должна быть больше или равна указанному значению(любое число от 0 до 1).
* 1 — все сегменты интерлайны
* 0.5 — половина или больше сегментов интерлайнов
* 0.25 — четверть или больше сегментов интерлайнов
* 0.01 — присутствует минимум один сегмент интерлайна
* 0 — все сегменты собственные
| пустое = любое количество<br/>
любое число от 0 до 1
| 0.88
|-
| тип контракта
| <span id="contractType">contractType</span>
| Система взаиморасчетов BSP или ТКП
| пустое = любой,<br/>BSP<br/>TCH
| TCH
|-
| системы бронирования
| <span id="gds">gds</span>
| Глобальная распределительная система, в которой найден перелет/ PCC конкретных реквизитов / ID пакета реквизитов системы {{NameProject1}}
Перечисляются в любой последовательности, можно смешивать разные типы. Действует правило "или": если указан Sabre целиком, все его PCC/пакеты указывать уже нет смысла.

{{Attention|При указании названия ГРС строго соблюдайте формат названия, указанный в документации. При расхождении с шаблоном правило не будет применяться!}}
| пустое = любые<br/>ГРС: <code>SABRE, GALILEO, AMADEUS, SIRENA, SITA, SIG23</code><br/>PCC: [буквы+цифры]<br/>ID пакета: [цифры]
| SABRE,670P,123

AMADEUS,GALILEO

SITA
|-
| начало продажи
| <span id="paymentDateFrom">paymentDateFrom</span>
| Минимально допустимая дата оформления заказа (не путать с датой вылета). Для срабатывания правила, текущая дата должна быть больше или равна указанной.
| пустое = игнорируется<br/>
DD.MM.YYYY
| 01.01.2012

31.01.2010
|-
| конец продажи
| <span id="paymentDateTo">paymentDateTo</span>
| Максимально допустимая дата оформления заказа. Для срабатывания правила, текущая дата должна быть меньше или равна указанной.
| пустое = игнорируется<br/>DD.MM.YYYY
| 31.12.2022
|-
| тип рейса
| <span id="airlineType">airlineType</span>
| Международный или внутренний (весь перелет в пределах одной страны) перелет. Одно значение
| пустое = любой<br/>IA (international airlines — международные)<br/>DA (domestic airlines — внутренние)
| IA<br/>DA
|-
| номера рейсов
| <span id="flightNumber">flightNumber</span>
| Допустимые номера рейсов, можно указывать с кодом маркетинговой компании или без неё.

Варианты ввода:
* NNN,NNN: правило применится, если хотя бы один номер рейса из перелета из любого сегмента встречается в списке.
* NNN,NNN! : правило применится, если все номера рейсов из всех сегментов перелета встретятся в списке.
* <>NNN,NNN : правило не применится, если хотя бы один номер из перелета встретится в списке.
* <>NNN,NNN! : правило не применится, если все номера из перелета встретятся в списке.

| пустое = любые<br/>- одно или несколько значений (см. описание)
| SU 123,SU 345<br/>123,345<br/><>LH 555
|-
| тип вс
| <span id="aircraft">aircraft</span>
| Допустимые коды воздушных судов, коды указывать в том же виде, в котором возвращает ГРС

Варианты ввода:
* CODE,CODE: правило применится, если хотя бы один код судна из любого сегмента совпадет с одним из заданного списка.
* CODE,CODE! : правило применится, если коды судов из всех сегментов перелета есть в списке.
* <>CODE,CODE : правило не применится, если хотя бы один код из перелета есть списке.
* <>CODE,CODE! : правило не применится, если все коды из перелета есть в списке.

| пустое = любые<br/>- одно или несколько значений (см. описание)
| 73C,DH4<br/>735
|-
| коды тарифов
| <span id="tariffs">tariffs</span>
| Допустимые коды тарифов. Должен совпасть хотя бы один тариф из перелета с одним из заданного списка. При правиле с отрицанием никаких совпадений быть не должно. Совпадение не точное: код из правила может содержаться в коде из перелета (к примеру введенное S1GREY26 совпадет с S1GREY26CH из перелета).

Варианты ввода:
* КОД,КОД: правило применится, если хотя бы один тариф встречается в списке.
* КОД,КОД! : правило применится, если все тарифы перелета есть в списке.
* <>КОД,КОД : правило не применится, если хотя бы один тариф встречается в списке.
* <>КОД,КОД! : правило не применится, если все тарифы перелета есть в списке.

Можно указать [http://ru.wikipedia.org/wiki/Регулярные_выражения регулярное выражение]. Для этого нужно написать параметр в формате /XXX/ Примеры:
* /ABC/ — код должен содержать "..ABC..", например "NBABCS"
* /abc/i — регистронезависимая проверка, код может содержать символы в любом регистре, например "NBABCS" или "Abcof"
* /'''^'''TN/ — код должен начинаться с "TN..", например "TNQRTY"
* /OW'''$'''/ — код должен заканчиваться на "..OW", например "SRSOW"
* /'''^.'''L/ — первая буква любая ( '''.''' — любой символ ), вторая буква в коде тарифа должна быть L, например "QLFST"
* /OK'''.*'''RT/ — ( '''.*''' = любое количество любых символов) "..OK..RT..", например "ANOKURTN"
| пустое = любые<br/>- одно или несколько значений (см. описание)
| WRUTH9PL,ARUTH9PL
<br/>/TN.*OW/
|-
| максимальный тариф
| <span id="maxTariff">maxTariff</span>
| Ограничение на максимальное ценовое значение "базовой стоимости" (сумма всех тарифов от перевозчиков в перелете или стоимость от ГРС за вычетом такс). Если параметр задан, то правило, записанное в строке, срабатывает только, если тариф перелета меньше указанного значения или равен ему.
| пустое = ограничения нет<br/>xxxКОД (см примеры)
| 10000RUB<br>
300EUR
|-
| конф. тариф
| <span id="privateFare">privateFare</span>
| Для срабатывания правила у перелета должен присутствовать тариф с признаком конфиденциального (приватного). Об этом сообщает ГРС. Если для однозначного определения правила достаточно указать конкретный код приватного тарифа, признак выставлять необязательно.
| пустое = любые тарифы<br/>1 — должен присутствовать приватный<br/>0 — приватных тарифов не должно быть
| 0<br/>1
|-
| коды такс
| <span id="taxes">taxes</span>
| Допустимые коды такс

Варианты ввода:
* КОД,КОД: правило применится, если любая такса из перелета встретится в списке.
* КОД,КОД! : правило применится, если все таксы перелета встретятся в списке.
* <>КОД,КОД : правило не применится, если любая такса из перелета встретится в списке.
* <>КОД,КОД! : правило не применится, если все таксы перелета встретятся в списке.
где КОД — набор заглавных латинских букв.
| пустое = любые<br/>- одно или несколько значений (см. описание)
| YQ,YR<br/><>YQ!
|-
| цена подтверждена
| <span id="priceIsActual">priceIsActual</span>
| Признак подтвержденной цены перелета. Цена в перелете после поиска считается неподтвержденной, ее статус меняется на "подтверждена" ("актуальна") при создании реального PNR или при запросе актуализации цен в рамках вебсервисов {{NameProject2}} (до создания PNR)
| пустое = любые перелеты<br/>1 — перелет в PNR или его цена проверена заранее <br/>0 — перелет только что получен из результатов поиска
| 0<br/>1
|-
| наличие сегментов ВП во всех тарифах
| <span id="valSegmentsInTariff">valSegmentsInTariff</span>
| Проверка: среди сегментов любого тарифа должен присутствовать сегмент валидирующего перевозчика (минимум один)
| пустое или 0 = любые тарифы<br/>1 — условие должно выполняться
| 0<br/>1
|-
| сервис классы
| <span id="serviceClass">serviceClass</span>
| Допустимые категории классов обслуживания.

Варианты ввода:
* КОД,КОД: правило применится, если класс из любого сегмента встречается в списке.
* КОД,КОД! : правило применится, если все классы из всех сегментов перелета есть в списке.
* <>КОД,КОД : правило не применится, если класс из любого сегмента встречается в списке.
* <>КОД,КОД! : правило не применится, если все классы из всех сегментов перелета есть в списке.
где КОД:
* B — бизнес
* E — эконом
* F — первый
* EB — сочетание эконом + бизнес
* EF — сочетание эконом + первый
* BF — сочетание бизнес + первый
| пустое = любые<br/>- одно или несколько значений (см. описание)
| B,E<br/>F<br/>EB,EF,F
|-
| классы бронирования (коды)
| <span id="bookingClass">bookingClass</span>
| Допустимые литеры (однобуквенные коды) классов бронирования. Латинскими буквами, русские буквы допустимые только для правил поставщика Sirena.

Варианты ввода:
* КОД,КОД: правило применится, если хотя бы один класс из любого сегмента встречается в списке.
* КОД,КОД! : правило применится, если классы из всех сегментов перелета есть в списке.
* <>КОД,КОД : правило не применится, если хотя бы один класс из любого сегмента встречается в списке.
* <>КОД,КОД! : правило не применится, если классы из всех сегментов перелета есть в списке.
| пустое = любые<br/>- одно или несколько значений (см. описание)
| A,B,C<br/><>A,B,C
|-
| перевозчики и классы
| <span id="airlinesAndClasses">airlinesAndClasses</span>
|
Набор пар "маркетинговый перевозчик" + "класс бронирования" любого сегмента маршрута.

Допустимые варианты ввода:

* КОД:КОД,КОД:КОД,КОД:КОД : правило применится, если хотя бы один сегмент перелета совпадёт с одним из перечисленных в списке.
* КОД:КОД,КОД:КОД,КОД:КОД! : правило применится, если все сегменты из перелета встретятся в списке.
* <>КОД:КОД,КОД:КОД,КОД:КОД : правило не применится, если хотя бы один сегмент перелета совпадет с любым сегментом из перечисленных в списке.
* <>КОД:КОД,КОД:КОД,КОД:КОД! : правило не применится, если все сегменты перелета встретятся в списке.
|
пустое = любые<br/>- одно или несколько значений (см. описание)

|
SU:A,LH:B,BA:C<br/>
SU:A,LH:B!<br/>
<>S7:A,SU:B<br/>
<>S7:A,BA:B!
|-
| зоны
| <span id="zones">zones</span>
| Географические зоны перелета. Весь перелет не должен выходить за пределы одной из указанных зон для срабатывания правила. [http://www.geonames.org/countries/ разделение стран по указанным зонам]
* AF — Африка,
* AN — Антарктика
* AS — Азия
* EU — Европа
* NA — Северная Америка
* OC — Австралия и Океания
* SA — Южная Америка
перелет должен находиться в обеих зонах ( "EUSA, EUNA" — трансатлантический перелет ):
* EUSA — Европа + Южная Америка,
* EUNA — Европа + Северная Америка
* EUAS — Европа + Азия
* EUAF — Европа + Африка
* EUOC — Европа + Австралия и Океания
* AFNA — Африка + Северная Америка
* ASNA — Азия + Северная Америка
* EUAN — Европа + Антарктика
* AFAS — Африка + Азия
* AFAN — Африка + Антарктика
* AFOC — Африка + Австралия и Океания
* AFSA — Африка + Южная Америка
* ANNA — Антарктика + Северная Америка
* ANOC — Антарктика + Австралия и Океания
* ANSA — Антарктика + Южная Америка
* ASAN — Азия + Антарктика
* NASA — Северная Америка + Южная Америка
* OCSA — Австралия и Океания + Южная Америка
* ASSA — Азия + Южная Америка
* NAOC — Северная Америка + Австралия и Океания
* OCAS — Австралия и Океания + Азия
Допустимы только перечисленные комбинации зон!
| пустое = любые

- одно или несколько значений
| AS,EU<br/>SA<br/>EUSA, EUNA
|-
| зона из стран
| <span id="countryZones">countryZones</span>
| Перечисленные коды стран образуют зону, за пределами которой самолет не должен садиться и взлетать.
| пустое = любые
КОД,КОД...
| RU,IT,DE,FR
|-
| страны вылета
| <span id="depCountries">depCountries</span>
| Допустимые страны вылета для перелета (проверяется только страна вылета первого сегмента маршрута).
| пустое = любые<br/>КОД,КОД...<br/><>КОД,КОД...(кроме)
| RU<br/><>LV,LT
|-
| страны назначения
| <span id="arrCountries">arrCountries</span>
| Проверяется страна назначения (для OW и CR: это последняя страна последнего сегмента, для RT: это последняя страна первого плеча маршрута). К примеру для перелета MOW-PAR-MOW страна назначения FR, для MOW-PAR-LON — GB. '''Правило страна вылета=RU, страна назначения=RU не означает местный рейс''' — не забывайте указывать тип рейса DA (ВВЛ).
| пустое = любые<br/>КОД,КОД...<br/><>КОД,КОД...(кроме)
| RU<br/><>LV,LT
|-
| прямой рейс
| <span id="isDirect">isDirect</span>
| Признак прямого рейса
| пустое = любые<br/>0 — только с пересадками<br/>1 — только прямые<br/>
дополнительно:<br/>2 — начальный перелет прямой<br/>3 — начальный перелет с пересадками
| 0<br/>1
|-
| тип маршрута
| <span id="routeType">routeType</span>
| Можно оставить поле пустым или указать одно значение:
* В одну сторону — OW,
* Туда и обратно — RT,
* Сложный маршрут — CR.
| пустое = любой<br/>КОД(см. примеры)
| OW<br/>RT<br/>CR
|-
| маршруты
| <span id="routeFull">routeFull</span>
| Цепочка из IATA кодов городов или аэропортов, описывающая весь маршрут перелета с учетом пересадок, без разрывов и повторов. Всегда следует использовать IATA код города, если он имеется (агрегирующий аэропорт). К примеру перелет VKO-ORY, ORY-VKO приводится к маршруту MOW-PAR-MOW.
| пустое = любые<br/>КОД-КОД,КОД-КОД,...<br/><>КОД-КОД,КОД-КОД,...(кроме)
| MOW-LON,LON-MOW<br/><>MOW-BER-PAR
|-
| содержит маршруты
| <span id="routePart">routePart</span>
| Указывается только часть маршрута, составленного по аналогии с предыдущим.
| пустое = любые<br/>КОД-КОД,<br/>-КОД-,...<br/><>-КОД-,...(кроме)
| -CAI-<br/><>-PRG-,PRG-SVX
|-
| маршруты (из аэропортов)
| <span id="routeAirportsFull">routeAirportsFull</span>
| Используйте в правиле IATA коды аэропортов (не городов). Остальное аналогично с "маршруты"
| см. описание параметра "маршруты"
| см. описание параметра "маршруты"
|-
| содержит маршруты (из аэропортов)
| <span id="routeAirportsPart">routeAirportsPart</span>
| Используйте в правиле IATA коды аэропортов (не городов). Остальное аналогично с "содержит маршруты"
| см. описание параметра "содержит маршруты"
| см. описание параметра "содержит маршруты"
|-
| вылет (аэропорты, города)
| <span id="depAirports">depAirports</span>
| Проверяется только аэропорт вылета первого сегмента. При указании кодов аэропортов необходимо точное совпадение. При указании кодов городов (агрегирующий аэропортов) сопоставление происходит по внутреннему справочнику аэропортов. Рекомендуется указывать коды конкретных аэропортов.
| пустое = любые<br/>КОД,КОД...<br/><>КОД,КОД...(кроме)
| MOW,PAR,BER <>VKO,LON
|-
| прилет (аэропорты, города)
| <span id="arrAirports">arrAirports</span>
| Аэропорт прилета определяется аналогично "стране назначения". Проверка на сопоставление происходит по аналогии с "вылетом (аэропорты, города)"
| пустое = любые<br/>КОД,КОД...<br/><>КОД,КОД...(кроме)
| MOW,PAR,BER <>VKO,LON
|-
| начало вылета
| <span id="dateBegin">dateBegin</span>
| Дата вылета первого сегмента должна быть больше или равна указанной дате
| пустое = игнорируется<br/>
DD.MM.YYYY
| 01.01.2012

31.01.2010
|-
| вылет через (в часах)
| <span id="dateBegin">dateDepartureAfter</span>
| От текущей даты задается максимальное значение или диапазон вылета. Например, если необходимо выделить перелеты не позднее 5 дней до вылета, то задается диапазон [0,120].
| пустое = ограничения нет <br/> максимальное значение <br/>[X,X] — диапазон
| 13

[10,100]
|-
| конец вылета
| <span id="dateEnd">dateEnd</span>
| Дата вылета первого сегмента должна быть меньше или равна указанной дате
| пустое = игнорируется<br/>
DD.MM.YYYY
| 31.12.2022
|-
| возврат не ранее
| <span id="dateBackBegin">dateBackBegin</span>
| Дата вылета последнего сегмента маршрута должна быть больше или равна указанной дате
| пустое = игнорируется<br/>
DD.MM.YYYY
| 31.12.2022
|-
| возврат не позднее
| <span id="dateBack">dateBack</span>
| Дата вылета последнего сегмента маршрута должна быть меньше или равна указанной дате
| пустое = игнорируется<br/>
DD.MM.YYYY
| 31.12.2022
|-
| длительность в днях
| <span id="daysDuration">daysDuration</span>
| Ограничение на максимальный разрыв в днях между первой датой перелета и завершением маршрута. Можно задавать диапазон.

Длительность в днях считается, как математическая разность дат. При вылете и возврате в один день длительность равна 0 дней.
| пустое = ограничения нет<br/>число дней — максимальное значение (включительно)<br/>[X,X] — диапазон
| 13<br/>
[3,13]
|-
| дни недели
| <span id="dayOfWeek">dayOfWeek</span>
| Допустимые дни недели для даты вылета первого сегмента маршрута. Значения указываются числом, соответствующим порядку дня недели, начиная с понедельника.
| пустое = игнорируется<br/>
1 — понедельник<br/>...<br/>7 — воскресенье<br/>- одно или несколько значений
| 2<br/>3,5
|-
| типы пассажиров
| <span id="passengers">passengers</span>
| Допустимые типы пассажиров в перелете. Для срабатывания правила в перелете обязательно должны присутствовать все перечисленные типы.
| пустое = любые<br/>ADT — взрослый<br/>CLD — ребенок (2-12)<br/>INF — младенец (0-2)<br/>INS — младенец с местом (0-2)<br/>- одно или несколько значений
| INF<br/>ADT,CLD
|-
| маска перелета
|
| Формализованное описание полета в текстовом формате, для создания сложных правил<br/>Будет добавлено в след. версии программы
|
|
|-
| приоритет
| <span id="priority">priority</span>
| Если срабатывает несколько правил, то выбирается одно с наибольшим приоритетом. Если существует несколько правил с одинаковым приоритетом (или приоритет не указан) выбирается более новое правило (расположено ниже в импортируемой таблице)
| целое число<br/>пустое = 0
| 1<br/>2
|-
| код акции
|
| Уникальный код промоакции. Создается в панели администрирования в разделе {{Menu|Управление продажами|Модули|Программа лояльности|Промоакции и промокоды}}.
| любой набор букв/цифр/символов
| 12022014_Promo
|-
| utm source
| <span id="utmSource">utmSource</span>
| ID источника перехода, который отображается в поле «№» таблицы источников переходов в метрике.<br/> Допустимо вводить несколько источников.
| пустое = любые<br/>КОД,КОД...<br/><>КОД,КОД...(кроме)
| 123,456<br/><>123,456
|-
| комиссия авиакомпании
| <span id="commission">commission</span>
| Прибыль агента, получаемая от авиакомпании за проданные билеты. Обязательное для заполнения поле, должно строго соответствовать указанному в контракте значению. Значение передается в ГРС при выписке. Может указываться в процентах от тарифа или в абсолютной стоимости. Комиссия всегда вычисляется для каждого пассажира.
Правила с указанной нулевой комиссией имеют больший приоритет перед правилами с пустой комиссией.
| "xxxКОД" (код валюты) или "XX%"
| 100RUB<br/>13%
|-
| комиссия субагентам
| <span id="agencyCommission">agencyCommission</span>
| Комиссия субагенту - это часть прибыли от авиакомпании, которую агент отписывает субагентам. Значение комиссии действует как скидка для субагентов, уменьшая стоимость авиабилетов. Комиссия всегда вычисляется для каждого пассажира.

'''Форматы задания комиссии субагентам: '''

Для всех субагентов:<br/>
* Фиксированная сумма: <code>XRUB</code>, где:
** ''X'' - сумма комиссии, целое число или десятичная дробь с разделителем в виде точки: <code>60</code>, <code>-3</code>, <code>0.5</code>
** ''RUB'' - IATA-код валюты: <code>EUR</code>, <code>UAH</code>.
* Процент от тарифа: <code>X%</code>,
**где ''X'' - процент от тарифа, целое число или десятичная дробь с разделителем в виде точки: <code>60}</code>, <code>-3</code>, <code>0.5</code>.
Для опеределенных субагентов или групп субагентов:<br/>
* <code>(ID:значение),(ID:значение),(ID:значение),...</code>, где ''ID'' - номер субагента (группы) в {{NameSystem}}, ''значение'' - размер комиссии для этого субагенства (группы) в формате <code>X%</code> или <code>XRUB</code>.

В одном правиле можно комбинировать комиссию для всех субагентов и комиссии для указанных субагентов в формате:
* <code>XX,(ID:YY),(ID:YY),(ID:YY),...}}, где:
** XX - комиссия для всех субагентов в формате, описанном выше,
** YY - комиссия для заданного субагента в формате, описанном выше.

В этом случае размер комиссии:
* для всех субагентов, кроме указанных: XX,
* для указанных: XX + YY.

'''Пример:''' <br/>

<pre>5%,(123:2%),(345:3%)</pre>.

*Комиссия субагента под номером 123 составляет: 5% + 2% = 7% от тарифа. <br/>
*Комиссия субагента под номером 345 составляет: 5% + 3% = 8% от тарифа.

Если требуется ввести сумму десятичной дробью, то дробная часть отделяется "." , например: <code>0.5%</code>
| см. описание
| <code>100RUB</code>

<code>6EUR</code>

<code>2%</code>

<code>5%,(123:100RUB%),(345:2%),(345:-0.5%)</code>
|-
| посегментный расчет комиссии
| <span id="modeForSegment">modeForSegment</span>
| Признак применения комиссии или бонуса за каждый сегмент перелета. Например 100 руб. за каждый сегмент.
| пустое = 0<br/>0 — комиссия одна на весь перелет<br/>1 — комиссию необходимо умножить на кол-во сегментов
| 0<br/>1
|-
| бонус авиакомпании
| <span id="bonus">bonus</span>
| Дополнительная прибыль агента, которую агентство получает от авиакомпании, но в запросах к ГРС она не учитывается. Задается и вычисляется полностью аналогично комиссиям (при вычислении учитывается параметр "посегментный расчет комиссии"). Используется для расчета "прибыльности" авиаперелета, влияет на работу микшера и может повлиять на сбор при установке параметра "минимальная прибыль".

Из всех сработавших правил бонус будет учтен только из одного по следующему приоритету:
* Максимальный приоритет за сработавшим комиссионным правилом
* Если в комиссионном правиле бонуса нет, будет использован бонус из другого сработавшего '''некомиссионного''' правила (дополнительного правила с пустой комиссией). Если таких правил несколько, используется правило с наибольшим идентификатором (ниже в таблице)
| "xxxКОД" (код валюты) или "XX%"
| 100RUB<br/>13%
|-
| бонус за сегмент (допустимые авиакомпании)
| <span id="modeForAirlines">modeForAirlines</span>
| Установка текущего параметра принудительно включает режим расчета бонуса за каждый сегмент перелёта (для абсолютно заданного бонуса), но в расчете учитываются только сегменты с валидирующим или с интерлайновыми перевозчиками из заданного здесь списка.
| пустое<br/>
КОД (код АК)<br/>
КОД,КОД...
| SU<br/>
SU,FV
|-
| сбор агентства
| <span id="charge">charge</span>
| Здесь указываются все наценки/скидки, которые будут применены для описанного правилом перелета. В одном поле можно указать несколько ценовых правил, разделив их по типам пользователя.<br/>
формат = (субъект:сумма),(субъект:сумма),(субъект:сумма)...<br/>субъект = ID групп, пользователей и два значения "B2C", "B2B" с возможностью <>отрицания<br/>сумма = слагаемое + слагаемое + слагаемое...[ограничение]<br/>ограничение = диапазон итоговой величины сбора, задается как [цена,цена]<br/>слагаемое = цена*множитель*множитель...<br/>цена = "xxxКОД" (код валюты) или "XX%" (проценты от итоговой стоимости (тариф+таксы) ГРС)<br/>множитель = одно из значений:
* PAS — общее количество пассажиров (включая INF)
* ADT — количество взрослых
* CLD — количество детей (2-12)
* INF — количество младенцев (0-2)
* INS — количество младенцев с местом (0-2)
* SEG — количество сегментов перелета (перелет из А в Б с 1 пересадкой => 2 сегмента)
* LEG — количество плечей (перелет из А в Б с 1 пересадкой => 1 плечо)
* TRF — для получения цены тарифа, равен сумме тарифов
* SGV — количество сегментов валидирующего перевозчика
Примеры:
* 100RUB*SEG : плюс 100 руб к стоимости заказа за каждый сегмент
* 150RUB*SEG*PAS;: плюс 150 руб за каждый сегмент, на каждого пассажира. Например: перелет с двумя сегмента и двумя пассажирами = 600 руб.
* -10%*TRF : 10% скидка от тарифа
* 50RUB*LEG*ADT[,1000RUB] : 50 руб за каждый билет для взрослого на каждом плече перелета, но не более 1000RUB
* (<>123,345: 100RUB), (123,345: -100RUB) : субъекты 123 и 345 получат скидку 100 руб., остальные наценку в 100 руб.
* (B2B: 1000RUB*ADT — 100RUB*CLD[-10%,-1%]), (B2C: 10% [10USD,]), (123: -1000RUB) : B2B пользователи получают наценку 1000 руб. за каждый взрослый билет и 100 руб скидку за каждый детский билет, но не менее 1% от общей стоимости и не более 10%. B2C пользователи получают 10% наценку, но не менее 10 долларов. Пользователь ID=123 получит скидку 1000 руб.

Если срабатывает несколько ценовых правил, перечисленных через запятую, берется их сумма. Если это не подходящее поведение, разделяйте ценовые правила в отдельные перелетные правила (строки), их можно регулировать приоритетом.

Если требуется ввести сумму десятичной дробью, то дробная часть отделяется "." , например: <code>0.5%</code>
| см. описание
| см. описание
|-
| признак доп.сбора
| <span id="chargeExt">chargeExt</span>
| Настройка позволяет изменять процедуру расчета сбора, добавляя к итоговому результату дополнительные расчетные правила.
* 0 — Стандартный сбор (значение по умолчанию). Из всех указанных сборов будет применен один по приоритету.<br/>
* 1 — Дополнительный сбор. Сборы, указанные как дополнительные, проверяются отдельно. Аналогично применится один дополнительный сбор с максимальным приоритетом
* 2 — Обязательный сбор. Будет обязательно применен, если все параметры сбора удовлетворены. Приоритет игнорируется.
| пустое = 0<br/>
1<br/>
2
|
0<br/>1
|-
| минимальная прибыль
| <span id="minProfit">minProfit</span>
| Минимальная прибыль, которую агентство получит за заказ. Если рассчитанная прибыль агентства меньше минимальной, то сбор будет увеличен до необходимого значения.
Формат аналогичен формату сбора агентства. Для расчетов будет применено значение из правила, по которому будет определена комиссия авиакомпании. Если требуется изменить это поведение, следует установить параметр "приоритет мин. прибыли" (см. ниже)
| см. описание
| 50RUB*LEG*PAS
|-
| приоритет мин. прибыли
| <span id="minProfitPriority">minProfitPriority</span>
| Дополнительный параметр, отвечающий за расчет минимальной прибыли. Сработает правило с наибольшим приоритетом, если приоритет совпадает, то будет использовано правило, которое находится ниже
| Положительные числовые значения.
| 1, 2, ...
|-
| округление
| <span id="chargeRounding">chargeRounding</span>
| Порядок арифметического округления сбора
| пустое = 0,<br/>0 = до целого значения,<br/>0.1 = до десятых,<br/>0.01 = до сотых
| 0.1<br/>0.01
|-
| <br/>
| <br/>
| <br/>
| <br/>
| <br/>
|}

== Дополнительные параметры правил для {{NameSystem}} платформы ==

Параметры для работы с приватными (конфиденциальными) тарифами.

Для просмотра описания параметров <span style="background-color:gold">разверните таблицу</span>:

{| class="wikitable mw-collapsible mw-collapsed"
|colspan="5"| '''Дополнительные параметры правил'''
|-
! scope="col" | Заголовок<br/>
! scope="col" | Внутреннее название<br/>
! scope="col" | Описание<br/>
! scope="col" | Допустимые значения<br/>
! scope="col" | Примеры<br/>
|-
| tour code
| <span id="id">gdsTourCode</span>
| Тур код<br/>
| любое значение
| 15ZU
|-
| ticket designator
| <span id="id">gdsTicketDesignator</span>
| Тикет десигнатор<br/>
| любое значение
| PP08
|-
| endorsement
| <span id="id">gdsEndorsment</span>
| Эндорсменты<br/>
| любое значение<br/> или %VAT_VALUE% для передачи значения НДС в эндорсменте только для ГРС Amadeus, Sabre, Galileo, GalileouAPI и S7 NDC; для Sabre значение передается в ГРС, но не попадает в МК
| Non-Endorsable/Valid on BA/IB only/Refund only to issuing agent; %VAT_VALUE%
|-
| собственная прибыль агента
| <span id="id">comAgentProfit</span>
| Собственная прибыль агента<br/>
| "xxxКОД" (код валюты) или "XX%" Допустимы только целые значения
| 100RUB<br/>2%
|-
| субъект скидки по туркоду
| <span id="id">corpClient</span>
| ID субъекта, которому будет предоставлена скидка по туркоду
| ID,ID
<>ID,ID
| 2772,2653
<>2786,2361
|-
| скидка по туркоду
| <span id="id">discount</span>
| Скидка<br/>
| "xxxКОД" (код валюты) или "XX%"
| 100RUB<br/>13%
|-
| код авторизации
| <span id="id">authCode</span>
| Код авторизации<br/>
| любое значение
| MB10
|}

== Ценообразование. ГРС SITA Gabriel ==

Задание ценовых правил для авиакомпании '''«Сибирь» (S7 Airlines)''' в ГРС ''SITA Gabriel'' имеет свою специфику. Поскольку для авиакомпании S7 в ГРС ''SITA Gabriel'' осуществляется только бронирование и выписка, а [[Поиск (Авиабилеты)|поиск]] ведется в других ГРС, цена перелета при поиске и при бронировании может отличаться на размер такс, которые есть в ГРC, используемой для поиска, но отсутствуют в ''SITA Gabriel''. Чтобы цена при переходе к бронированию не менялась, в ценообразовании задают специальные правила, где устанавливают скидку на размер таксы с использованием параметра '''Цена подтверждена''' (см. [[Ценообразование (Авиабилеты)#Параметры правил ценообразования|Параметры правил ценообразования]]).

Коды такс:
*в ГРС Sabre – ''YQF''.
*в ГРС Sirena – ''ZZ''.
*в ГРС Galileo и Amadeus – ''YQ''.
Размеры такс варьируются в зависимости от курса.

Каждое правило для перелетов авиакомпании '''«Сибирь» (S7 Airlines)''' разбивается на 2 отдельных строки:

# Правило ''для поиска'':
#* валидирующий перевозчик: '''''S7''''';
#* системы бронирования: '''''SITA''''';
#* цена подтверждена: '''0''';
#* сбор агентства: ''укажите скидку на размер таксы от ГРС, используемой для поиска + задайте размер сбора агентства''.
# Правило ''для бронирования'':
#* валидирующий перевозчик: '''''S7''''';
#* системы бронирования: '''''SITA''''';
#* цена подтверждена: '''1''';
#* сбор агентства: ''задайте только размер сбора агентства''.

{| class="wikitable"
|-
|[[Файл:Правила_цо_для_ак_сибирь.png|800px]]
|-
|Правила ценообразования для авиакомпании «Сибирь« (S7 Airlines)
|}


== ЕМД (EMD)== 
ЕМД - электронный многоцелевой документ или ваучер (см. [[Ваучер|Ваучер]]).
В разделе "Управление продажами → Авиабилеты → Ценообразование → Настройки" есть настройка '''Выпускать EMD на величину сборов заказа'''. Она отвечает за выпуск ЕМД на сбор агентства (доступно только для Сирены Трэвел). Принцип работы: если для агентства, которое покупает билет, в правилах ценообразования заведён сбор агентства для валидирующей компании авиа перевозчика, то при выписке заказа помимо маршрут-квитанции и ЕМД для дополнительных услуг, будет выписан отдельный ЕМД на сбор агентства. Если в заказе присутствуют несколько людей, то сбор разделится между ними, общая сумма сбора увеличена не будет.
== См. также ==
* [[Ценообразование для субагентов]]
* [[Валюта]]

MultiOW

2019-02-25T14:27:17Z

Мария Горшенева: /* Настройка */

'''MultiOW''' - составной перелет, скомбинированный из двух односторонних маршрутов, полученных в одной из ГРС. Такие перелеты на стороне ГРС оформляются в двух отдельных PNR, и, соответственно, имеют разные номера билетов.

{{Attention| Составные перелеты на данный момент доступны в ГРС Amadeus, Sabre и Travelport uAPI}}. <br>

==Назначение и цели создания==
Данная функциональность позволит предложить покупателям более низкие цены на перелеты, наиболее удобные стыковки, а также увеличить разнообразие вариантов перелетов в результатах поиска в целом.

==Принцип работы==
При поиске RT (Round Trip) и CR (Complex Route) перелета также запрашиваются варианты, комбинируемые из двух односторонних маршрутов - составные перелеты. Стоит учесть, что при одновременном использовании нескольких пакетов с включенной опцией поиска multiOW выдача значительно увеличится, поэтому следует создать правила фильтрации.


Выбирая составной перелет из результатов поиска, пользователь не увидит никаких различий при оформлении заказа, но в действительности в системе формируется три объекта заказа, два из которых реальные, а третий - формальный (составное бронирование). Первый содержит информацию о маршруте «туда», второй - о маршруте «обратно», третий представляет собой совокупность маршрутов «туда» + «обратно». Пользователи системы выполняют манипуляции именно с составным бронированием, осуществляя которые система обращается параллельно к двум отдельным PNR на стороне ГРС. Все три заказа доступны менеджерам и экспертам головного агентства и субагентства.
Практически все действия с реальными заказами запрещены. Доступ к операциям над реальными заказами откроется только в случае нарушения синхронизации, если, к примеру, были аннулированы сегменты на маршруте «обратно».

Из дополнительных услуг для MultiOW доступны: страхование, аэроэкспресс, сервисные пакеты.

== Настройка ==
Необходимо получить подтверждение от ГДС о том, что MultiOW включено для реквизита.
.

Заявку на включение MultiOW необходимо оформить в http://helpdesk.nemo.travel. Содержание заявки:

Заявка на включение MultiOW-режима.
Прошу включить опцию MultiOW для GDS <название GDS (Amadeus/Sabre/Travelport uAPI)> для <идентификатор Office ID/PCC>, номер пакета Немо Коннект <номер>



==Особенности работы с составным бронированием==

* Основные доступные действия с составным бронированием: бронирование, обновление, выписка, войдирование и аннуляция.
* Для работы с составным бронированием необходимо внести изменения в маршрут-квитанцию, заменить группу %PASSENGER% на %TICKET_GROUP%.
* Если один из перелетов успешно забронирован, но при бронировании второго перелета произошла ошибка, то забронированный перелет аннулируется.
* Если один заказ не выписан, а второй выписан, то в составном бронирование устанавливается статус «Проблемный», до решения вопроса с невыписанным заказом.
* Оформить составное бронирование можно только при включенном [[Ценообразование {{NameProject2}}|ценообразовании на {{NameProject2}}]] ''для перелетов и броней''.
* Для каждого заказа, входящего в составной, применяются свои правила ценообразования.  В детализации стоимости представлена сумма сработавших сборов, комиссий, скидок и т.д., а также таблицы отладки ценообразования по каждому валидирующему перевозчику (т.е. в таком перелете будут двойные сборы, комиссии, скидки).
* В качестве таймлимита выбирается наименьший из установленных в реальных заказах.
* Нотификации отправляются по общему заказу.
* Составные брони не попадают в статистику, поскольку в ней фиксируются именно реальные заказы.
* Такие заказы не выгружаются в формате СОФИ и Nemo, выгружаются реальные бронирования.
* Запрещено оплачивать через ГДС процессинг.
* Фильтры результатов срабатывают для всего составного перелета в целом.
Т.е., например, есть фильтр на стоимость не ниже 6000 руб. Составной перелет состоит из двух OW перелетов, стоимость одного 3749 руб., второго 3164 руб. Перелет в выдаче останется, т.к. фильтрация выполняется именно по сумме этих двух вариантов.
Или, например, есть фильтр '''+ содержит авиакомпании (marketing) в любом сегменте''' по авиакомпании Аэрофлот. В данном случае, весь составной перелет удалится из выдачи, если хотя бы в одном из OW перелетов в качестве маркетингового перевозчика будет Аэрофлот.

==Лимит составных перелетов на результатах поиска==
Составные перелеты комбинируются из двух односторонних маршрутов, поэтому поисковая выдача существенно увеличивается. К примеру, в настройках реквизитов установлено максимальное количество результатов 100, соответственно поставщик нам вернет 100 вариантов перелетов «туда» и 100 вариантов «обратно», комбинируя эти варианты мы получим несколько тысяч перелетов от одного поставщика. В целях снижения нагрузки предусмотрена фильтрация результатов поисковой выдачи обычной и мета API.

Лимит обычной поисковой выдачи: 20 самых дешёвых + 20 самых дешёвых прямых.
20 самых дешёвых вариантов «туда» комбинируются с 20 самыми дешёвыми вариантами «обратно», аналогично для самых дешёвых и прямых вариантов. Максимальное количество составных перелетов на обычной поисковой выдаче не превышает 800.

Лимит поисковой выдачи мета API: 8 самых дешёвых + 8 самых дешёвых прямых.
8 самых дешёвых вариантов «туда» комбинируются с 8 самыми дешёвыми вариантами «обратно», аналогично для самых дешёвых прямых вариантов. Максимальное количество составных перелетов на выдаче мета API не превышает 128.

Импорт PNR

2019-01-31T16:20:59Z

Мария Горшенева: /* Импорт нового PNR в систему {{NameSystem}} */

[[Категория:Модули]]
[[Категория:Встроенные модули]]
'''Импорт PNR''' — встроенный модуль системы {{NameSystemLink}} для импорта в систему ранее созданного PNR от поставщика.

== Назначение ==
Импорт PNR предоставляет менеджеру и экспертам агентства возможность добавить к заказам в {{NameSystem}} созданный вне системы [[PNR]] от поставщика:
* добавить PNR в существующий заказ в {{NameSystem}},
* или создать новый заказ на основе импортируемого PNR.

== Принцип работы ==
Импорт PNR доступен ''для менеджеров и экспертов корневого агентства''.<br>
Импорт нового PNR можно выполнить в любой заказ, независимо от статуса заказа. <br>
Во время импорта можно выбрать, требуется ли для нового PNR ''создать новый заказ'' в системе {{NameSystem}}, или новый PNR необходимо ''добавить к текущему заказу''. В первом случае будет создан новый заказ, а исходный останется без изменений. Импортируя в новый заказ, можно выбрать конкретного владельца в поле «Заказчик», т.о. автором нового заказа будет выбранный пользователь. При импорте PNR в текущий заказ владелец заказа остается прежний. В поле «Заказчик» можно указать либо конкретного пользователя агентства, либо группу для гостей.

С таким заказом можно выполнять все те же действия, что и с обычным заказом, созданным в {{NameSystem}}.

Функция так же поддерживает для менеджеров и экспертов корневого агентства возможность загружать и просматривать '''историю бронирования заказа''' (PNR). Опция работает для заказов, статус которых отличен от статуса''"Отложен"'', то есть для забронированных, выписанных, аннулированных и т.д. заказов. При вызове истории {{NameSystem}} отправляет запрос в [[ГРС]] на чтение истории бронирования. ГРС возвращает информацию о всех элементах, которые были внесены, изменены или аннулированы в данном PNR. Подробнее см. [[История бронирования]].

В данный момент опция поддерживается следующими поставщиками: [[Sabre]], [[Amadeus]], [[Travelport (Galileo)]] (+ Galileo uAPI), [[Сирена Трэвел]].

== Импорт нового PNR в систему {{NameSystem}}==

Чтобы импортировать PNR в {{NameSystem}}:
# Авторизуйтесь в качестве менеджера или эксперта корневого агентства.
# Откройте страницу интересующего заказа.
# Зайдите в '''Служебную информацию''' данного заказа.
# Нажмите на ссылку '''Импортировать новый PNR''' в блоке ''Все доступные действия с заказом''.
# Задайте параметры для импорта:
#* ''Импортировать в новый заказ'' — опция включает создание отдельного заказа с импортированным PNR,
#* ''PNR'' — введите буквенно-цифровой код импортируемого заказа, присвоенный поставщиком,
#* ''Фамилия пассажира'' — введите фамилию одного (любого) пассажира, который содержится в данном PNR,
#* ''Заказчик'' — укажите владельца нового заказа. Допустим ввод идентификатора пользователя/группы для анонимов, логин пользователя или его ФИ. По умолчанию в этом поле установлен текущий владелец заказа из которого выполняется импорт. Импорт в текущий заказ выполняется без смены владельца.
#* ''PCC'' — выберите пакет реквизитов, в котором содержится импортируемый PNR.
# Нажмите на кнопку ''Импортировать''.

После этого PNR будет импортирован в данный заказ или создан новый заказ с данным PNR.

{{Attention|Во избежание проблем перед импортом PNR в существующий заказ необходимо аннулировать старый PNR, и только затем импортировать новый.}}

{| class="wikitable"
|-
|[[Файл:ImportPNR1.jpg|450px]]
|-
|Вид окна импорта брони
|}

==См. также==
*[[Личный кабинет]]
*[[ГРС]]
*[[PNR]]
*[[Разделение PNR]]

Семейства тарифов

2019-01-14T15:43:58Z

Мария Горшенева:

[[Категория:Модули]]
[[Категория:Встроенные модули]]
[[Категория:Руководство]]

'''Семейства тарифов''' (англ. ''Fare Families'') — модуль системы онлайн-бронирования {{NameSystemLink}} для разделения тарифов на группы (бренды) в соответствии с применяемым уровнем сервиса.

==Семейства тарифов==
Уровень сервиса — набор предоставляемых в рамках тарифа услуг и условия их применения (условия возврата, обмена, [[класс обслуживания]], [[норма провоза багажа]], питание и прочее).

* В рамках одного семейства все тарифы имеют одинаковый уровень сервиса.
* В семействе может быть много тарифов, которые различаются условиями их применения (как правило, географией применения и стоимостью).

Семейства тарифов авиакомпании реализованы одних из двух способов:
* '''группы тарифов''' — разделение тарифов авиакомпаний на заданные группы в соответствии с предоставляемым уровнем сервиса. В рамках группы у всех тарифов одинаковый уровень сервиса. С технической стороны реализации такие группы распределяются по разным литерам бронирования — в каждой группе тарифы заводятся только на определённый набор литер.
* '''бренды''' (брендированные тарифы) — идеологическое разделение уровня сервиса на раздельные услуги, к числу которых относятся:
** собственно услуга перелёта
** наличие и количество бесплатного багажа
** наличие бесплатного питания
** обмен билета — наличие такой возможности и условия обмена
** возврат билета — наличие такой возможности и условия процедуры
** начисление баллов по программе лояльности, доступ в зал ожидания и прочее <br> Брендом (или брендированным тарифом) в данном контексте является определённый пакет услуг, которые содержатся в комплекте с перелётом. С технической стороны реализации в большинстве случаев весь набор брендов представлен на одну и ту же литеру класса бронирования (в рамках определённого базового класса — эконом/бизнес и т.д.).

===Использование семейств тарифов в {{NameSystem}}===
По умолчанию поиск в ГРС возвращает один наименьший тариф для определённого перелёта (комбинации сегментов). Как правило, по такому тарифу предоставляется наименьший уровень сервиса. Если пользователю нужен более высокий уровень сервиса, например, требуются более гибкие условия возврата/обмена), то без использования модуля для повышения уровня обслуживания после выписки билета по забронированному дешёвому тарифу, агент вручную обменивает билет в терминале.

Модуль '''Семейства тарифов''' предоставляет пользователю на выбор тарифы перелёта из различных семейств для бронирования тарифа в соответствии с его потребностями в уровне сервиса.

Наиболее распространенные ситуации, когда опция незаменима:
* пользователя интересуют только возвратные тарифы,
* пользователю требуется тариф, включающий багаж.

Опцию используют для упрощения продаж перевозок с более высоким уровнем сервиса. С использованием модуля ''Семейства тарифов'' больше нет необходимости проводить оффлайн обмен с повышением уровня сервиса и сопутствующих этому доплат клиента и взаиморасчётов по операциям.

==Принцип работы с семействами тарифов в {{NameSystem}}==
[[Файл:Пример работы Fare Families.png|thumb|550px|Окно выбора тарифа]]

Работа пользователя с семействами тарифов:
# Пользователь выполняет [[Поиск (Авиабилеты)|поиск]] авиабилетов.
# В результате пользователь получает страницу [[Результаты поиска|выдачи результатов поиска]], на которой отображаются результаты поиска с минимальными ценами за перелет.
# Пользователь выбирает перелет для перехода на [[Форма бронирования (Авиабилеты)|форму бронирования]].
# Перед переходом на форму бронирования пользователю отображается всплывающее окно выбора вариантов тарифов с краткой информацией об их условиях.
# Пользователь выбирает подходящий тариф, открывается форма бронирования перелета.

{{Attention|Если в разделе '''Управление продажами → Авиабилеты → Процессы → Форма бронирования''' включена настройка {{Setting|Авиабилеты: улучшенные элементы формы бронирования}} — {{Setting|Блок информации о заказе}}, то указанные выше пункты работают только для авиакомпаний '''S7''' и '''N4'''. Пункты 4 и 5 опускаются в случае, если перелет предоставлен другими авиакомпаниями.}}

Для работы с семействами тарифов {{NameSystem}} использует дополнительную операцию к перелёту, выбранному пользователем на странице результатов поиска, для получения вариантов его оценки в различных доступных семействах тарифов. В результате работы опции возвращает набор перелётов с ценами для разных семейств, которые отображаются пользователю как варианты для выбора.
Актуализация, бронирование, выписка и прочие операции с таким перелётом полностью аналогичны стандартной схеме работы. Сохранение выбранного пользователем семейства при таких операциях выполняется автоматически {{NameSystem}}, поэтому пользователю не нужно повторно выбирать семейство при переходе к бронированию, выписке и прочим операциям.

Описания для семейств и тарифов, которые входят в это семейство, заводятся в справочнике {{NameSystem}} (см. раздел [[Семейства тарифов#Справочник семейств тарифов Nemo.travel|Справочник семейств тарифов Nemo.travel]]).

{{Attention| Пользователю отображаются только те семейства, для которых есть описание в справочнике {{NameSystem}} независимо от используемой авиакомпанией технологии.}} Подробнее см. раздел [[Семейства тарифов#Справочник семейств тарифов Nemo.travel|Справочник семейств тарифов Nemo.travel]].

{{Attention| Если ГРС передает данные о багаже — для перелета отображаются полученные данные, в противном случае в разделе багажа отображается уведомление — «информация недоступна».}}

==Техническая реализация работы с семействами тарифов==
Семейства тарифов есть у большинства авиакомпаний. В большинстве случаев авиакомпании используют семейства тарифов в виде групп, бренды используют немногие компании. В зависимости от поддерживаемости брендов технология работы с семействами в ГРС различна.

Бренды авиакомпания заводит в ГРС, и ГРС возвращает {{NameSystem}} информацию о брендах перелета, их стоимости и услугах по запросу.<br>
Группы тарифов не описаны в ГРС, для таких семейств {{NameSystem}} проводит разделение тарифов на группы автоматически на стороне системы.

===Работа с брендированными тарифами===
Авиакомпания заводят бренды в ГРС как соответствующие сущности-бренды (как правило, через ATPCO Branded Fares). После этого ГРС поддерживает взаимодействие с брендами:
* получение вариантов оценки одного и того же перелёта в разных брендах,
* актуализация (проверка доступности) перелёта в рамках выбранного семейства,
* создание и выписка брони с тарификацией в рамках выбранного семейства.

Данный вариант технической реализации называется Airline Fare Families — а/к в явном виде предоставляют семейства как отдельные сущности, у которых есть свой код-идентификатор бренда и ГРС поддерживает работу с ними напрямую с помощью данного кода бренда.

===Работа с группами тарифов===
Для работы с группами тарифов {{NameSystem}}:
# запрашивает в ГРС список доступных для бронирования на данном перелёте тарифов,
# группирует тарифы по семействам на основании данных из [[Семейства тарифов#Справочник семейств тарифов Nemo.travel|внутреннего справочника {{NameSystem}}]].

К примеру, в Sabre данный способ включает следующие операции:
* взятие сегментов,
* получение списка применимых тарифов через ХМЛ аналог команды WPA,
* проверка наличия мест через экран доступности, в случае необходимости,
* определение семейств по статике для каждого тарифа,
* фильтрация с выбором наименьшего тарифа для каждого семейства.

Так как в случае групп тарифов они привязываются к определённым литерам, то при бронировании сохранение нужного семейства выполняется бронированием нужной литеры.

===Справочник семейств тарифов {{NameSystem}}===

Описания семейств тарифов и тарифных опций авиакомпаний заводятся в статичном справочнике системы, его актуальность поддерживается вручную. В связи с этим параметры семейств тарифов служат лишь справочной информацией и не являются публичной офертой. Для получения достоверной информации необходимо обращаться к условия применения бронируемого тарифа.<br>
Рекомендуем добавить информацию об этом в правила бронирования агентства.

{{Attention|Сбор данных по описанию семейств тарифов авиакомпаний — задача агентств.}} Если вы заметили расхождения в описании тарифных опций семейства тарифов и данных в УПТ, пожалуйста, сообщите в службу технической поддержки для актуализации данных в справочнике.

Источником данных для справочника семейств тарифов в {{NameProject2}} могут быть информационные разделы на сайтах авиакомпаний, к примеру, [http://www.aeroflot.ru/ru-ru/information/purchase/rate/fare_rules данный раздел] на сайте авиакомпании Аэрофлот, или [[Семейства тарифов#Доп. материал|информационная презентация]].

{{NameSystem}} не гарантирует наличия в справочнике описания всех семейства всех авиакомпаний.

Собранные агентством данные необходимо предоставить сотрудникам {{NameSystem}} для дальнейшей проверки и внесения в справочник.


====Доп. материал====
Информационные презентации:
*[[Файл:Agent and airlines Fare families.pptx]]
*[[Файл:MP Agent Fare Families.pptx]]

==Подключение Fare Families==
Опция подключается дополнительно администратором {{NameSystem}} по запросу агентства. Для подключения опции агентство направьте запрос в [http://helpdesk.nemo.travel проектный трекер системы].

{{AttentionBox|При включенном модуле семейства отображаются при следующих условиях:
* если для перелета найдены семейства тарифов.
* если перелет найден в поддерживаемых ГРС.

* для перелета с несколькими сегментами: если от ГРС пришла комбинация семейств тарифов, для разных авиакомпаний и семейств в том числе.
Выбор семейств двух и более разных авиакомпаний предоставляется в случае, если семейства всех перевозчиков заведены в путеводителе.}}

==Поддержка технологий Fare Families в {{NameSystem}} по поставщикам==

{| collspadding="10" border="1" class="wikitable"
! Поставщик !! Поддержка брендов !! Поддержка групп
|- align="center"
| Amadeus
| style="background-color: #99FF66;" | Да
| style="background-color: #99FF66;" | Да
|- align="center"
| Сирена Трэвел
| style="background-color: #99FF66;" | Да
| style="background-color: #99FF66;" | Да
|- align="center"
|- align="center"
| Sabre
| style="background-color: #99FF66;" | Да
| style="background-color: #FF6666;" | Нет
|- align="center"
| SITA Gabriel
| style="background-color: #FF6666;" | Нет
| style="background-color: #99FF66;" | Да
|- align="center"
| Galileo uAPI
| style="background-color: #99FF66;" | Да
| style="background-color: #FF6666;" | Нет
|- align="center"
| Galileo
| style="background-color: #FF6666;" | Нет
| style="background-color: #FF6666;" | Нет
|- align="center"

| TravelFusion
| style="background-color: #FF6666;" | Нет
| style="background-color: #FF6666;" | Нет
|- align="center"
| Nemo Inventory
| style="background-color: #FF6666;" | Нет
| style="background-color: #FF6666;" | Нет
|- align="center"
| Mystifly
| style="background-color: #FF6666;" | Нет
| style="background-color: #FF6666;" | Нет
|- align="center"
| SIG
| style="background-color: #FF6666;" | Нет
| style="background-color: #FF6666;" | Нет
|- align="center"
| Авиацентр (чартеры)
| style="background-color: #FF6666;" | Нет
| style="background-color: #FF6666;" | Нет
|- align="center"
|}

===Sabre===
В GDS [[Sabre]] на данный момент выбор семейства отображается только для тех авиакомпаний, которые загрузили в GDS тарифы через ''Branded Fares''. Список авиакомпаний уточняйте в GDS Sabre или на странице [https://www.sabretravelnetwork.com/airmerchandising/ Sabre Air Merchandising].


Для GDS Sabre получение семейств авиакомпаний, которые завели описания семейств тарифов через Branded Fares, в процессе разработки. Для работы модуля должен быть заполнен справочник в {{NameSystem}}.

===Sirena===
В ГРС [[Сирена Трэвел|Сирена Трэвел]] доступны для выбора все семейства всех а/к, для которых в {{NameSystem}} заведены описания. Такая возможность в ГРС Сирена Трэвел связана со спецификой получения семейств в этой ГРС.


{{Attention|Если в авиакомпании на разные литеры заведены разные семейства, то для перелетов с большим количеством сегментов (от четырех и более) может отбрасываться часть комбинаций семейств.}}

== Параметры семейств тарифов в справочнике {{NameProject2}} ==
Сбор данных по описанию семейств тарифов авиакомпаний — задача агентств. Источником данных для справочника семейств тарифов в {{NameProject2}} могут быть информационные разделы на сайтах авиакомпаний, к примеру, [http://www.aeroflot.ru/ru-ru/information/purchase/rate/fare_rules данный раздел] на сайте авиакомпании Аэрофлот.

Права для добавления нового семейства тарифов в справочник даны только сотрудникам {{NameSystem}} с администраторским доступом в панели управления {{NameProject2}}.

{| class="wikitable mw-collapsible mw-collapsed"
|-
! scope="col" colspan="2" | Список авиакомпаний, семейства тарифов которых заведены в справочнике
|-
! IATA-код
! Название авиакомпании
|-
| S7
| S7
|-
| UT
| ЮТэйр
|-
| U6
| Ural Air
|-
| SU
| Аэрофлот
|-
| AB
| Air Berlin
|-
| 7R
| РусЛайн
|-
| A3
| Aegean Airlines
|-
| LH
| Lufthansa
|-
| EY
| Etihad Airways
|-
| AC
| Air Canada
|-
| OS
| Austrian
|-
| LX
| Swiss
|-
| HG
| Niki
|-
| BT
| airBaltic
|-
| 5N
| Нордавиа
|-
| Y7
| Таймыр
|-
| J2
| Azerbaijan Airlines, Buta Airways

|-
| 6R
| Алроса
|-
| 4T
| Belair Airlines AG
|-
| WZ
| Red Wings
|-
| TP
| TAP Portugal
|-
| NN
| VIM
|-
| SK
| SAS
|-
| KL
| KLM
|-
| AF
| Air France
|-
| IK
| Икар
|-
| N4
| Nordwind
|-
| OK
| Czech Airlines
|-
| AZ
| Alitalia
|-
| LO
| LOT Polish Airlines
|-
| 9U
| Air Moldova
|-
| 5F
| Fly One
|-
| LA
| LATAM
|-
| R3
| Якутия
|-
| JU
| Air Serbia
|-
| A9
| Georgian Airways
|-
| D2
| Северсталь
|-
| SQ
| Singapore Airlines
|-
| MI
| Silkair
|-
| Z9
| Бек Эйр
|-
| JP
| Adria Airways
|-
| 2G
| Ангара
|-
| KC
| Air Astana
|-
| AY
| Finnair
|-
| IO
| ИрАэро
|-
| IG
| Air Italy
|-
| PS
| Ukraine International
|-
| IQ
| Qazaq Air
|-
| FZ
| flydubai
|-
| DV
| SCAT
|-
| A4
| Азимут
|-
| OU
| Croatia Airlines
|-
| CY
| Cyprus Airways
|-
| I8
| ИжАвиа

|}

В разделе '''Путеводитель → Семейства тарифов''' заводятся базовые параметры для каждого семейства. Параметры универсальны для всех пользователей {{NameSystem}}, их может редактировать только администратор {{NameSystem}}.

* {{Setting|Включено}} — включает отображение данного семейства тарифов.
* {{Setting|Дата начала продаж}} — семейства тарифов отобразятся на выдаче с установленной даты начала продаж.
* {{Setting|Дата окончания продаж}} — по прошествии даты окончания продаж семейства тарифов не отобразятся на выдаче.
* {{Setting|Дата начала перелетов}} — семейства тарифов отобразятся на выдаче для перелетов с вылетом после установленной даты начала перелетов.
* {{Setting|Дата окончания перелетов}} — семейства тарифов не отобразятся на выдаче для перелетов с вылетом после установленной даты окончания перелетов.
* {{Setting|Авиакомпания}} — задайте название авиакомпании, для которой работает данное семейство тарифов.
* {{Setting|Код}} — символы тарифа, однозначно определяющие его принадлежность этому семейству. Здесь допускается указывать часть кода тарифа — несколько символов, позволяющие определить его к этому семейству. Например, если в коде тарифа содержатся символы BS, то тариф принадлежит семейству Basic.<br />Есть если в коде тарифа содержатся указанные символы, то {{NameSystem}} определит его к этому семейству.
* {{Setting|Название}} — задает название в таблице семейств тарифов.
{{Attention|Название, отображаемое во всплывающем окне выбора тарифа, задается параметром семейства тарифов '''Описание тарифа'''. Если параметр этой категории отсутствует, то название семейства берется из строки '''Название'''.}}
* {{Setting|Базовый класс}} — класс, которому будет принадлежать семейство тарифов. Возможные варианты:
** ''Эконом''
** ''Бизнес''
** ''Первый''
* {{Setting|Коды тарифов}} — предоставляет возможность указать все коды тарифов, не используя при этом регулярное выражение.
* {{Setting|Регулярное выражение, описывающее код тарифа}} — задает регулярное выражение, включающее в себя все возможные коды тарифов, входящих в семейство.
* [[Файл:FF_-_кнопка_редактирования.png]] — кнопка редактирования, открывает дополнительные параметры задания семейств тарифов.

[[Файл:FF_-_Редактирование_параметров.png|900px]]

===Переопределение параметров семейств тарифов для агентства===
Для агентов предоставлена возможность переопределения некоторых параметров семейства тарифов через панель управления {{NameProject2}}. <br />
Переопределенные менеджером агентства параметры будут применяться только для домена данного агентства и будут отображаются на выдаче результатов поиска и во всплывающем окне выбора тарифа.<br />
Менеджер в любое время может вернуть настройки параметров семейств тарифов ко значениям, заданным в {{NameSystem}} по умолчанию — для этого нажмите кнопку '''Восстановить параметры семейства по умолчанию'''.

Чтобы отредактировать параметры семейства, нажмите на кнопку редактирования семейства тарифов [[Файл:FF_-_кнопка_редактирования.png]].

Параметры, доступные для переопределения агентом, расположены в блоке под ссылкой '''Параметры семейства тарифов''':
{| class="wikitable"
|-
|[[Файл:FF - Редактирование параметров агента.png|550px]]
|-
|Переопределяемые параметры
|}

Ссылка '''Параметры семейства тарифов''' — [[Файл:FF_-_ссылка_параметры_семейств.png]] — открывает окно для добавления нового параметра описания семейства тарифов. Параметров одинаковой категории может быть несколько, все они будут отображены в блоке информации о тарифе перелета.

[[Файл:FareFamiliesEx2.png|450px|Краткие описания на выдаче результатов поиска]]

=== Редактирование параметров семейства тарифов ===

* {{Setting|Включено}} — включает отображение параметра в окне выбора тарифа.
* {{Setting|Категория}} — выберите категорию параметра для отображения в описании семейства тарифов:
** ''Описание тарифа'' — краткое описание параметра отвечает за название семейства тарифов.
** ''Ручная кладь'' — отображается на выдаче результатов поиска, а также в блоке «Багаж».
** ''Багаж'' — отображается на выдаче результатов поиска, а также в блоке «Багаж», если включена настройка {{Setting|Брать информацию о багаже из путеводителя}} в разделе '''Управление продажами → Авиабилеты → Процессы → Форма бронирования''' в панели администрирования {{NameSystem}}.
** ''Выбор места'' — отображается только в блоке «Дополнительно» во всплывающем окне.
** ''VIP сервис'' — отображается на выдаче результатов поиска, а также в блоке «Дополнительно».
** ''Мили'' — отображается только в блоке «Дополнительно» во всплывающем окне.
** ''Питание'' — отображается только в блоке «Дополнительно» во всплывающем окне.
** ''Возвратность'' — отображается на выдаче результатов поиска, а также в блоке «Обмен и возврат».
** ''Возможность обмена'' — отображается на выдаче результатов поиска, а также в блоке «Обмен и возврат».
* {{Setting|Краткое описание}} — задайте краткое описание для параметра. Краткое название отображается в окне информации о семействе тарифов. <br />{{Attention|Для параметров категории ''Ручная кладь'' и ''Багаж'' краткое описание в блоке информации о семействе тарифов всегда начинается с «Ручная кладь — » и «Багаж — » соответственно, и это не зависит от краткого описания, указанного в параметре.}}
* {{Setting|Полное описание}} — задайте полное описание параметра. Полное описание отображается в окне информации о семействе тарифов при наведении курсора на краткое описание.
* {{Setting|Приоритет}} — задайте порядковое положение параметра в блоке при отображении в окне выбора семейств. Работает не во всех темах. 
* {{Setting|Платность услуги}} — задайте признак платности услуги. Может принимать три значения, в соответствии с которыми рядом с описанием параметра будет указан один из трех символов:
** ''Бесплатно'' — зеленая «галочка». [[Файл:Ff_free.png]]
** ''Платно'' — синий символ рубля. [[Файл:Ff_rub.png]]
** ''Недоступно'' — красный «крестик». [[Файл:Ff_forb.png]]

{{Attention|Для того, чтобы изменение в параметрах вступили в силу, необходимо направить запрос на сброс кэша семейств тарифов в [http://helpdesk.nemo.travel проектный трекер системы].}}

== Переменные в маршрут-квитанции для вывода значений параметров группы семейств тарифов ==

Для отображения в [[Маршрут-квитанция|маршрут-квитанции]] информации о тарифе выписанного билета необходимо задавать специальные переменные модуля семейств тарифов в отведенной для них группе <syntaxhighlight lang="text" enclose="none" style="font-size: 1.2em; padding: 0 3px; background: #F0F0F0; border: 1px dashed #2F6FAB;">%FLIGHT_TARIFF_GROUP%</syntaxhighlight>.

{{Attention|Переменные отображают полное описание (или краткое, если отсутствует полное) параметра, соответствующего их категории.}}

Для просмотра описания переменных <span style="background-color:gold">разверните таблицу</span>:

{| class="wikitable mw-collapsible mw-collapsed"
|-
! scope="col" colspan="2" | Переменные для группы семейств тарифов
|-
| %FLIGHT_TARIFF_FULL_NAME%
| Полное название тарифа
|-
| %FLIGHT_TARIFF_HAND_LUGGAGE%
| Информация о ручной клади
|-
| %FLIGHT_TARIFF_BAGGAGE%
| Информация о багаже
|-
| %FLIGHT_TARIFF_IS_CHANGEABLE%
| Информация об обмене билета
|-
| %FLIGHT_TARIFF_IS_REFUNDABLE%
| Информация о возврате билета
|-
| %FLIGHT_TARIFF_MILES%
| Информация о мильных бонусах
|-
| %FLIGHT_TARIFF_MEALS%
| Информация о питании
|-
| %FLIGHT_TARIFF_VIP%
| Информация о VIP-услугах
|-
| %FLIGHT_TARIFF_SEAT_SELECTION%
| Информация о выборе мест
|}

=== Предупреждение авиакомпании ===

Через переменную <syntaxhighlight lang="text" enclose="none" style="font-size: 1.2em; padding: 0 3px; background: #F0F0F0; border: 1px dashed #2F6FAB;">%SEG_AIRLINE_NOTICE%</syntaxhighlight> в маршрут-квитанции можно отобразить предупреждение авиакомпании. Данный текст задается в [[Локализация|языковой метке]] вида <syntaxhighlight lang="text" enclose="none" style="font-size: 1.2em; padding: 0 3px; background: #F0F0F0; border: 1px dashed #2F6FAB;">XX_ff_notice</syntaxhighlight> для отображения во всплывающем окне выбора семейства тарифов и <syntaxhighlight lang="text" enclose="none" style="font-size: 1.2em; padding: 0 3px; background: #F0F0F0; border: 1px dashed #2F6FAB;">XX_ir_notice</syntaxhighlight> — для передачи в переменную <syntaxhighlight lang="text" enclose="none" style="font-size: 1.2em; padding: 0 3px; background: #F0F0F0; border: 1px dashed #2F6FAB;">%SEG_AIRLINE_NOTICE%</syntaxhighlight> в маршрут-квитанции.

{{Attention|Переменная задается в группе <syntaxhighlight lang="text" enclose="none" style="font-size: 1.2em; padding: 0 3px; background: #F0F0F0; border: 1px dashed #2F6FAB;">%SEGMENT%</syntaxhighlight>.}}

== Перевод описаний семейств тарифов ==

Процесс внесения переводов для опций, входящих в семейства тарифов:

1) Авторизируйтесь на домене вашего агентства (из раздела настроек "Домены и протоколы") под учетной записью менеджера головного агентства.

2) Вставьте в адресную строку вашего браузера view-source:https://домен/api/guide/airlines/fares/lang?apilang=язык_для_перевода (язык_для_перевода указывать в формате, например, en)

По указанной ссылке при авторизации под менеджером головного агентства вам будут доступны все метки для перевода опций, входящих в семейства тарифов.
Слева будут перечислены названия переменных, в качестве названий взяты названия опций на английском языке, справа (после двоеточия) - их значения для того языка, код которого указан в параметре apilang в ссылке выше.

3) Если вы видите, что справа от названия переменной отсутствует перевод: "", вам нужно скопировать название переменной, например "Refund After Departure", затем перейти в раздел настроек "Управление сайтом - Языковые ресурсы", выбрать в параметре "Язык:" узбекский язык, в параметре "Услуга:" значение "Ядро", а в параметре "Файл" значение "lang_new.php" создать данную переменную и внести для нее перевод.

4) После внесения перевода он появится справа от соответствующего названия переменной в данных по ссылке view-source:https://домен/api/guide/airlines/fares/lang?apilang=язык_для_перевода.

5) Все внесенные указанным выше способом переводы опций семейств тарифов будут доступны на вашем сайте.

== См. также ==
* [[Тариф]]
* [[Выбор тарифа для авиакомпании S7 Airlines]]
* [[SITA Gabriel]]
* [[Sabre]]
* [[Amadeus]]
* [[Сирена Трэвел]]
* [[Маршрут-квитанция]]

== Полезные ссылки ==
* [https://www.sabretravelnetwork.com/airmerchandising/ Sabre Air Merchandising]

Сирена Трэвел

2018-11-15T12:58:38Z

Мария Горшенева: /* Настройки оплаты через платежный шлюз Сирена Трэвел (2-я версия) */

[[Категория:Поставщики авиабилетов]]
[[Файл:Sirena.jpg‎|справа]]

'''Сирена Трэвел''' — крупнейшая российская компания, оказывающая услуги по бронированию и продаже авиабилетов, мест на культурно-зрелищные мероприятия, оформлению страховых полисов и т.п. Компания осуществляет эксплуатацию первой отечественной аккредитованной авиационной распределительной системы (АРС) «Сирена Трэвел», разработанную в соответствии с рекомендациями IATA ([[Международная ассоциация воздушного транспорта (IATA)]]), которая предоставляет агентствам интерфейсы для бронирования и продажи билетов, а — авиакомпаниям инструменты для управления и контроля ресурсами мест.

==Онлайн бронирование авиабилетов через Сирена Трэвел==

Для бронирования авиабилетов через Сирена Тревэл на сайте в режиме онлайн необходимо подключиться к [http://www.nemo.travel системе бронирования {{NameSystem}}] [http://www.nemo.travel Сайт системы {{NameSystem}}] (модуль продажи авиабилетов через Сирена Тревел)

== Описание ==
Система бронирования [http://www.nemo.travel {{NameSystem}}] поддерживает продажу авиабилетов на сайте агентства через глобальную распределительную систему Sirena Travel (Sirena 2000).

[[Изображение:Nemo-goto.png|center|link=http://nemo.travel]]

== Основные возможности ==
<div class="toccolours mw-collapsible mw-collapsed" style="width:800px; margin-bottom:12px;">
'''Поиск и общее'''
<div class="mw-collapsible-content">
* Поиск по окружным датам — условно[[#FAQ по GDS/ГРС/API Sirena Travel|<sup>[1]</sup>]]
* Поиск по публичные + приватные тарифы[[#FAQ по GDS/ГРС/API Sirena Travel|<sup>[2]</sup>]]
* Поиск приватных тарифов[[#FAQ по GDS/ГРС/API Sirena Travel|<sup>[2]</sup>]]
* Поиск по расписанию
* Максимальное количество пассажиров всех типов в поисковом запросе — 9
* Количество пассажиров одного типа в запросе — 9
</div>
</div>

<div class="toccolours mw-collapsible mw-collapsed" style="width:800px; margin-bottom:10px;">
'''Бронирование'''
<div class="mw-collapsible-content">
* Дополнительные операции с использованием реквизитов/настроек
** Чтение тарифных правил
** Проверка доступности
** Актуализация цены
** Возвращаемые типы тарифов — Public
* Операции/запросы .NET авиа-сервера
** Бронирование перелета
** Отмена брони
** Обновление (синхронизация) брони
** Импорт брони по ПНР локатору
** Получение истории брони из ГДС
** Изменение внесённого контента брони
** Добавление контента
** Контент через WS — ТКП
</div>
</div>

<div class="toccolours mw-collapsible mw-collapsed" style="width:800px; margin-bottom:10px;">
'''Выписка'''
<div class="mw-collapsible-content">
* Из реквизитов/настроек
** Выписка на стоке авиа-компании[[#FAQ по GDS/ГРС/API Sirena Travel|<sup>[3]</sup>]]
* Операции/запросы .NET авиа-сервера
** Выписка билетов для всей брони
** ГДС процессинг
** Войдирование
** Возврат билетов
</div>
</div>

== Подключение к Сирена Трэвел ==
Для реализации своего интернет-пункта продажи [[агентство]] должно иметь либо свой договор с ЗАО «Сирена Трэвел», либо быть субагентом агентства, уже имеющего такой договор.

В заявке на подключение нового ClientID нужно указать разрешенные IP-адреса серверов:

'''188.235.129.232''' <br/>
'''37.200.71.164'''<br/>
'''95.213.141.253'''<br/>
'''37.200.70.250'''<br/>
'''95.213.141.254'''<br/>
'''37.200.71.162'''<br/>

Такой договор позволяет заключить дополнительное соглашение с ЗАО «Сирена Трэвел» на использование программного средства «Операционный шлюз системы бронирования "WS-Gate"» с необходимым агентству количеством сеансов (под сеансом подразумевается либо нейтральный сеанс (ТКП), либо сеанс авиакомпании) для работы с одним сайтом (вопрос работы с несколькими сайтами, а именно с сайтами субагентств, решается отдельно). Текст дополнительного соглашения, включающий в себя основную часть, техническое задание, описание регламентов, процедур, ссылки на документацию по XML, можно найти в агентском разделе на [http://www.sirena-travel.ru сайте] или получить в ЗАО «Сирена Трэвел». По завершении разработки агентство должно направить в ЗАО «Сирена Трэвел» запрос на тестирование работы интернет-пункта продажи и письмо о переводе в боевой режим сеансов, указанных в договоре.

При заключении договора с компанией «Сирена Трэвел», клиенту присваивается тестовый ERSP-код и ID клиента (Client_id).

Важным моментом является то, что для начала работы требуется не только тестирование со стороны ЗАО «Сирена Трэвел», но и аккредитация интернет-пункта продажи в ТКП (необходимые документы можно найти в агентской части на [http://www.tch.ru сайте]). При этом:
* сертифицируется сеанс ТКП;
* если расчет по кредитным картам идет не через ТКП, то сайт аккредитуется с правом бронирования и продажи;
* если расчет по кредитным картам идет через ТКП, то сайт аккредитуется с правом бронирования, продажи и оплаты.

Телефон отдела аккредитации агентств: (495) 660 19 78.

'''Для подключения к Сирене необходимы следующие реквизиты:'''
# Sirena2000 клиент ID;
# Sirena2000 IP адреса сервера;
# Sirena2000 порт сервера;
# Sirena2000 ERSP код.

==== IP и порты,используемые в {{NameSystem}} ====

{| class="wikitable"
! среда
! ip:порт
! ip:порт
|-
| ГРС (рабочая система)
| 193.104.87.251:34321
| 194.84.25.50:34321
|-
| ГРТ (тестовая система)
| 193.104.87.251:34322
| 194.84.25.50:34322
|-
| ГРУ (учебная система)
| 193.104.87.251:34323
| 194.84.25.50:34323
|}

{{Attention|При переходе с тестового режима на боевой необходимо сменить порты.}}

== Особенности работы с Sirena Travel ==
# При поиске Сирена возвращает только опубликованные тарифы.
# У данного поставщика нет возможности выбрать сложный маршрут. Максимальное количество сегментов согласно документации — два.
# Внесение данных о визе возможно только с терминала Сирены. Это связано с тем, что в [[ГРС]] пока не реализовано понятие secure flight и информация о необходимости внесения ремарок [[ПНР]] выводится только как сообщение по справке о наличие мест.
# Возможна ситуация, когда [[авиакомпания]] меняет значение таксы уже после бронирования. Система {{NameSystem}} в данном случае обновит цену перед выпиской.
# Для следующих авиакомпаний таксы РУ и SA не считаются (авиакомпании не требуют учёта такс в цене):
#* Авиакомпания Татарстан, такса SA 500 р.
#* Авиакомпания Руслайн, такса РУ 300 р.
#* Авиакомпания Сибирь, такса SU 1000 р.
#* Авиакомпания Трансаэро, такса SA 210 р.
# Для авиакомпании «Аэрофлот» (SU) не учитывается такса PS.
# Возможна ситуация, когда при стандартном прайсинге в Сирене возвращаются не наиболее дешевые тарифы АК по данному направлению, а тарифы, которые являются маршрутными, а потому более приоритетными. Под маршрутными понимаются тарифы, заданные для направления, в котором имеются промежуточные пункты перелета. При этом при бронировании таких перелетов, возвращается более дешевый тариф и цена заказа уменьшается. Это стандартное поведение системы бронирования, на которое никак не влияет производится ли процесс непосредственно в терминальном режиме или через вебсервисы.
# Возможна ситуация, когда от Сирены приходит ответ по ряду авиакомпаний на отсутствия рейда (маршрут и информация о багаже). В этом случай в системе {{NameSystem}} есть проверочный запрос. Перед бронированием система отсылает справочный запрос в Сирену и получает информацию, доступны ли рейды у данной авиакомпании. Если доступны, то запрашивает рейды и выводит информацию о маршруте и багаже. В случае если не доступны, то в созданном бронировании такой информации не будет.
# Информацию о норме провоза багажа через вебсервисы Сирены гарантированно можно получить по умолчанию только после бронирования. Чтобы данные о багаже приходили на этапе поиска и актуализации перелета, надо запрашивать в ГРС для конкретного client_id включение опции отображения багажа в параметре baggage для запросов pricing и pricing_flight соответственно.
# Системой в ответ на запрос может отдаваться разное количество вариантов. В любом случае будет отдано количество вариантов, указанных в min_results. Но до max_results может не дойти, если сработает внутрисистемное ограничение. Если какое-либо ограничение срабатывает и отдаются не все варианты, в ответе будет указано: «cut».
# Возможна ситуация, что видно перелеты в терминале, но на сайте они не отображаются поскольку заведены как чартерные тарифы. Как правило стоимость таких тарифов нулевая, но не всегда. Может быть категория пассажира — ЗРА. Такие перелеты невозможно получить в онлайн.
# Если есть необходимость комбинировать подклассы в перелете, необходимо в разделе: «Авиабилеты» → «Реквизиты подключения к GDS» — отметить поле '''«Комбинировать подклассы на сегментах по маршруту перевозки»'''.

=== Выписка в ГРС Сирена Трэвел===

Выписка билетов в Сирена Трэвел осуществляется после приема оплаты. Для каждой формы оплаты [[турагентство]] может установить свое время на оплату, обратившись в службу поддержки по почте webhelp@sirena-travel.ru или по телефону +7 (499)724-39-66, доб. 155. По умолчанию для всех форм оплаты установлено время 15 минут.

На возможность выписки в общем случае влияют 3 параметра:
# таймлимит на места;
# срок действия тарифа;
# настройка сайта для данной формы оплаты.

Для логики, реализованной в {{NameSystem}}, на возможность выписки влияют [[таймлимит]] на места и срок действия тарифа. Сирена выбирает наименьшее из двух значений.

Таймлимит на места может быть изменен авиакомпанией — в этом случае сообщение от авиакомпании приходит в очередь 10 в Сирене, которая должна контролироваться оператором.

{{Attention|Если срок действия тарифа истек, то в рамках данного заказа невозможно применить его вновь. Это может сделать только оператор с пульта Сирены.}}

{{Attention|Возможны ситуации, в которых при недостаточном количестве виртуальных пультов некоторые запросы (например, выписка, подтверждение выписки) могут не выполниться, при этом ответа от Сирены не придет. Для решения данной проблемы необходимо увеличить количество виртуальных пультов.}}

На стороне Сирены существуют настройки — минимальное время до таймлимита ПНР и минимально допустимое время на оплату (например, 5 и 5 минут). При оплате, исходя из этих настроек высчитывается время на оплату, а именно, из оставшегося времени до таймлимита (например 7 минут) высчитывается минимальное время до таймлимита ПНР (5 минут) и сравнивается с минимальным допустимым временем на оплату, в данном случае это 7-5 = 2 < 5. И в случае если время меньше, то оплата уже невозможно начать.
Для изменения данной настройки необходимо обратиться в службу поддержки Сирены.

=== Новые статусы брони в Сирена Трэвел ===

*'''unconfirmed_sale''' — означает, что оплата не подтверждена (возникли какие-то проблемы с выпуском билета). Обычно заказ находится в этом статусе очень короткое время. Если же заказ завис в таком статусе, то, скорее всего, имеет место сбой. Необходимо обратиться в службу техподдержки.
*'''mso''' — билет не продан, но квитанция МСО напечатана;
*'''mсo returned''' — квитанция сдана.

=== Сессии в Сирене ===

Сессия — это работа одного пульта пункта интернет-продаж.

Порядок действий при подключении дополнительных пультов:

# [[Агентство]] заказывает дополнительные пульты в Сирене и прописывает их в договоре.
# Получив номера пультов, агентство обращается в ТКП с просьбой аккредитовать их в ТКП (образцы заявок можно найти на [http://www.tch.ru сайте] в разделе [http://www.tch.ru/rus/svvt_today/rights Регулирование прав продажи агентств в ССВТ].
# После аккредитации дополнительного пульта агентство обращается в Сирену с просьбой открыть продажу на данном пульте, прикладывая к ней ответ ТКП об аккредитации.

Если смотреть на этот процесс с технологической точки зрения, то добавление пульта пункта интернет продаж (ПИП) означает добавление нового технологического адреса в конфигурацию офиса.

При отсутствии вопросов у ТКП и Сирены процесс добавления пульта и его аккредитации занимает 2-3 рабочих дня.

По информации от Сирены, для средних объемов продажи количество пультов, не превышает 5.

Максимальное количество дополнительных пультов (сессий), известное на текущий момент — 10.

=== Заведение агентских сборов ===

В Сирене есть механизм ведения агентских сборов, который работает в любом сеансе. При этом его использование обязательно только для e-commerce ТКП. Для оплаты через eGo в сеансе BSP вы можете как пользоваться механизмами Сирены по ведению сборов, так и накидывать сбор сами при передаче к оплате в eGo. При тарификации через XML-шлюз Сирены вы имеете возможность понять, заведен ли [[сбор]] на данный вариант оплаты или нет (при этом надо соблюсти те же условия (ППР, ERSP, форма-оплаты…) при которых будет производится оплата).

'''eGo''' — платежный шлюз процессинговой системы.

'''e-commerce ТКП''' — один из вариантов оплаты, доступный через eGo.

=== Таймлимит для Сирена Трэвел в {{NameSystem}} ===

[[Таймлимит]] может быть назначен двумя способами:
# Автоматический таймлимит (с использованием данных «Правил назначения таймлимита» авиакомпании);
# С использованием данных [[УПТ]] (категории 5), то есть по оценке.

Сразу после бронирования таймлимит автоматически устанавливается в соответствии с данными «Правил назначения таймлимита» авиакомпании. Если для авиакомпании в системе выставлен признак назначения таймлимита по оценке (по данным УПТ — категория 5), то если оформление билета сразу производиться не будет, то для того, чтобы завершить ПНР (запрос Е/И), необходимо переустановить таймлимит в соответствии с данными УПТ. Иначе система выдает реплику: «УСТАНОВИТЕ ТАЙМЛИМИТ ПО ОЦЕНКЕ (ЗАПРОС ТЛ)».

{{Attention|На значение таймлимита для заказов в Сирене влияют настройки {{NameSystem}}. За основу берется минимальное значение.}}

В системе {{NameSystem}} таймлимит для Сирены отображается на 2 страницах:

* На странице подтверждения бронирования — здесь выводится таймлимит авиакомпании, который приходит в {{NameSystem}} при поиске с учетом настроек.
* На странице с информацией о готовом заказе — здесь отображается окончательный таймлимит, пришедший от Сирены с учетом настроек {{NameSystem}}.

{{Attention|Окончательный таймлимит для заказа в Сирене можно получить только после бронирования.}}

=== Синхронизация заказов ===

Для поставщика Сирена Трэвел можно использовать модуль синхронизации заказов. Подробнее: [[Синхронизация заказов]]

=== Вид маршрут-квитанции, рекомендованный ТКП для Интернет-пунктов продаж ===

Маршрут-квитанцию (Сирена-Трэвел) с элементами латиницы можно посмотреть здесь: [[Файл:itteng.pdf]]

Маршрут-квитанцию (Сирена-Трэвел) с элементами кириллицы можно посмотреть здесь: [[Файл:Ittrus.pdf]]

=== Стоки ===

В этом разделе представлена выдержка из документа: «ТЕХНОЛОГИЯ ЗАКАЗА, РАСПРЕДЕЛЕНИЯ, УЧЕТА И КОНТРОЛЯ ИСПОЛЬЗОВАНИЯ БЛАНКОВ СПД И КВОТ ЭЛЕКТРОННЫХ БИЛЕТОВ НСАВ-ТКП».

1. Порядок предоставления агентством и рассмотрения в ТКП заявки на получение бланков СПД и других бланков, а также квот электронных билетов НСАВ-ТКП.

1.1. Агентство в рамках Стандартного договора ТКП с агентством самостоятельно определяет потребность в бланках СПД и других бланках (далее – бланки), а также квотах электронных билетов на предстоящий период и представляет в ТКП «Заявку на получение бланков СПД, других бланков и квот электронных билетов НСАВ-ТКП» (далее – Заявка), оформленную в соответствии с Приложением 1.

1.2. Заявка предоставляется агентством в ТКП заблаговременно, с учетом сроков рассмотрения заявки и времени, необходимого для перечисления и зачисления на расчетный счет ТКП денежных сумм, указанных в Извещении, в соответствии с п.п.3.4 и 3.8.1 настоящей технологии.

1.3. Заявка может быть направлена в ТКП для предварительного рассмотрения по факсу, телеграфному каналу АФТН, электронной почте, ИНФОСЭД, почтой или нарочным. При этом к моменту получения бланков представителем агентства в ТКП должен быть предоставлен оригинал данной Заявки.

1.4. Заявка рассматривается в ТКП в течение 4-х рабочих дней со дня ее поступления.

1.5. Количество выдаваемых бланков форм Е61, H61, D61, Z61, 35, 30, M61 и предоставляемых квот электронных билетов определяется ТКП исходя из Заявки и условий Стандартного договора ТКП с агентством.

1.6. Количество выдаваемых бланков квитанций разных сборов формы К95, бланков формы С98 и бланков ярлыков пачки/партии определяется ТКП, исходя из Заявки. ТКП имеет право сократить количество выдаваемых бланков данных форм исходя из имеющихся запасов.

1.7. Количество выдаваемых бланков форм А61, S11, T12, бланков грузовых накладных определяется ТКП, исходя из Заявки и отдельных договоров или соглашений.

1.8. После рассмотрения Заявки ТКП направляет агентству Извещение о рассмотрении Заявки (далее – Извещение). Извещение направляется агентству по электронной почте. 1.8.1. В случае принятия положительного решения о выдаче бланков в Извещении указываются формы и количество бланков, адрес, сроки, и условия получения бланков, суммы к оплате, банковские реквизиты, другие условия получения бланков, а также предоставленные квоты электронных билетов. 1.8.2. В случае уменьшения количества выдаваемых бланков и предоставляемых квот электронных билетов и в случае отказа в выдаче бланков и предоставлении квот электронных билетов в Извещении указывается причина того или иного решения. Причинами отказа в выдаче бланков и предоставления квот электронных билетов или уменьшения количества выдаваемых бланков и квот электронных билетов могут послужить: невыполнение агентством условий Стандартного договора с ТКП, наличие достаточного запаса бланков и квот электронных билетов у агентства и т.п.

1.9. При получении Извещения с отказом в выдаче бланков и предоставлении квот электронных билетов агентство устраняет причины, указанные в Извещении, и уведомляет ТКП об этом, после чего Заявка заново рассматривается в ТКП в установленном порядке. 1.10. При предоставлении агентству квот электронных билетов ТКП размещает в ЦЭБ информацию о предоставленных агентству квотах электронных билетов. 1.11. Если в течение 10-ти дней после направления агентству Извещения представитель агентства не прибыл в ТКП для получения бланков, Заявка считается аннулированной в части бланков. В случае наличия в агентстве потребности в бланках на предстоящий период агентство представляет в ТКП новую Заявку.

=== Получение перелетов с пересадками в разных аэропортах ===

В ГРС Сирена Трэвел есть возможность получения перелетов с пересадками в разных аэропортах без использования сложного маршрута (пример: Екатеринбург - Домодедово, Москва; Внуково, Москва - Фергана).
Функциональность подключается администратором системы {{NameSystem}}. Для ее включения необходимо оставить заявку в проектном трекере [http://helpdesk.nemo.travel helpdesk.nemo.travel]

{{Attention|Для подключения новой функциональности необходимо подписание дополнительного соглашения между агентом и ГРС "Сирена Трэвел".}}

==Платежные шлюзы Сирена Трэвел==

=== Платежный шлюз «E-commerce» ===

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

Специфика спектра услуг, предоставляемого компанией интернет-магазинам предприятий, предлагающих пользователям сети традиционный «трэвел» контент связана, в первую очередь, с уникальными технологиями, основанными на глубокой интеграции с системами бронирования авиабилетов – ГРС (Сирена Трэвел, Galileo, Sabre, Amadeus) и партнёрских отношениях с транспортной клиринговой палатой (ТКП).

Высокая надежность и безопасность системы подтверждена сертификатом PCI DSS, а также платежными системами VISA и MasterCard.
Помимо процессинга банковских карт (VISA, MasterCard, JCB) компания осуществляет маршрутизацию платежей, осуществляемых при помощи электронных денег (Яндекс деньги, Web Money), различных платежных систем (Рапида, Элекснет, Qiwi) и оплат, осуществляемых через крупнейшие сети приема платежей (Евросеть, Связной).

=== МПС (EgoPay) ===

Платежное решение Сирена Трэвел (2-я версия), позволяет оплачивать билеты не только ТКП, но и BSP. Причем поддерживает прямой процессинг в БСП.

Преимущества второй версии — возможность оплачивать билеты, забронированные в ГРС Galileo, Sabre, Amadeus, а также Отелей и ж/д перевозки.

Возможно проводить оплату с отрицательными сборами.

{{Attention|Сумма со скидкой не будет списана со счета клиента, но разницу агентство должно самостоятельно компенсировать при расчетах с АК.}}

==== Настройки оплаты через платежный шлюз Сирена Трэвел (2-я версия) ====

Настройки для данного способа оплаты на стороне {{NameSystem}} находятся в разделе '''«Финансы и платежи» → «Платежные методы» → «Управление шлюзами» → «Сирена 2».'''
* '''«Боевой режим»''' — отвечает за перевод данного способа оплаты в боевой режим.
* '''«Использовать оплату с фискализацией»''' — при включении настройки в платежную систему передается необходимая информация для формирования фискального чека. <span style="background-color:#fff0f5;">'''<span style="color:#ff0000;">Внимание!</span> Убедитесь, что на стороне МПС для вашего shop_id включена оплата с фискализацией.</span>
* '''«Параметры фискализации»''' — опция регулирует список параметров, передаваемых в чеке. Если ни одна позиция не выбрана, то по умолчанию будут переданы все позиции, а именно: авиабилет, аэроэкспресс, страхование, сервисный пакет, услуги агентства, сервисный сбор и комиссия за оплату.
* '''«Логин»''' — предоставляется сотрудниками Сирена Тревел.
* '''«Пароль»''' — предоставляется сотрудниками Сирена Тревел.
* '''«Идентификатор магазина BSP»''' — предоставляется сотрудниками Сирена Тревел.
* '''«Идентификатор магазина TKP»''' — предоставляется сотрудниками Сирена Тревел.
* '''«Префикс к коду оплаты»''' — согласуется с платежным шлюзом и используется для формирования платежного кода. Пример значения: 123
* '''«Время до автоматической отмены платежа в минутах ( рекомендуется 10)»''' — регулирует таймлимит на оплату для платежной сессии.
* '''«Переопределение наценки для GDS–процессинга (пусто - отсутствует)»''' — наценка за проведение оплаты через GDS–процессинг.
* '''«Предпочитаемая валюта»''' — валюта оплаты.
* '''«Способ оплаты»''' — варианты проведения оплаты, доступные в платежной системе.
* '''«Текст для офлайновых способов оплаты»''' — сообщение, отображается покупателю если выбран способ оплаты оффлайн (Евросеть, QIWI, Rapida).
* '''«Высота платежного фрэйма»''' — необходимо задать значение, определяющее высоту фрэйма, в пикселях.
* '''«Отображать фрэйм со страницей оплаты на странице информации о заказе»''' — при включенной настройке, на форме бронирования 2.0 будет фрэйм с платежным шлюзом.
* '''«Краткая информация о квитанции для отображения пользователю»''' — здесь можно добавить краткое описание платежного метода для отображения его в блоке ПШ при выборе способа оплаты.
* '''«Шаблон квитанции для печати»''' — здесь можно задать вид квитанции к печати.
* '''«Использовать GDS-процессинг»''' — опция отвечает за проведение оплаты через GDS-процессинг. (по умолчанию включена)
* '''«Передавать источник (host) заказа»''' — включает передачу информации о GDS в МПС. Не рекомендуется включать параметр, если GDS, для которой используется этот платёжный метод, отлична на Сирена Тревел. При выключенном параметре выписать заказ МПС не может, выписка будет запускаться со стороны Немо.

==== Транзакции в платежном шлюзе Сирена ====

Взаимодействие с платежным шлюзом происходит в 3 этапа:
* создание транзакции;
* запрос о состоянии транзакции;
* подтверждение оплаты или возврат денег.

==== БСП- и ТКП-варианты оплаты ====
В данном платежном шлюзе возможны БСП- и ТКП-варианты оплаты. Техническое отличие в том, что при ТКП-варианте оплаты выписка билета происходит автоматически в Сирене и {{NameSystem}} не инициирует выписку, а только получает информацию о выписанных билетах. Это происходит при попытке выписки со стороны {{NameSystem}}.

==== Создание транзакции ====
При создании транзакции определяется компонент бронирования и составляется соответствующее описание заказа. Описание заказа существенно только для авиаперевозок. Также, если компонент бронирования — авиаперевозки, определяется, возможен ли ТКП-сеанс оплаты (через e-commerce ТКП) для данного авиаперелета и используются соответствующие реквизиты. Если ТКП-оплата возможна, но не задан реквизит «Идентификатор магазина TKP», используется реквизит «Идентификатор магазина BSP». При отсутствии ключевых реквизитов (Идентификатор магазина BSP, Логин, Пароль ) запрос не будет отправлен и появится соответствующая ошибка.

==== Запрос о состоянии транзакции ====
Данный запрос повторяется по расписанию раз в 5 минут с момента создания транзакции в Сирене, а так же по факту перенаправления пользователя Сиреной в {{NameSystem}}. При создании транзакции указывается время ее жизни. Соответственно, после истечения этого времени или по факту оплаты или отмены платежа состояние транзакции фиксируется в {{NameSystem}} и запросы прекращаются.

==== Подтверждение платежа ====
Запрос на подтверждение отправляется системой {{NameSystem}} в автоматическом режиме. Для авиаперелетов — после выписки билета в {{NameSystem}}. Для всех остальных компонентов — либо сразу после успешного запроса о статусе транзакции (для прямой оплаты) или после бронирования (для предоплаты). Для авиаперелетов в случае ошибки при отправке запроса или получения недостаточных данных запрос ставится в очередь и повторяется раз в сутки. Для остальных компонентов запрос ставится в очередь только после получения ошибки на него со стороны Сирены.

====Автоматический возврат средств при аннуляции заказа====

Чтобы включить автоматический возврат средств, но ''не выписанных'' заказов, включите опцию '''Автоматически вернуть деньги после отмены заказа (только Депозит и МПС)''' в разделе '''Финансы и платежи → Платежные методы → Устаревшая версия → Платежные шлюзы'''. <br>
Опция активирует автоматический возврат средств при аннуляции заказов, оплаченных через МПС или по [[депозит]]у.

Доступ к отмене оплаченного заказа имеет только менеджер или эксперт главного агентства. Только под этими пользователями можно провести автоматический возврат средств при аннуляции заказа. Остальные пользователи отправляют заявку на аннуляцию заказа.

==Ошибки при взаимодействии с GDS/ГРС/API Sirena Travel==

<div class="toccolours mw-collapsible mw-collapsed" style="width:800px; margin-bottom:12px;">

'''Ошибки при взаимодействии с ГРС Sirena Travel'''
<div class="mw-collapsible-content">
''' Ошибки при поиске '''
{| class="wikitable"
|-
! align="center" width="50%"|«You are not allowed to perform this operation!»
|Данная ошибка возникает из-за настроек на стороне Sirena Travel в случае, если реквизиты, которые используются агентом не прописаны для той среды в которую отправляется запрос, либо некоторые операции не закреплены в Sirena Travel для используемых реквизитов.
|-
! align="center" width="50%"|«В результатах выдачи отсутствует рейсы авиакомпании «Саратовские авиалинии» 6W»
|Вероятно, в критериях поиска введен пассажир категории ребенок. В авиакомпании 6W заведено тарифное правило — если тариф применяется для пассажира с кодом РМГ, РВГ, РБг или АГА (дети), то бронироваться должны определенные места, что через xml-шлюз не реализовано.
|-
! align="center" width="50%"|Ошибка от поставщика.. Please retry in 15 seconds
| Возникает из-за перегрузки на сервере Сирены. Повторите поиск позднее.
|-
! align="center" width="50%"|Ошибка от поставщика.. Internal error
| Сбой в работоспособности на стороне ГРС (Sirena).
|-|}

Не зависящие от поставищиков:
{| class="wikitable"
|-
! align="center" width="50%"|«SIMULTANEOUS CHANGES TO PNR - USE IR TO IGNORE AND RETRIEVE PNR»
|В работе с бронированием идёт параллельное изменение PNR. В этом случае нужно начинать операцию заново.
|-
! align="center" width="50%"|«Invalid search reguest object»
|Данная ошибка возникает, когда обращаются к некорректному результату поиска. Возможные причины:
# некорректная ссылка поиска;
# результат поиска может устареть.
|-
|}

''' Ошибки при бронировании '''
{| class="wikitable"
|-
! align="center" width="50%"|«CANNOT PUT TO WAITLIST и CANNOT GET SPACE»
|Ошибка означает отсутствие мест в выбранном подклассе.
|-
! align="center" width="50%"|«РЕЙД ПРОЧИТАТЬ НЕВОЗМОЖНО»
|По рейсам данной а/к справка о наличии мест и бронирование проводится в интерактивном режиме. Информация о рейде в ГДС при этом отсутствует.
|-
! align="center" width="50%"|«No contacts specified»
|Не указан контакт клиента.
|-
! align="center" width="50%"|«ЛИСТ ОЖИДАНИЯ НА РЕЙСЕ ЗАПРЕЩЕН»
|Ошибка означает что запрашиваемый рейс был снят во время бронирования, такие рейсы из результатов поиска отсеять невозможно, поскольку во время запроса места отображаются в наличии.
|-
! align="center" width="50%"|«Cannot book and price PNR»
|По умолчанию установлен бумажный бланк, а данная авиакомпания разрешает продажу только на электронных бланках в сеансе ТКП. Установить по умолчанию электронный бланк.
|-
! align="center" width="50%"|«SEGMENT 2 DOESN'T CONNECT WITH PREVIOUS BY TIME»
|Некорректное стыковочное время. Данная ошибка возникнет при бронировании в случае, если заданное в ГДС авиакомпанией стыковочное время будет меньше допустимого минимального стыковочного времени, разрешенного в конкретном аэропорте. Например, в Домодедово на внутренние рейсы минимальное стыковочное время равно 90 минутам, на международные рейсы — 100 минутам.
|-
! align="center" width="50%"|«WRONG DOCUMENT NUMBER»
|Номер документа не соответствует указанному типу документа. Ошибка возникает, если указывать тип документа Р (что воспринимается ГДС как загранпаспорт) и номер документа из 10 цифр.
|-
! align="center" width="50%"|«NP DOCUMENT CANNOT BE ISSUED IN RU»
|Указанная страна выдачи документа недопустима для выбранного типа документа. Ошибка обычно возникает, если при бронировании указывать тип документа А (Национальный паспорт) при выбранном российском гражданстве.
|-
! align="center" width="50%"|«Invalid format of element 'doc'»
|Возникает при попытке ввести номер свидетельства о рождении в неправильном формате. Корректный формат такой: 1 или 2 латинские буквы, 2 буквы кириллицей, 6 цифр без пробелов и других знаков. Пример: IОЛ123456.
|-
! align="center" width="50%"|Ошибка от поставщика.. Please retry in 15 seconds
| Возникает из-за перегрузки на сервере Сирены. Повторите поиск позднее.
|-
! align="center" width="50%"| Невозможно забронировать один из сегментов перелёта. Попробуйте другой перелёт. Cannot reserve seats on flight HY-603
|Авиакомпания ответила отказом на наличие мест. Ошибка, как правило, возникает в том случае, если произошла рассинхронизация данных о наличии мест на данный класс и рейс между ресурсом ГДС и хостом самой авиакомпании. Уменьшить число таких ошибок поможет включение опции RBFL (Перебронирование по наименьшей цене) в настройках реквизитов бронирования. Если ошибки все равно продолжают поступать, необходимо обратиться в техподдержку Сирены с просьбой провести ручную синхронизацию данных, указав конкретные номера рейсов, АК, направление, класс и время вылета.
|-
! align="center" width="50%"|Ошибка от поставщика. Продажа запрещена
| Возникает из-за рассинхронизации с инвенторным центром а/к или отсутствия мест подкласса.
|-
|}

''' Ошибки при выписке '''
{| class="wikitable"
|-
! align="center" width="50%"|«ЦЭБ ТКП: ETC TCH - TICKET STOCK IS NOT SPECIFIED FOR POINT OF SALE»
|Для данной точки продажи не назначен сток электронных билетов ТКП (для решения вопроса о назначении стока следует обращаться в ТКП).
|-
! align="center" width="50%"|«ERROR: ONE OF SEGMENTS HAS XX_STAT»
|Один из сегментов имеет статус аннулированного (XX) — сегмент мог быть аннулирован авиакомпанией.
|-
! align="center" width="50%"|«PNR and surname do not match»
|Несовпадение фамилии в PNR с фамилией в заказе.
|-
! align="center" width="50%"|«ONE OF SEGMENTS HAS XX_STAT»
|Места были сняты ранее таймлимита. Видимо, это было сделано по телеграмме авиакомпании. Заказ попал в 10-ю очередь, которую кассир агентства должен просматривать.
|-
! align="center" width="50%"|«Too rapid-expired fare. Repeat at 5 minutes»
|Для избежания данной ошибки в настройках {{Menu|Реквизиты подключения к GDS}} значение поля {{Setting|Время снятия брони}} должно соответствовать настройкам на стороне Sirena Travel.
|-
! align="center" width="50%"|«ETC TCH: ETC TCH - THE STOCK OF TICKETS IS EXHAUSTED FOR POINT OF SALE 92152314
ETC TCH: -02ULE TO THE HEAD OF AGENCY»
|Ошибка возникает при выписке билетов на стоке ТКП и означает, что сток выписки на данный момент закончился. Ошибка исчезнет после пополнения стока. Для этого агент должен обратиться в ТКП напрямую.
|}

''' Ошибки при войдировании '''
{| class="wikitable"
|-
! align="center" width="50%"|«PNR занято другим пользователем (пульт МОВЦ35 1). Повторите запрос позже»
|На момент появления запроса заказ был занят технологом за пультом МОВЦ35, обрабатывающим телеграммы с ЭБ.
|-
! align="center" width="50%"|«4 Неверный симметричный ключ»
|Ошибка о неверном ключе возникает редко. Это связано с ежечасной заменой симметричного ключа и процедурой обмена им. Возможно, обмен произошел в момент выполнения другого запроса и второй оказался зашифрован старым ключом.
|-
! align="center" width="50%"|«Операция вам не разрешена»
|Выписка билета была произведена через пульт Sirena Travel. В таком случае войдировать билет средствами движка невозможно.
|-
|}
</div>
</div>

== Особенности работы с Sirena в {{NameSystem}} ==
В {{NameSystem}} [[Форма бронирования (Авиабилеты)|форма бронирования]] предотвращает ошибки бронирования, связанные с нарушением ограничений Sirena на количество символов, отведенное для ФИО пассажира:
* Максимальное количество символов для фамилии и имени в сумме – 54.
* Максимальное количество символов для фамилии, имени и отчества в сумме – 53.

== Авиа+ ==
«Авиа+» - функциональность ГРС Сирена Трэвел, предоставляющая возможность доступа к расширенному авиаконтенту, включающему в себя варианты тарификации авиаперевозок, полученных из ГРС Сирена Трэвел и GDS Travelport в рамках одной учетной записи клиента в ГРС Сирена Трэвел (client_id) без использования дополнительных запросов.

Функциональность подключается администратором системы {{NameSystem}}. Для ее включения необходимо оставить заявку в проектном трекере [http://helpdesk.nemo.travel helpdesk.nemo.travel]

{{Attention|Для подключения новой функциональности необходимо подписание дополнительного соглашения между агентом и ПАО «ТКП».}}

<div class="toccolours mw-collapsible mw-collapsed" style="width:800px; margin-bottom:12px;">
'''Поддерживаемый Авиа+ функционал'''
<div class="mw-collapsible-content">
*Поиск
*Получение УПТ для перелёта и брони
*Актуализация перелёта
*Работа с брендированными семействами
*Бронирование перелёта
*Обновление брони
*Отмена брони
*Выписка брони
*Войдирование
*Импорт брони
*Получение истории ПНРа
*Довнесение данных в бронь (через SSR)
*Модификация данных в брони (через SSR)
*Добавление брони в очередь
*Чтение очередей
*Удаление брони из очереди
</div>
</div>

<div class="toccolours mw-collapsible mw-collapsed" style="width:800px; margin-bottom:12px;">
'''Неподдерживаемый Авиа+ функционал'''
<div class="mw-collapsible-content">
*Подбор доступной для брони цены при недоступности полученной при поиске
*Создание брони перелёта без паспортных и контактных данных пассажира с их последующим довнесением
*Модификация паспортных и контактных данных пассажира в брони
*Поиск по окружным датам
*Работа с небрендированными семействами
*Снятие мест для выписанной брони (подготовка к возврату)
*Сплит (разделение) ПНРа
*Допуслуги а/к
*Автовозвраты
*Автообмены
</div>
</div>

== См. также ==
* [[Эндорсмент#Требования к эндорсментам в Сирене|Требования к эндорсментам в Сирене]]
* [[Синхронизация заказов]]
* [[Агентство]]
* [[ТКП (Транспортная Клиринговая Палата)]]
* [[Офис]]
* [[Сессия]]
* [[Сбор (термин)]]
* [[Платежный шлюз]]
* [[БСП]]
* [[Таймлимит]]
* [[Эндорсмент]]
* [[Билет#Функциональные возможности поставщиков авиабилетов|Функциональные возможности поставщиков авиабилетов]]

== Полезные ссылки ==
* [http://www.sirena-travel.ru Официальный сайт «Сирена Трэвел»]
* [http://www.tch.ru Сайт ТКП]

Маршрутизатор Авиа сервера

2018-11-14T14:31:19Z

Мария Горшенева: Перенаправление на Маршрутизатор поисковых запросов Nemo Connect

#REDIRECT [[Маршрутизатор поисковых запросов Nemo Connect]]

Маршрутизатор поисковых запросов Nemo Connect

2018-11-09T09:17:27Z

Мария Горшенева: /* Параметры маршрутизации поисковых запросов в {{NameProject2}} */

==Назначение==
Маршрутизатор поисковых запросов используют для автоматизации выбора пакетов реквизитов для [[Поиск (Авиабилеты)|поиска]] на основе параметров поискового запроса.<br>
Агентство может настроить выгодную схему поиска для:
* поиска в разных [[ГРС]] в нескольких зонах,
* выдачи более разнообразных тарифов при минимальных издержках на поисковые транзакции.

Можно привязать пакеты реквизитов к определенной географии, например, чтобы '''ГРС Sirena Travel''' осуществляла поиск только внутренних российских рейсов.

== Принцип работы ==

[[Маршрутизатор поисковых запросов|Маршрутизация]] поисковых запросов в {{NameProject2}} настраивается в пункте [[Маршрутизатор поисковых запросов {{NameProject2}}#Включение маршрутизатора поисковых запросов {{NameProject2}}|Включение маршрутизатора поисковых запросов {{NameProject2}}]]
.

===Блокировка и приоритетность правил===
Использование маршрутизатора в классическом исполнении предполагает, что, если под запрос подходит несколько правил, все правила сработают, и запрос направится во все сработавшие пакеты. <br />В маршрутизаторе {{NameProject2}} можно задать правила таким образом, чтобы '''при пересечении правил сработало только одно'''. Для этого правилам присваивают статус '''блокирующего'''.
*Если среди подходящих для запроса правил '''есть хотя бы одно блокирующее''', маршрутизатор '''выберет из подходящих одно правило''' по приоритету.
*Если среди подходящих для запроса правил '''нет блокирующих''', то '''все правила будут применены'''.

Приоритет правила определяется номером (ID) правила, либо присваивается вручную с помощью параметра ''Приоритет правила''. Чем выше число, тем выше приоритет. (см. раздел [[Маршрутизатор поисковых запросов Немо Тревел 2.0#Параметры маршрутизации поисковых запросов в {{NameProject2}}|Параметры маршрутизации поисковых запросов в {{NameProject2}}]]).
*Если среди подходящих для запроса правил '''есть блокирующее''', и '''для каждого''' сработавшего правила '''задан ручной приоритет''', то правило для срабатывания '''выбирается по ручному приоритету'''.
*Если среди подходящих для запроса правил '''есть блокирующее''', и для '''хотя бы одного''' сработавшего правила''' ручной приоритет не задан''', то правило для срабатывания '''выбирается по номерам правил'''.

== Особенности отправки запросов при работе маршрутизатора {{NameProject2}} ==

{{Attention|После включения маршрутизатора {{NameProject2}} не используйте географические ограничения в пакетах {{NameProject1}}.}}

При включенном маршрутизаторе {{NameProject2}} запросы по пакетам распределяются в маршрутизаторе {{NameProject2}} за пределами {{NameProject1}}, поэтому ограничение использования пакетов '''в тонкой настройке''' {{NameProject1}} больше не срабатывает. Поисковый запрос проходит через реквизиты подключения выбранного в тонкой настройке пакета в маршрутизатор {{NameProject2}}, который распределяет запрос в пакеты по своим правилам.

{{Attention|Чтобы реализовывалось подключение {{NameProject1}} к {{NameProject2}}, в тонкой настройке должен быть включен хотя бы 1 пакет.}} Это необходимое условие, поскольку в реквизитах {{NameProject1}} заданы реквизиты подключения к {{NameProject2}}.

== Включение маршрутизатора поисковых запросов {{NameProject2}} ==
Чтобы включить маршрутизатор поисковых запросов для агентства нужно:
<br>
В '''{{NameProject1}}''':

'''Менеджеру''':
# Зайдите в раздел '''Управление продажами → Авиабилеты → Процессы → Процесс поиска → Тонкая настройка'''.
# '''Включите''' опцию '''Использовать маршрутизатор {{NameProject2}}'''.
# В настройке '''Реквизиты из какого пакета будут использованы для запроса поиска к {{NameProject2}}''' выберите пакет реквизитов.

'''Администратору''' (указать на какие именно настройки будет смотреть система при поиске):
# Зайти в раздел '''Для техподдержки → {{NameProject2}} Вебсервисы → Настройки Взаимодействия'''.
# Включить опцию '''Настройки маршрутизатора''' в разделе '''Использовать настройки в Авиа сервере из Немо 1 для разделов'''.
В '''{{NameProject2}}''':
# Зайдите в раздел Настройки Авиа → Поисковые настройки → Настройки маршрутизатора.
# Включите опцию '''Использовать маршрутизатор авиа'''.

При этом запрещено заводить правила маршрутизации в {{NameProject1}}. Маршрутизатор поисковых запросов {{NameProject1}} рекомендуется отключить.

== Создание правила маршрутизации поисковых запросов на стороне {{NameProject2}} ==

Чтобы создать правило маршрутизации:

# Зайдите в раздел '''Настройки Авиа → Поисковые настройки → Настройки маршрутизатора'''.
# Нажмите кнопку '''Добавить Правило маршрутизатора'''.
# Включите правило.
# Задайте параметры правила (см. [[Маршрутизатор поисковых запросов#Параметры маршрутизации поисковых запросов в {{NameProject2}}|Параметры маршрутизации поисковых запросов в {{NameProject2}}]]):
#* Укажите условия применения правила — параметры поискового запроса, при которых поиск будет проходить по данному правилу.
#* Укажите один или несколько [[Пакеты реквизитов {{NameProject2}}|пакетов реквизитов {{NameProject2}}]], в которых будет проходить поиск при применении правила.
#* Задайте дополнительные параметры, которые будут применены к запросу поиска при применении пакета.
# Нажмите кнопку '''Сохранить'''.

{{Attention| Вы можете создавать правила маршрутизации не только на стороне {{NameProject2}}, но и на стороне {{NameProject1}} }} (см. [[Маршрутизатор поисковых запросов Немо Тревел 2.0#Добавление правила маршрутизации поисковых запросов для {{NameProject2}} на стороне {{NameProject1}}|Добавление правила маршрутизации поисковых запросов для {{NameProject2}} на стороне {{NameProject1}}]]).

==Параметры маршрутизации поисковых запросов в {{NameProject2}}==

* '''Название правила''' — название для удобства работы с правилами.
* '''Правило включено''' — включает правило в работу.
* '''ИД пакетов, в которых будет поиск''' — номера пакетов реквизитов ''из Немо2.0'' (см. соответствия в разделе "Тонкая настройка", первый столбец), по которым будет вестись поиск при срабатывании правила.

'''''Условия применения правила'''''
* '''Список стран отправления''' — страны отправления, при которых будет срабатывать данный пакет реквизитов. Список стран задается в формате '''ISO alpha 2''', например '''RU'''
* '''Список стран прибытия''' — страны прибытия, при которых будет срабатывать данный пакет реквизитов. Список стран задается в формате '''ISO alpha 2''', например '''RU'''
* '''Список городов отправления''' — IATA-коды городов отправления, при которых будет срабатывать данный пакет реквизитов
* '''Список городов прибытия''' — IATA-коды городов прибытия, при которых будет срабатывать данный пакет реквизитов
* '''Список аэропортов прибытия''' — IATA-коды аэропортов прибытия, при которых будет срабатывать данный пакет реквизитов
* '''Список аэропортов отбытия''' — IATA-коды аэропортов отбытия, при которых будет срабатывать данный пакет реквизитов
* '''Запретить сложные маршруты (более 2-х сегментов в запросе)''' — для поиска сложных маршрутов правило будет срабатывать, только если в маршруте не более двух сегментов.
* '''Все сегменты перелёта должны удовлетворять требованиям к маршруту''' — правило срабатывает, если каждый сегмент перелета удовлетворяет параметрам правила. При выключенной опции условиям правила фильтрации должен удовлетворять хотя бы один сегмент.
* '''Только RT-перелеты''' — правило применяется только к перелетам '''туда-обратно'''.
* '''Обратная логика правила''' — включает инверсию географических ограничений правила (логику типа ''все, кроме''). <br /> Например, если при включенной опции в параметре '''Список стран отправления''' указана страна ''RU'', под правило будут попадать все рейсы, кроме рейсов с вылетом из России.
* '''Инвертировать страны отбытия/прибытия''' — включает инверсию только по странам прибытия/отбытия ( логику типа ''все, кроме''). <br/> Например, если при включенной опции в параметре '''Список стран отправления''' указана страна ''AU'', под правило будут попадать все рейсы, кроме рейсов с вылетом из Австралии.
* '''Инвертировать города отбытия/прибытия''' — включает инверсию только по городам прибытия/отбытия ( логику типа ''все, кроме'').<br/> Например, если при включенной опции в параметре '''Список городов отправления''' указан город ''VOZ'', под правило будут попадать все рейсы, кроме рейсов с вылетом из Воронежа.
* '''Инвертировать аэропорты отбытия/прибытия''' — включает инверсию только по аэропортам прибытия/отбытия ( логику типа ''все, кроме'').<br/> Например, если при включенной опции в параметре '''Список аэропортов прибытия''' указан аэропорт ''BWI'', под правило будут попадать все рейсы, кроме рейсов с вылетом из Балтимор-Вашингтона , при этом рейсы из самого Вашингтона будут попадать под правило.

* '''Тэги, обязательные для срабатывания данного правила''' — обязательные тэги в поисковом запросе для срабатывания правила (см. [[Маршрутизатор поисковых запросов Немо Тревел 2.0#Теги в {{NameProject2}}|Теги в {{NameProject2}}]]).
* '''Тэги, для которых запрещено срабатывания правила''' — если в запросе есть тэги из этого списка, правило не будет применено.
* '''Признак уникальности правила''' - присваивает правилу статус блокирующего. При включенной опции, если среди подходящих для запроса правил есть хотя бы одно блокирующее, маршрутизатор выберет одно правило по приоритету. Если среди подходящих правил нет блокирующих, все правила будут применены (см. раздел [[Маршрутизатор поисковых запросов Немо Тревел 2.0#Блокировка и приоритетность правил|Блокировка и приоритетность правил]]).
* '''Приоритет правила''' — работает только для правил с включенной опцией '''Блокирующее правило'''. Присваивает приоритет правилу - чем выше число, тем выше приоритет. При блокировке правил срабатывает одно, имеющее наибольший приоритет (см. раздел [[Маршрутизатор поисковых запросов {{NameProject2}}#Блокировка и приоритетность правил|Блокировка и приоритетность правил]]).
* '''Максимальное количество дней до даты вылета на всех плечах''' - при включенной настройке правило не срабатывает в случае превышения заданной величины.
* '''Список допустимых дней для запуска поиска''' — порядковый номер дня недели (начиная с 1), в которые разрешено запускать поиск.
*'''Стратегия обработки правил с совпадающими пакетами''' — определяет способ действия при срабатывании двух и более правил с одинаковыми пакетами для поиска при наличии в каком-либо из этих правил приоритетной / нежелательной авиакомпании (параметры "А/к для передачи как обязательные в ГДС" и "А/к, которые требуется исключить из выдачи"). Параметр может принимать два значения. Constrict - сужение поисковой выдачи, является значением по умолчанию и соответствует логике обработки правил ДО добавления данного параметра. При этом режиме в случае наличии пары "Общее правило без фильтра по а/к" + "Частное правило с фильтром" сработает именно частное правило, общее будет проигнорировано в пользу частного. Если у хотя бы одного из сработавших правил выставлено значение Constrict, то стратегия обработки всех правил будет именно сужение. Expand - расширение поисковой выдачи. При этом режиме в случае наличия такой пары срабатывают оба правила, и в ГРС отправляются параллельные запросы с фильтром по а/к и без него. При наличии правил с одним и тем же пакетом реквизитов для каждого пакета происходит слияние параметров правил. Если есть несколько подходящих правил с фильтром по а/к, то выполняется слияние всех фильтров. Обязательные для передачи в ГДС а/к объединяются. Если есть списки исключаемых а/к, то их значения удаляются из списка обязательных а/к. Если обязательных а/к нет, то будет заполняться только список исключаемых а/к.
*'''Срабатывать в том числе для сегментов обратно''' — при включении опции заданные в правиле пункты вылета/прилёта будут разрешаться для маршрута с пунктами вылета/прилёта наоборот - города проверяются как для запросов OW туда, так и OW - запросов по обратному направлению от заданного, в том числе RT. Кнопка будет разрешать в рамках правила по списку городов отправления-прибытия так же и перелеты с направлением в обратную сторону (проверяются пункты прилета как пункты вылета, а пункты вылета как пункты прилёта).

{{Attention| Включение инверсии города отбытия и инверсии города прибытия в рамках одного правила - НЕ инвертируют направление перелёта, чтобы инвертировать направление Вам понадобиться включить обратную логику правила.}}

''''' Добавление дополнительных параметров к запросу в ГРС'''''
* '''А/к для передачи как обязательные в ГДС''' — авиакомпании, перечисленные в списке, передаются как обязательные в запрос к ГРС.
* '''А/к, которые требуется исключить из выдачи''' — авиакомпании, перечисленные в списке, при запросе в ГРС помечаются нежелательными для поисковой выдачи.
* '''Включает замену эконом/премэконом класса в запросе на All''' — включает поиск по всем [[Класс обслуживания|классам]], если в запросе указан эконом или премиум эконом класс.
* '''Добавлять премиум версию запрошенного класса''' — включает дополнительный запрос премиум версии класса, указанного при поиске.
* '''Переопределение предпочитаемого класса перелёта''' — класс перелета, заданный пользователем в параметрах поиска, при запросе к ГРС будет заменен на предпочитаемый.
* '''Максимальное количество перелетов в ответе ГДС''' — количество перелетов от каждой ГРС в результатах поиска:
**для ГРС Sabre можно использовать только фиксированные значения: 50/100/200,
**для ГРС Galileo параметр не работает,
**для ГРС Amadeus, Сирена Трэвел, uAPI можно задать любое целое положительное число.
* '''Поиск минимальных и минимально возвратных цен''' - добавляет параметр, запрашивающий наряду с минимальными тарифами возвратные тарифы с минимальной стоимостью. Если [[Поиск_минимально_возвратных_тарифов|опция включена]], в результатах поиска отображается больше возвратных тарифов.
* '''Дополнительно запросить только публичные тарифы''' - настройка актуальна только для ГРС Sabre. Позволяет дополнительно получать и отображать клиенту в поисковой выдаче не только базовые тарифы АК, которые, как правило являются приватными, но и более дорогие публичные тарифы. Пример применения настройки - поиск семейств тарифов BASIC и FLEX у АК S7 в случае, если для РСС агента уже открыт доступ к ним, т.к. по умолчанию ГРС будет возвращать при поиске только самые дешевые тарифы BASIC по каждому перелету.
* '''Запретить запрос только прямых перелётов''' - позволяет запретить поиск рейсов без пересадок на конкретных направлениях. Если настройка включена и пользователем запрошен прямой перелёт, а также хотя бы один из запрошенных сегментов подходит под правило, то правило считается не сработавшим и поиск не запускается.
*'''Максимальное количество пересадок''' — позволяет ограничить максимальное количество пересадок в результатах поиска. Ограничение применяется на каждое запрошенное плечо. Доступно ограничение количества пересадок от 0 (прямые перелеты) до 3 (перелеты с указанным или меньшим количеством пересадок). Функционал реализован для ГРС Amadeus, Sabre, Galileo и Galileo uAPI.

== Теги в {{NameProject2}} ==
'''Тег''' — это метка, которая служит для определения категории или группы, к которой относится элемент.

Тэги в {{NameSystem}} используются только для маршрутизатора {{NameProject2}}.

После включения маршрутизатора {{NameProject2}}, к запросу от {{NameProject1}} к {{NameProject2}} автоматически добавляются теги, соответствующие параметрам запроса.

Теги вместе с запросом поступают в маршрутизатор. Они указывают данные по запросу, такие как: тип пользователя, который делает поисковый запрос (менеджер — '''mgr''', агент — '''agt''' или анонимный пользователь — '''anon'''), тип поиска (агентский API — '''api''' , метапоиск — '''meta''').
Возможные теги:
*''b2b'' — запрос поиска от учетной записи B2B,
*''b2c'' — запрос поиска от учетной записи B2C,
*''usr'' — запрос поиска от имени зарегистрированного пользователя,
*''exp'' — запрос поиска от имени эксперта,
*''mgr'' — запрос поиска от имени менеджера,
*''agt'' — поиск запущен пользователем корневого агентства,
*''corp'' — поиск запущен корпоративным клиентом агентства,
*''subagt'' — поиск запущен пользователем субагентства,
*''anon'' — запрос поиска от имени анонимного пользователя,
*''api'' — поиск запущен через агентский API,
*''meta'' — поиск запущен через метапоиск,
а так же метки, содержащие:
*''номер пользователя'', запустившего поиск,
*''номер группы'', пользователь которой запустил поиск,
*''номер субагенства и агентства'' пользователя, запустившего поиск.

== Добавление правила маршрутизации поисковых запросов для {{NameProject2}} на стороне {{NameProject1}} ==

Чтобы создать правило маршрутизации:

# Зайдите в раздел '''Управление продажами → Авиабилеты → Процессы → Процесс поиска → Настройки маршрутизатора'''.
# Выберите необходимого пользователя, группу или агентство '''Изменить'''.
# Нажмите '''Создать новую запись'''.
# Задайте параметры правила (см. [[Маршрутизатор_поисковых_запросов_{{NameProject2}}#Параметры маршрутизации поисковых запросов в {{NameProject2}}|Параметры маршрутизации поисковых запросов в {{NameProject2}}]]):
#* Укажите условия применения правила — параметры поискового запроса, при которых поиск будет проходить по данному правилу.
#* Укажите, если требуется инвертировать тот или иной параметр поискового запроса (страну/город/аэропорт прибытия или отбытия).
#* Укажите один или несколько [[Пакеты реквизитов {{NameProject2}}|пакетов реквизитов {{NameProject2}}]], в которых будет проходить поиск при применении правила.
#* Задайте дополнительные параметры, которые будут применены к запросу поиска при применении пакета.
#* Выберите тип правила, Constrict (сужение) или Expand (расширение), оно будет определять, для чего будет использовать фильтр по а/к - сужение или расширение выдачи.
# Нажмите кнопку '''Сохранить'''.
{{Attention| Если правила установлены на конкретного пользователя/группу, то будут использоваться правила только пользователя/группы.<br> И если есть другие правила выше по иерархии вложенности, например на агентстве, то эти правила будут проигнорированы.<br> В случае, если у пользователя/группы нет своего правила, тогда будут использоваться первые правила по иерархии выше. }}<br>
{| class="wikitable" align="center" style="margin-left:1em"
|-
|[[Файл:2018-05-29_15-01-31.png|справа|1200px|Создание нового правила]]
|-
|Создание нового правила
|}
=== Импорт правил маршрутизации поисковых запросов в {{NameProject1}} ===
Помимо создания правил, вы можете импортировать правила из Админ-панели {{NameProject2}}. Система полностью перенесет все настройки из связанного агентства {{NameProject2}} в выбранного пользователя или группу Nemo Travel.<br>
{{Attention| При импорте настроек, ваши текущие правила маршрутизатора удаляются. }}<br>
Связанное агентство задается под администратором в разделе '''Для техподдержки → {{NameProject2}} Вебсервисы → Настройки взаимодействия'''. Там нужно заполнить следующие поля:
* Идентификатор пользователя в {{NameProject2}}.
* Логин пользователя в {{NameProject2}}.
* Пароль пользователя в {{NameProject2}}.
* Используемая среда .net серверов

== Особенности отображения на стороне {{NameProject1}} таблицы с настройками маршрутизатора==
{| class="wikitable" align="center" style="margin-left:1em"
|-
|[[Файл:Альтернативный маршрутизатор.jpg|справа|1200px|Внешний вид таблицы с правилами]]
|-
|Внешний вид таблицы с правилами
|}

* Строка таблицы соответствует одному правилу маршрутизатора.
* Столбцы соответствуют параметрам настроек маршрутизатора. Подробнее см.[[Маршрутизатор_поисковых_запросов_{{NameProject2}}#Параметры маршрутизации поисковых запросов в {{NameProject2}}|Параметры маршрутизации поисковых запросов в {{NameProject2}}]]
* Столбец '''"Пересекается с"''' показывает идентификаторы правил, которые либо полностью соответствуют правилу (строку которого мы рассматриваем), либо наше правило является частным случаем правил, указанных в столбце. Столбец "Пересекается с" помогает видеть пересечения правил и даёт возможность лучше ориентироваться в общей массе правил маршрутизатора.

'''Пример'''

{| class="wikitable" border="2"
|-
|'''ID Правила'''||'''Пересекается с'''||'''Параметры поиска'''
|-
| 001 || || Перелеты из Франции
|-
| 002 || 001 || Перелеты из Парижа
|}

== Примеры правил маршрутизации в {{NameProject2}} ==



===Правило для включения в результаты поиска подкласса P===

Для Азербайджанских авиалиний (J2) подкласс P - бюджетный подкласс экономического класса обслуживания, в то время как для большинства авиакомпаний P - первый класс. Поскольку {{NameSystem}} распознает этот подкласс как первый, его по умолчанию нет на выдаче перелетов экономического класса обслуживания.

Чтобы получать на выдаче перелеты по этому подклассу, нужно, чтобы система запросила как бизнес, так и эконом класс, а затем отфильтровала результаты. В маршрутизаторе {{NameProject2}} предусмотрены необходимые параметры корректировки запроса в ГРС для получения желаемой выдачи.

# Зайдите в раздел '''Настройки Авиа → Поисковые настройки → Настройки маршрутизатора'''.
# Нажмите кнопку '''Добавить Правило маршрутизатора'''.
# Установите флажок '''Правило включено''' для активации правила.
# Введите номера (id) пакетов реквизитов в {{NameProject2}}, на которые будет распространяться правило в поле '''ИД пакетов, в которых будет поиск'''.
# Установите флажок '''Включает замену эконом/премэконом класса в запросе на All'''.
# Для удобства работы введите '''Название правила'''.
# Нажмите на кнопку '''Сохранить'''.

Правило заменяет в запросе к ГРС ''Эконом'' и ''Премэконом'' класс на ''Все'' для указанных пакетов. Таким образом при запросе тарифов экономического класса, ГРС отправит перелеты всех классов. Нежелательные на выдаче результаты можно отфильтровать с помощью [[Фильтры результатов поиска (Авиабилеты)|фильтров результатов поиска]].

== См. также==
*[[Маршрутизатор поисковых запросов]]
*[[Маршрутизатор поисковых запросов Немо Тревел 1.0]]
*[[Поиск (Авиабилеты)]]
*[[Глобальная распределительная система]]
*[[Пакеты реквизитов Немо 1.0]]
*[[Фильтры поисковых запросов (Авиабилеты)]]
*[[Фильтры результатов поиска (Авиабилеты)]]
*[[Микшер результатов поиска (Авиабилеты)]]
*[[Валюта]]

Форма бронирования (Авиабилеты)

2018-10-23T11:13:34Z

Мария Горшенева: /* Параметры настройки блока информации о пассажирах */

'''Форма бронирования''' 一 страница системы {{NameSystemLink}} для внесения данных, необходимых для бронирования выбранного перелета.

Новый модуль '''Форма бронирования''' сделал процесс бронирования еще удобнее, быстрее и интеллектуальнее.

==Принцип работы==
* Все вводимые данные автоматически транслитерируются для всех ГРС, кроме внутренних перелетов ''ГРС Sirena''.
* В поле с ограничением на тип вводимых данных отображается подсказка, которая динамически меняется при смене типа документа.

Форма бронирования разделена на блоки:
* '''Блок информации о заказе'''.
* '''Блок информации о перелете'''.
* '''Блок ввода пассажирских данных'''.
* '''Блок информации о покупателе'''.
* '''Блок выбора способа оплаты'''.
* '''Блок сплита''' (Включается дополнительно, см [[Разделение PNR]]).

{| class="wikitable"
|-
|[[Файл:Форма бронирования.png|800px|Форма бронирования]]
|-
|Форма бронирования
|}

Форма бронирования (внешний вид, добавление полей и опций, обязательные и необязательные поля) настраивается в разделе '''Управление продажами → Процессы → Форма бронирования'''.

===Блок информации о заказе===
Блок информации о заказе содержит:
* ''код доступа'' к забронированному заказу,
* ''номер заказа'' у поставщика,
* ссылку на ''таблицу детализации стоимости'',
* ''таймлимит'' на оплату заказа,
* ссылку на ''служебную информацию'' для менеджера,
* ссылку ''У меня есть промокод'' для ввода промокода [[Программа лояльности|программы лояльности]].

'''Таблица детализации стоимости''' открывается при щелчке по стоимости заказа в левом верхнем углу блока. Таблица содержит информацию о полной стоимости заказа код тарифа и ссылку на [[УПТ]], размер такс, сбора агентства, комиссии субагенту, комиссии авиакомпании, комиссии за прием платежа.
* число пассажиров в заказе каждого типа,
* код тарифа для каждого типа пассажира,
* размер тарифа для каждого типа пассажира,
* размер таксы для каждого типа пассажира,
* величина сбора агентства,
* размер комиссии от авиакомпании,
* размер комиссии субагенту,
* величина дохода агентства,
* стоимость заказа,
* размер комиссии за приём платежа,
* итоговая стоимость к оплате.

{{Attention|Комиссия за прием платежа вычисляется на основании выбранного способа оплаты и отображается на форме бронирования. Все доступные пользователю способы оплаты отображаются на странице заказа в соответствующем блоке (пример см. ниже). При выборе другого способа оплаты значение комиссии за прием платежа (и соответственно общей стоимости) меняется динамически.}}

* При щелчке на код тарифа открываются '''[[УПТ|условия применения тарифа]]''' во всплывающем окне.
* При щелчке на сумму таксы открывается '''детализация такс''' во всплывающем окне.
* При щелчке на сумму сбора агентства и комиссии авиакомпании открывается '''[[Ценообразование (Авиабилеты)#Тестирование и отладка срабатывания правил|таблица отладки ценообразования]]'''.
{| class="wikitable"
|-
|[[Файл:Fb2 price.png|560px]]
|-
|Детализация стоимости
|}

Для менеджера агентства на блоке информации о заказе доступна кнопка '''Служебная информация''', которая открывает окно с информацией:
* номер заказа,
* поставщик (ГРС),
* локатор,
* дата начала услуги,
* дата создания заявки,
* список ошибок, возникших в процессе оформления заказа,
* ревизии,
* ремарки от ГРС,
* доступные действия с заказом:
** обновление,
** аннуляция,
** выписка,
** войдирование,
** возврат оплаты,
** просмотр платежных транзакций,
** импортировать новый PNR.

[[Файл:Служебная информация.png|300px|Служебная информация]]

===Блок информации о перелете===
Блок информации о перелете содержит:
* краткие сведения о выбранном маршруте,
* кнопка ''Детали перелета''.

Во всплывающем окне ''Детали перелета'' отображается:
*название и логотип маркетинговой авиакомпании,
*время вылета и прилета,
*номер рейса,
*название оперирующего перевозчика,
*тип воздушного судна или перевозки,
*тип питания,
*класс обслуживания,
*время в пути,
*информация о багаже.

[[Файл:Детали перелета.png|600px]]

====Параметры настройки блока информации о перелете====
* {{Setting|Авиабилеты: ссылки на путеводитель}} — включает описание в деталях перелёта:
** '''''Воздушное судно'''''
** '''''Аэропорт'''''
** '''''Авиакомпания'''''
* {{Setting|Способ отображения информации об авиаперелете}} — выбор способа отображения данных о перелете на странице бронирования:
** '''''Во всплывающем окне''''' 一 подробные данные о перелете доступны во всплывающем окне по ссылке ''Детали'' на странице бронирования в блоке краткой информации о перелете,
** '''''На странице''''' 一 данные о перелете отображаются в развернутом виде на странице бронирования.
* {{Setting|Отображать информацию о багаже, даже если в заказе присутствует информация о семействе}} — позволяет включить отображение информации о норме провоза багажа в блоке с детальной информацией о перелете. Настройка актуальна для случаев, когда для перелета доступны различные варианты семейств тарифов, поскольку при этом по умолчанию информация о норме провоза багаже не отображается в блоке с детальной информацией о перелете. {{Attention|Настройка не влияет на способ отображения, если включены улучшенные элементы блока информации о заказе.}}
* {{Setting|Брать информацию о багаже из путеводителя}} — при включении позволяет задать список авиакомпаний, для которых данные о багаже в семействах тарифов будут подгружаться из путеводителя. Если авиакомпании не заданы, то настройка работает для всех авиакомпаний. {{Attention|По умолчанию информация о багаже в семействе тарифов берется из данных, полученных от ГРС.}} 

===Блок ввода пассажирских данных===
Блок ввода пассажирских данных содержит форму для ввода сведений о пассажирах, для которых бронируется перевозка, для создания бронирования (PNR) в ГРС в соответствии с технологией бронирования регулярных авиаперевозок. '''Вводимые пассажирские данные в заказе ''сохраняются'''''. Если при бронировании получена ошибка, всплывающее окно проинформирует и предложит вернуться к результатам поиска для выбора другого перелета, при бронировании которого введенные ранее данные будут восстановлены. Данные удаляются из [[сессия|сессии]] после успешного бронирования.

Если указаны некорректные визовые данные, при попытке бронирования на странице с информацией о заказе отображается сообщение ''Не удалось добавить данные при бронировании'' и бронирование не продолжается.

{{Attention|С технической точки зрения бронь можно создать с использованием любого типа документа, в ГДС на это нет ограничений. Но наличие брони в ГРС не гарантирует то, что у пассажира не будет проблем при регистрации на рейс. Наличие необходимых выездных документов и корректность введенных данных 一 ответственность самого пассажира.}}

====Параметры настройки блока информации о пассажирах====
* '''Допустимость довнесения для Авиабилетов''' — включенная опция разрешает внести данные после бронирования (отправить в ПНР после бронирования перелета):
** '''''Паспортные данные (DOCS)'''''
** '''''Данные о визе (DOCO)'''''
** '''''Адрес прибытия (DOCA)'''''
** '''''Карта лояльности'''''
** '''''Выбор места'''''
* '''Допустимость модификации для Авиабилетов''' — включенная опция разрешает изменить данные (изменить данные в ПНР).
** '''''Паспортные данные (DOCS)'''''
** '''''Данные о визе (DOCO)'''''
** '''''Адрес прибытия (DOCA)'''''
** '''''Выбор места'''''
* '''Авиабилеты: дополнительные поля''' — опция добавляет дополнительные поля в форму бронирования:
** '''''Необязательное отчество для всех пассажиров''''' 一 опция включает поле ''Отчество'' для всех пассажиров, поле является необязательным, если отчество отсутствует в паспорте.
** '''''Необязательное отчество для всех пассажиров для авиакомпаний из списка''''' — опция включает поле ''Отчество'' пассажира только для авиакомпаний, заданных в параметре ''Список АК, требующих отчество для полётов внутри РФ'' в разделе ''Управление продажами — Авиабилеты — Устаревшие настройки — Настройка''.
** '''''Необязательное отчество для пассажиров внутренних рейсов РФ''''' 一 опция включает поле ''Отчество'' для рейсов внутри РФ, поле является необязательным.
** '''''Необязательный телефон для всех пассажиров''''' 一 опция включает поле ''Телефон'' для каждого пассажира, поле является необязательным.
** '''''Необязательная электронная почта для всех пассажиров''''' 一 опция включает поле ''Электронная почта'' для каждого пассажира, поле является необязательным.
** '''''Обязательный телефон для первого пассажира''''' 一 опция включает поле ''Электронная почта'' для первого пассажира, поле является необязательным.
** '''''Обязательная электронная почта для первого пассажира''''' <br />{{Attention|Если данные о телефоне и электронной почте пассажира введены в «Профилях туристов» — данные будут автоматически выводится на странице бронирования.}}<br />
* '''Авиабилеты: чекбокс отказа от внесения паспортных данных''' — включает отображение на странице бронирования опции ''Внести паспортные данные'', для возможности бронирования перелета без паспортных данных с довнесением в течении установленного времени (см. ниже).
[[Файл:Опция_бронирования_без_паспорта.png|550px|Опция "Внести паспортные данные"]]

* '''Авиабилеты: отображать блок ввода номера карты лояльности''' — включает опцию ''Внести номер карты лояльности'' на форме бронирования для отображения блока ввода карты лояльности авиакомпании.
* '''Авиакомпании партнеры при выборе карты лояльности''' — включает опцию подгрузки авиакомпаний партнёров на форме бронирования для отображения в блоке ввода карты лояльности партнёрских авиакомпаний. Данная настройка доступна к включению только при наличии включенной предыдущей настройки.
[[Файл:Loyality card.jpg|400px|Блок ввода карты лояльности (с партнёрами)]]
* '''Добавить возможность указания информации о наличии ограничений жизнедеятельности пассажиров''' - опция включает поле для внесения данных о специальных услугах (кресла, носилки, сопровождение, провоз медицинского оборудования и т.п.), которые необходимы пассажирам для осуществления перелета. При бронировании заказа с указанием данной информации агенту отправляется нотификация о наличии пассажиров с физ. ограничениями, если указан "Адрес почты для уведомлений о проблемах заказа" в разделе "Настройки системы - Нотификации и документы - Настройка почты".
[[Файл:Спец_услуги.jpg|800px|Блок ввода специальных услуг]]
* '''Авиабилеты: предлагать внесение визы до бронирования''' — включает поля для внесения данных визы для стран, перечисленных в параметре ''Управление продажами — Авиабилеты — Устаревшие настройки — Настройка''

===Блок покупателя===
Блок покупателя содержит поля для ввода информации о заказчике:
* имя,
* электронной почты,
* телефона,
* флажок ''Создать аккаунт''.
[[Файл:Fb2_customer_block.png|800px|Блок покупателя (с опцией «Создать аккаунт» для анонимного пользователя)]]

====Параметры настройки блока покупателя====
* {{Setting|Авиабилеты: отображать блок покупателя перед блоком пассажиров}} — поднимает блок данных о заказчике над блоком данных о пассажирах.
* {{Setting|Авиабилеты: отключить блок покупателя}} — отключает блок данных о заказчике ''Покупатель''. <br />{{Attention|Если бронирование осуществляет анонимный пользователь, опция ''Создать аккаунт'' независимо от значения параметра ''Предлагать анониму создать аккаунт'' в разделе '''Аккаунт менеджмент → Процесс регистрации''' всегда располагается под блоком покупателя.}}

===Блок выбора способа оплаты===
Под блоком покупателя (или блока пассажирских данных, если блок покупателя отключен) располагается блок выбора способа оплаты с описанием. Способ оплаты можно изменить после бронирования. По умолчанию отображаются первые четыре доступных метода оплаты, остальные открываются по щелчку на кнопку '''Другие методы оплаты'''. В панели администрирования можно добавить изображения слева от заготовка способа оплаты:
# Зайдите в панели администрирования в раздел '''Управление сайтом → Nemo CMS → Менеджер файлов'''.
# Загрузите изображение.
# Зайдите в раздел '''Управление сайтом → Настройка внешнего вида'''.
# В поле '''Дополнительный код CSS''' добавьте для каждого способа оплаты следующие стили:
{{.new-flights-passInfo__pay__method__logo_XXX {
background-image: url('/path/to/image.svg');
}
, где /path/to/image.svg — путь к изображению, а XXX — это название платежного шлюза.

Список патежных шлюзов:
* Acquiro — система платежей Acquiro
* Belassist — система приема платежей Belassist
* Chronopay — оператор интернет-платежей с помощью банковских карт Chronopay
* Copayco — платежная система CoPAYCo
* Deposit — оплата через депозит
* EasyPay — система ECPayment
* ExternalGateway — оплата через внешний шлюз
* Gateline — платежный шлюз компании «Онэлия»
* Invoice — оплата по счету
* Offices — оплата в офисе
* PayPal — оператор электронных денежных средств PayPAl
* PayU — процессинговая компания PayU
* Payture — электронный платежный шлюз Альфа-банка
* Platron — система электронных платежей Платрон
* PrivatBank — платежный шлюз «Приватбанк»
* Qiwi — оплата через сеть терминалов Qiwi
* Rapida — платежная система Рапида
* Receipt — оплата по квитанции
* Sberbank — платежный шлюз Сбербанка
* Sirena2 — платежный шлюз процессинговой системы eGopay
* Uniteller — платежный шлюз Uniteller
* WebMoney — система расчетов Webmoney

[[Файл:Fb2 paymethods.png|500px]]

====Параметры настройки блока выбора способа оплаты====
* '''Способ отображения выбора способа оплаты''' — выбор способа отображения списка способов оплаты на странице бронирования:
** '''''Выпадающий список''''',
** '''''Кнопки'''''.

===Блок сплита===
Блок сплита содержит флажки для каждого пассажира для произведения сплита (выделения их в отдельную бронь):

[[Файл: сплит.png|900px]]

Настройка '''Разрешить сплит PNR''' включается в разделе '''Управление продажами → Процессы → Форма бронирования'''.

== Другие параметры настройки формы бронирования ==
Все параметры настройки формы бронирования расположены в разделе '''Управление продажами → Процессы → Форма бронирования'''.

* {{Setting|Включено для Авиабилетов}} — опция включает модуль бронирования.
* {{Setting|Мгновенный переход на бронирование и фоновая проверка доступности}} — включает проверку доступности в фоном режиме. Пользователь без ожидания попадает со страницы поиска на страницу оформления заказа. Если при проверке доступности возникает ошибка, пользователь увидит диалоговое окно с уведомлением.
* {{Setting|Режим отладки}} 一 опция устарела, не включать.

====Дополнительные опции====
* {{Setting|Авиабилеты: позволять не выбирать семейство тарифов}} 一 включает возможность не выбирать семейство тарифов во всплывающем окне на странице ввода пассажирских данных (у всплывающего окна появляется кнопка «Закрыть»).
* {{Setting|Авиабилеты: позволять перевыбрать семейство тарифов}} 一 включает возможность выбора иного семейства тарифов на странице ввода пассажирских данных.
{{Attention|Настройки {{Setting|«Авиабилеты: позволять не выбирать семейство тарифов»}} и {{Setting|«Авиабилеты: позволять перевыбрать семейство тарифов»}} работают только на новой стандартной теме оформления и темах, сделанных на ее основе.}}
* {{Setting|Авиабилеты: предлагать выбор питания до бронирования}} 一 включает возможность выбора типа питания для каждого пассажира на этапе бронирования.
* {{Setting|Авиабилеты: предлагать выбор мест до бронирования}} — включает возможность выбора мест в салоне самолета на карте мест для каждого пассажира на этапе бронирования.

* {{Setting|Доп. услуги всегда открыты вне зависимости от выбранности}} — включает отображение блоков дополнительных услуг (Альфа страхование, Аэроэкспресс) в развернутом виде независимо от того, выбрана ли по умолчанию дополнительная услуга или нет.
* {{Setting|Производить печать маршрут-квитанции при нажатии кнопки "Мои билеты"}} — включает автоматический переход на страницу печати PDF-файла [[Маршрут-квитанция|маршрут-квитанции]] при нажатии на кнопку «Мои билеты».

* {{Setting|Предложить новый рейс в случае, если бронирование не удается по причине нехватки мест}} 一 включает запуск репрайсинга после неуспешной попытки бронирования, в целях повышения конверсии. Для использования данного функционала должен быть настроен [[Репрайсинг перелётов| репрайсинг перелётов.]]

====Временные ограничения на довнесение данных====
* {{Setting|Авиабилеты: ограничение в часах на возможность внести/изменить визовые данные}} — устанавливает время в часах, в течение которого можно довнести или изменить визовые данные.
* {{Setting|Авиабилеты: ограничение в часах на возможность внести/изменить паспортные данные}} — устанавливает время в часах, в течение которого можно довнести или изменить паспортные данные.
[[Файл:Booking_notice_new.png|200px|thumb|right|Плашка напоминаний о последних бронированиях]]

====Внешний вид и функциональность формы====
* {{Setting|Авиабилеты: улучшенные элементы формы бронирования}} — список элементов формы бронирования, доступных к улучшению оформления: 
** {{Setting|Блок ввода пассажирских данных}} — отвечает за блок ввода данных пассажиров и покупателя.
** {{Setting|Блок информации о заказе}} — отвечает за блок подробной информации о заказе, влияет на работу всплывающего окна семейств тарифов (см. [[Семейства тарифов#Принцип работы с семействами тарифов в Nemo.travel|Принцип работы с семействами тарифов в Nemo.travel]]). Вместе с данной настройкой рекомендуется включать {{Setting|Авиабилеты: позволять перевыбрать семейство тарифов}}.
** {{Setting|Блок быстрого перехода к оплате}} — отвечает за фиксированную (внизу экрана) панель быстрого перехода к блоку оплаты, а также за изменения в шапке блока оплаты.
** {{Setting|Двухэтапное бронирование}} — отвечает за разделение этапа ввода данных и этапа выбора дополнительных услуг: до бронирования доступен только ввод данных, после бронирования — на страницу заказа подгружаются блоки с дополнительными услугами и выбором способа оплаты. {{Attention|Перед включением данной настройки дополнительные услуги, отображаемые до бронирования, необходимо перенастроить на отображение после бронирования.}}

{| class="wikitable"
|-
|[[Файл:Improved_checkout.png|800px]]
|-
|Улучшенные элементы формы бронирования
|}
* {{Setting|Авиабилеты: использовать динамические подсказки к полям}} — включает отображение подсказок по формату заполнения полей формы бронирования. Текст подсказок редактируется в разделе '''Администрирование → Локализация → Языковые ресурсы'''.
* {{Setting|Показывать напоминания о последних бронированиях}} — включает плашку с напоминанием о забронированных, но еще не выписанным заказам. Плашка активна на форме поиска до форме бронирования.
* {{Setting|Автоматический переход на оплату после завершения бронирования}} — включает переход на оплату после успешного бронирования, не переходя на промежуточную страницу формы бронирования.
* {{Setting|Предупреждать покупателя об изменении стоимости заказа через всплывающее окно}} — включает уведомление пользователя об изменении стоимости перелета с помощью всплывающего окна, в котором отображается с информация о новой и старой стоимости заказа, кнопка аннулирования заказа и кнопка перехода к оплате заказа по новой цене. При отключенной опции информация об изменении стоимости отображается в отдельном блоке на странице бронирования.
* {{Setting|Предупреждать покупателя об одинаковых именах пассажиров и отображать поле для ввода отчества}} — настройка включает всплывающее окно с предупреждением для покупателя в случае, если в заказе присутствуют пассажиры с одинаковыми ФИ. Дальнейшие действия с заказом блокируются, и отображаются поля для ввода отчества пассажиров. {{Attention|Заказы с одинаковыми пассажирами, сделанные в ГРС Sirena, не подлежат бронированию даже в случае отключения данной настройки.}}
* {{Setting|Время, в течение которого следует завершить бронирование (в минутах)}} — по истечении указанного времени появится всплывающее окно с информацией об окончании времени бронирования, после чего процесс поиска и бронирования необходимо будет провести заново. Для снятия ограничения по времени бронирования необходимо в поле указать «0».
* {{Setting|Проводить бронирование в фоновом режиме}} — запускает фоновое бронирование, пока покупатель проверяет введенные данные. Сокращает время ожидания пользователя за счет единого окна проверки введенных данных и хода бронирования. Если пользователь решит внести исправления и нажмёт кнопку «Вернуться и исправить», то бронирование автоматически аннулируется в фоновом режиме. Разрешает пользователю аннулировать заказ, изменить данные и забронировать вновь в течение 10 минут. Наличие этого попапа снижает book2cancel, т.к. у пользователя есть возможность проверить введенные данные и выбранный рейс.
* {{Setting|Обновлять цену заказа в фоновом режиме}} — включает актуализацию цены с определёнными промежутками в фоновом режиме, чтобы минимизировать вероятность того, что клиент оплатит заказ по уже неактуальной цене, а так же для проверки наличия невалидных сегментов в брони сразу после бронирования.
* {{Setting|Чекбокс ''С правилами ознакомлен''}} — включает предустановленный активный флажок ''Я ознакомлен и согласен с правилами'' на странице бронирования.
* {{Setting|Чекбокс ''Разрешить создание заявки на бронирование''}} — после бронирования заказа в служебной информации менеджерам и экспертам агентства доступно скачивание заявки на бронирование. Шаблон заявки настраивается в разделе '''Настройки системы → Нотификации и документы → Документы → Документы для авиа → Заявка на бронирование'''.
* {{Setting|Чекбокс ''Отображать ссылку на английскую версию МК''}} — после выписки на странице просмотра МК будет доступна ссылка а скачивание МК на английском языке (при условии настройки шаблона. Описание настройки находится в статье [[Маршрут-квитанция]]
* {{Setting|Чекбокс ''Брать информацию о багаже из путеводителя''}} — включает загрузку информации о багаже из админки Немо 2 (Путеводитель -> Семейства тарифов). В выключенном состоянии информация о багаже загружается из GDS.
* {{Setting|Отображаемые категории правил в попапе УПТ}} — выводит только указанные пункты в УПТ (Условия тарифа), неуказанные - скрываются. В поле вносятся целые числа соответствующие номерам пунктов УПТ, через запятую. Пустое поле означает отображение всех правил.

== Валидация вводимых данных ==

* Минимально допустимая дата рождения для [[Пассажир#Коды категорий пассажиров|взрослого]] определяется по дате вылета первого сегмента перелета, т.е. главное условие — чтобы хотя бы в день вылета пассажиру уже исполнилось 12.
* Для свидетельства о рождении допустимо вводить номера, состоящие из следующих символов: латинские символы — от 1 до 3 включительно, кириллица — строго 2 буквы, цифры — строго 6.
* При попытке забронировать заказ, в котором есть как минимум два [[пассажир]]а с одинаковыми именем и фамилией, будет предложено довнести отчество для одного из пассажиров. Опция предотвратит ошибки от ГРС.

==См. также==
*[[Бронирование]]
*[[Поиск (Авиабилеты)]]
*[[Форма поиска (Авиабилеты)]]
*[[Пассажир]]