Изменения

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

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

Модуль PAYMENT GATEWAY API является дополнительным. Чтобы подключиться к Nemo.travel Для подключения платёжного сервиса по данному протоколу, обратитесь в коммерческий отдел по адресу 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,*''Сервис'' - сервис по приему платежей.  ==Описание запросов== 

| register.do || Запрос регистрации заказа (без предавторизациипреавторизации)|| -

| registerPreAuth.do || Запрос регистрации заказа c предавторизацией преавторизацией || -

* Запросы , использующиеся при двухстадийной оплате (с предавторизациейпреавторизацией): registerPreAuth.do, deposit.do.* Запросы , использующиеся при одностадийной оплате (без предавторизациипреавторизации): register.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. ==Формат запросов/ответов==