Рапида: различия между версиями

Материал из Центр поддержки системы бронировании
Перейти к навигации Перейти к поиску
(Запрос о состоянии счета)
(См. также)
 
(не показано 12 промежуточных версий 6 участников)
Строка 1: Строка 1:
[[Категория:Поставщики платежных решений]][[Категория:Способы оплаты]][[Файл:Rapida.png|450px|справа|Интерфейс агентской программы Rapida]]
+
[[Категория:Поставщики платежных решений]]
'''Рапида''' - платежная система, предоставляющая услуги в сфере розничных расчетов. Имеет крупную сеть пунктов приема платежей: кассы магазинов бытовой техники, сетей сотовой связи, терминалы самообслуживания и банкоматы (90 000 точек по всей России). Перевод денежных средств на счета получателя платежа можно также осуществить с помощью мобильного телефона и платежного сервиса Rapida Online.
+
[[Категория:Способы оплаты]]
 +
<!-- -->
 +
[[Файл:Rapida.png|450px|справа|Интерфейс агентской программы Rapida]]
 +
'''Рапида''' платежная система, предоставляющая услуги в сфере розничных расчетов. Имеет крупную сеть пунктов приема платежей: кассы магазинов бытовой техники, сетей сотовой связи, терминалы самообслуживания и банкоматы (90 000 точек по всей России). Перевод денежных средств на счета получателя платежа можно также осуществить с помощью мобильного телефона и платежного сервиса Rapida Online.
  
 
Компания «Евросеть» является участником платежной системы «Рапида».
 
Компания «Евросеть» является участником платежной системы «Рапида».
  
== Взаимодействие между Nemo и Евросетью ==
+
== Взаимодействие между {{NameSystem}} и Евросетью ==
  
Алгоритм взаимодействия Nemo и Евросети:
+
Алгоритм взаимодействия {{NameSystem}} и Евросети:
 
   
 
   
1. Клиент бронирует услугу на стороне Nemo и выбирает способ оплаты.<br>
+
# Клиент бронирует услугу на стороне {{NameSystem}} и выбирает способ оплаты.
2. Клиент получает от Nemo уникальный платежный код (ПК).<br>
+
# Клиент получает от {{NameSystem}} уникальный платежный код (ПК).
3. Клиент называет ПК представителям Евросети.<br>
+
# Клиент называет ПК представителям Евросети.
4. Евросеть делает «запрос о состоянии счета» в Nemo.<br>
+
# Евросеть делает «запрос о состоянии счета» в {{NameSystem}}.
5. Nemo уточняет стоимость заказа, возможность оплаты счета и отдает сумму заказа в Евросеть.<br>
+
# Система {{NameSystem}} уточняет стоимость заказа, возможность оплаты счета и отдает сумму заказа в Евросеть.
6. Евросеть взимает деньги с клиента и выписывает чек.<br>
+
# Евросеть взимает деньги с клиента и выписывает чек.
7. Евросеть отправляет «запрос об оплате» в Nemo.<br>
+
# Евросеть отправляет «запрос об оплате» в {{NameSystem}}.
8. Nemo подтверждает получение денег.<br>
+
# Система {{NameSystem}} подтверждает получение денег.
  
 
== Заполнение регистрационной карты ==
 
== Заполнение регистрационной карты ==
  
'''«URL - адрес для запросов и уведомлений о платежах»''':
+
* {{Setting|Параметры платежа для идентификации и проверки (название поля, количество знаков)}} — поле {{Setting|OPERATION_ID}}, количество знаков на данный момент не ограничено, минимально возможное значение — 9 цифр.
*тестовый: [http://srt.mute-lab.com/index.php?go=rapida/check http://srt.mute-lab.com/index.php?go=rapida/check]
 
*боевой: host/index.php?go=rapida/check.
 
  
'''«Параметры платежа для идентификации и проверки (название поля, количество знаков)»''' - поле OPERATION_ID, кол-во знаков на данный момент не ограничено, минимально возможное значение - 9 цифр.
+
== Настройки на стороне {{NameSystem}} ==
  
== Настройки на стороне Nemo ==
+
[[Файл:Rapida nemo.png|right|600px]]
  
[[Файл:Rapida nemo.png]]
+
* {{Setting|Включить проверку таймлимита}} — включает проверку таймлимита при получении инфо-запроса.
 +
* {{Setting|Значение таймлимита в минутах}} — время до ближайшего таймлимита, меньше которого инфо-запросы обрабатываются с ошибкой.
 +
* {{Setting|Боевой и тестовый режимы}} — в тестовом режиме на «запрос об оплате» {{NameSystem}} отвечает ошибкой и не проставляет статус оплаты. Используется для тестирования системы.
 +
* {{Setting|Пропускать страницу с кнопкой «Получить код»}} — включение данной настройки позволяет пропускать страницу с кнопкой «Получить код». При этом выбирая данный [[платежный шлюз]] сразу же предоставляется номер для оплаты и устанавливается состояние платежа «ожидание оплаты», что блокирует выбор другого способа оплаты.
 +
* {{Setting|Генерировать ссылку на маршрут-квитанцию в инфо-запросе}} — настройка включает генерацию ссылки на маршрут-квитанцию в инфо-запросе, ссылка появляется там только после того как билет выписан в системе {{NameSystem}}.
 +
* {{Setting|Префикс}} — согласуется с Евросетью и используется для формирования ПК. Пример значения: 123
 +
* {{Setting|Ключ}} — согласуется с Евросетью, используется для подписи запросов. Пример значения: r5K1xpa0C
  
*'''Включить проверку таймлимита''' - включает проверку таймлимита при получении инфо-запроса.
+
{{Attention|Значения ключа и префикса задаются самим менеджером агентства, система {{NameSystem}} их сама не генерирует. Значения данных параметров требуется передать в Евросеть для согласования.}}
*'''Значение таймлимита в минутах''' - время до ближайшего таймлимита, меньше которого инфо-запросы обрабатываются с ошибкой.
+
* {{Setting|Добавить PNR в идентификатор операции}} — изменяет стандартный формат платежного кода: (Префикс, 123)а(номер биллинга наш, 9цифр)a(PNR)
*'''Боевой и тестовый режимы''' - в тестовом режиме на «запрос об оплате» Nemo отвечает ошибкой и не проставляет статус оплаты. Используется для тестирования системы.
+
 
*'''Пропускать страницу с кнопкой «Получить код»''' - включение данной настройки позволяет пропускать страницу с кнопкой «Получить код». При этом выбирая данный [[платежный шлюз]] сразу же предоставляется номер для оплаты и устанавливается состояние платежа «ожидание оплаты», что блокирует выбор другого способа оплаты.*'''«Генерировать ссылку на маршрут-квитанцию в инфо-запросе»''' - настройка включает генерацию ссылки на маршрут-квитанцию в инфо-запросе, ссылка появляется там только после того как билет выписан в системе Nemo.
+
В случае если в запросе была ошибка номера биллинга или имени PNR, то в системе логирования будет соответствующие уведомление.  
*'''Префикс''' - согласуется с Евросетью и используется для формирования ПК.
+
 
*'''Ключ''' - согласуется с Евросетью, используется для подписи запросов.
+
{{Attention|После префикса следует латинская буква «a», которая вставляется системой {{NameSystem}} автоматически, в настройки её добавлять не нужно.}}
*'''Сообщение пользователю, %CODE% - платежный код''' - сообщение, выводимое пользователю при получении платежного кода. В тексте обязательно использовать '''%CODE%''', при выводе данный плейсхолдер заменяется платежным кодом.
+
* {{Setting|Сообщение пользователю, %CODE% - платежный код}} — сообщение, выводимое пользователю при получении платежного кода. В тексте обязательно использовать '''%CODE%''', при выводе данный плейсхолдер заменяется платежным кодом.
*'''Сообщение пользователю на странице с кнопкой «Получить код»''' - здесь можно добавить текст, который будет виден пользователю на странице с кнопкой «Получить код».
+
* {{Setting|Сообщение пользователю на странице с кнопкой «Получить код»}} — здесь можно добавить текст, который будет виден пользователю на странице с кнопкой «Получить код». Для получения доступа к маршрут-квитанции, формируемой в инфо-запросе неавторизованным пользователем код доступа не требуется.
Для получения доступа к маршрут-квитанции, формируемой в инфо-запросе неавторизованным пользователем код доступа не требуется.
+
* {{Setting|Краткая информация о квитанции для отображения пользователю (доступно не во всех темах)}} — здесь можно добавить краткое описание платежного метода для отображения его в блоке ПШ при выборе способа оплаты. <!-- На данный момент доступно в теме для agent.ru -->
 +
* {{Setting|Содержимое квитанции для печати (доступно не во всех темах)}} — здесь можно задать вид квитанции к печати. <!-- На данный момент доступно в теме для agent.ru -->
 +
 
 +
Для двух вышеуказанных настроек работают следующие переменные:
 +
{| class="wikitable"
 +
| %CODE%
 +
| Код для оплаты
 +
|-
 +
| %TIME_LIMIT%
 +
| Таймлимит на оплату (если включен в настройках ПШ)
 +
|-
 +
| %MONEY_AMOUNT%
 +
| Сумма к оплате без валюты (в валюте агенства)
 +
|-
 +
| %MONEY_CURRENCY%
 +
| Валюта, в которой будет произведена оплата
 +
|}
  
 
== Запрос о состоянии заказа ==
 
== Запрос о состоянии заказа ==
  
При получении «запроса о состоянии заказа» Nemo обновляет параметры заказа:
+
При получении «запроса о состоянии заказа» {{NameSystem}} обновляет параметры заказа:
  
*Проверяется валидность тарифа, сегменты перелета и т.д. В этот момент возможно изменение суммы заказа в соответствии с требованиями поставщика. Если при этом обновлении возникают ошибки, система возвращает код ошибки 500;
+
* Проверяется валидность тарифа, сегменты перелета и т.д. В этот момент возможно изменение суммы заказа в соответствии с требованиями поставщика. Если при этом обновлении возникают ошибки, система возвращает код ошибки 500.
*Проверяется состояние заказа в Nemo. Если заказ не является забронированным или выписанным, система возвращает код ошибки 501;
+
* Проверяется состояние заказа в {{NameSystem}}. Если заказ не является забронированным или выписанным, система возвращает код ошибки 501.
*Если включена настройка «Включить проверку таймлимитов», так же проверяется время до наступления ближайшего таймлимита и если оно менее значения поля «Значение таймлимита в минутах», система возвращает код ошибки 502.
+
* Если включена настройка {{Setting|Включить проверку таймлимитов}}, так же проверяется время до наступления ближайшего таймлимита и если оно менее значения поля {{Setting|Значение таймлимита в минутах}}, система возвращает код ошибки 502.
  
Логи общения системы с платежным шлюзом можно отслеживать в разделе административного модуля системы "'''Способы оплаты'''" - "'''Платежный лог'''".
+
Логи общения системы с платежным шлюзом можно отслеживать в разделе административного модуля системы «Способы оплаты» → «Платежный лог».
  
 
В ряде случаев на запрос о состоянии заказа система отвечает ошибкой.
 
В ряде случаев на запрос о состоянии заказа система отвечает ошибкой.
  
:::'''Расшифровка кодов возможных ошибок'''
+
Код ошибки 100 предполагает повторный запрос через определенный промежуток времени.
  
{| cellpadding="7" cellspacing="0" border="1"
+
Код 5ХХ означает, что повторных запросы не должны отправляться, так как ситуация не изменится и платеж совершить невозможно.
 +
 
 +
=== Расшифровка кодов возможных ошибок ===
 +
 
 +
{| class="wikitable"
 
|100
 
|100
 
|система занята, не может дать ответ
 
|система занята, не может дать ответ
Строка 84: Строка 111:
 
== Запрос об оплате ==
 
== Запрос об оплате ==
  
При получении «запроса об оплате» Nemo проставляет счету статус оплачено и предоставляет клиенту услугу. При этом никаких проверок не производится.
+
При получении «запроса об оплате» {{NameSystem}} проставляет счету статус оплачено и предоставляет клиенту услугу. При этом никаких проверок не производится.
 
 
<span style="background-color:#fff0f5;"><span style="font-size:large;"><span style="color:#ff0000;">!</span></span> Проверка таймлимитов рекомендуется для избежания ситуации изменения тарифа до момента получения «запроса об оплате». Тем не менее эта мера предосторожности не гарантирует простановку статуса "оплачено" и успешную выписку билета до момента изменения параметров заказа, т.к. между моментом получения "запроса о состоянии счета" и моментом получения "запроса об оплате»" может пройти больше времени, чем указано в настройке «Таймлимит» или параметры заказа могут измениться по независящим от таймлимита причинам.[[Файл:Corn.png|250px|справа|Бонусная карта "Кукуруза"]]
 
  
== Бонусная карта "Кукуруза" ==
+
{{Attention|Проверка таймлимитов рекомендуется для избежания ситуации изменения тарифа до момента получения «запроса об оплате». Тем не менее эта мера предосторожности не гарантирует простановку статуса «оплачено» и успешную выписку билета до момента изменения параметров заказа, т.к. между моментом получения «запроса о состоянии счета» и моментом получения «запроса об оплате» может пройти больше времени, чем указано в настройке {{Setting|Таймлимит}} или параметры заказа могут измениться по независящим от таймлимита причинам.}}
 +
== Бонусная карта «Кукуруза» ==
 +
[[Файл:Corn.png|250px|справа|Бонусная карта «Кукуруза»]]
 
При выборе данного способа оплаты часть стоимости заказа может быть оплачена бонусными баллами карты «Кукуруза». При этом на странице с информацией о бронировании можно увидеть суммы, оплаченные баллами и деньгами.
 
При выборе данного способа оплаты часть стоимости заказа может быть оплачена бонусными баллами карты «Кукуруза». При этом на странице с информацией о бронировании можно увидеть суммы, оплаченные баллами и деньгами.
  
 
== См. также ==
 
== См. также ==
*[[Тариф]]<br>
+
* [[Тариф]]
*[[Таймлимит]]<br>
+
* [[Таймлимит]]
*[[Маршрут-квитанция]]<br>
+
* [[Маршрут-квитанция]]
*[[Платежный шлюз]]
+
* [[Платежный шлюз]]
*[[Статистика#Статистика поставщиков|Статистика поставщиков]]
+
* [[Статистика#Статистика поставщиков|Статистика поставщиков]]
 +
* [[Интеграция сервиса приёма платежей с помощью Payment Gateway API|Универсальный протокол Payment Gateway API]]
  
 
== Полезные ссылки ==
 
== Полезные ссылки ==
*[http://www.rapida.ru Сайт платежной системы "Рапида"]<br>
+
* [http://www.rapida.ru Сайт платежной системы «Рапида»]
*[http://euroset.ru Сайт компании "Евросеть"]
+
* [http://euroset.ru Сайт компании «Евросеть»]

Текущая версия на 14:00, 9 апреля 2020

Интерфейс агентской программы Rapida

Рапида — платежная система, предоставляющая услуги в сфере розничных расчетов. Имеет крупную сеть пунктов приема платежей: кассы магазинов бытовой техники, сетей сотовой связи, терминалы самообслуживания и банкоматы (90 000 точек по всей России). Перевод денежных средств на счета получателя платежа можно также осуществить с помощью мобильного телефона и платежного сервиса Rapida Online.

Компания «Евросеть» является участником платежной системы «Рапида».

Взаимодействие между Nemo.Travel и Евросетью

Алгоритм взаимодействия Nemo.Travel и Евросети:

  1. Клиент бронирует услугу на стороне Nemo.Travel и выбирает способ оплаты.
  2. Клиент получает от Nemo.Travel уникальный платежный код (ПК).
  3. Клиент называет ПК представителям Евросети.
  4. Евросеть делает «запрос о состоянии счета» в Nemo.Travel.
  5. Система Nemo.Travel уточняет стоимость заказа, возможность оплаты счета и отдает сумму заказа в Евросеть.
  6. Евросеть взимает деньги с клиента и выписывает чек.
  7. Евросеть отправляет «запрос об оплате» в Nemo.Travel.
  8. Система Nemo.Travel подтверждает получение денег.

Заполнение регистрационной карты

  • Параметры платежа для идентификации и проверки (название поля, количество знаков) — поле OPERATION_ID, количество знаков на данный момент не ограничено, минимально возможное значение — 9 цифр.

Настройки на стороне Nemo.Travel

Rapida nemo.png
  • Включить проверку таймлимита — включает проверку таймлимита при получении инфо-запроса.
  • Значение таймлимита в минутах — время до ближайшего таймлимита, меньше которого инфо-запросы обрабатываются с ошибкой.
  • Боевой и тестовый режимы — в тестовом режиме на «запрос об оплате» Nemo.Travel отвечает ошибкой и не проставляет статус оплаты. Используется для тестирования системы.
  • Пропускать страницу с кнопкой «Получить код» — включение данной настройки позволяет пропускать страницу с кнопкой «Получить код». При этом выбирая данный платежный шлюз сразу же предоставляется номер для оплаты и устанавливается состояние платежа «ожидание оплаты», что блокирует выбор другого способа оплаты.
  • Генерировать ссылку на маршрут-квитанцию в инфо-запросе — настройка включает генерацию ссылки на маршрут-квитанцию в инфо-запросе, ссылка появляется там только после того как билет выписан в системе Nemo.Travel.
  • Префикс — согласуется с Евросетью и используется для формирования ПК. Пример значения: 123
  • Ключ — согласуется с Евросетью, используется для подписи запросов. Пример значения: r5K1xpa0C

Внимание! Значения ключа и префикса задаются самим менеджером агентства, система Nemo.Travel их сама не генерирует. Значения данных параметров требуется передать в Евросеть для согласования.

  • Добавить PNR в идентификатор операции — изменяет стандартный формат платежного кода: (Префикс, 123)а(номер биллинга наш, 9цифр)a(PNR)

В случае если в запросе была ошибка номера биллинга или имени PNR, то в системе логирования будет соответствующие уведомление.

Внимание! После префикса следует латинская буква «a», которая вставляется системой Nemo.Travel автоматически, в настройки её добавлять не нужно.

  • Сообщение пользователю, %CODE% - платежный код — сообщение, выводимое пользователю при получении платежного кода. В тексте обязательно использовать %CODE%, при выводе данный плейсхолдер заменяется платежным кодом.
  • Сообщение пользователю на странице с кнопкой «Получить код» — здесь можно добавить текст, который будет виден пользователю на странице с кнопкой «Получить код». Для получения доступа к маршрут-квитанции, формируемой в инфо-запросе неавторизованным пользователем код доступа не требуется.
  • Краткая информация о квитанции для отображения пользователю (доступно не во всех темах) — здесь можно добавить краткое описание платежного метода для отображения его в блоке ПШ при выборе способа оплаты.
  • Содержимое квитанции для печати (доступно не во всех темах) — здесь можно задать вид квитанции к печати.

Для двух вышеуказанных настроек работают следующие переменные:

%CODE% Код для оплаты
%TIME_LIMIT% Таймлимит на оплату (если включен в настройках ПШ)
%MONEY_AMOUNT% Сумма к оплате без валюты (в валюте агенства)
%MONEY_CURRENCY% Валюта, в которой будет произведена оплата

Запрос о состоянии заказа

При получении «запроса о состоянии заказа» Nemo.Travel обновляет параметры заказа:

  • Проверяется валидность тарифа, сегменты перелета и т.д. В этот момент возможно изменение суммы заказа в соответствии с требованиями поставщика. Если при этом обновлении возникают ошибки, система возвращает код ошибки 500.
  • Проверяется состояние заказа в Nemo.Travel. Если заказ не является забронированным или выписанным, система возвращает код ошибки 501.
  • Если включена настройка Включить проверку таймлимитов, так же проверяется время до наступления ближайшего таймлимита и если оно менее значения поля Значение таймлимита в минутах, система возвращает код ошибки 502.

Логи общения системы с платежным шлюзом можно отслеживать в разделе административного модуля системы «Способы оплаты» → «Платежный лог».

В ряде случаев на запрос о состоянии заказа система отвечает ошибкой.

Код ошибки 100 предполагает повторный запрос через определенный промежуток времени.

Код 5ХХ означает, что повторных запросы не должны отправляться, так как ситуация не изменится и платеж совершить невозможно.

Расшифровка кодов возможных ошибок

100 система занята, не может дать ответ
200 ошибка подписи
400 указанная операция не существует
450 несуществующий тип операции
458 неправильно заданный номер операции
500 операция не может быть оплачена (фатальная ошибка при обновлении заказа)
501 ошибка состояния заказа (заказ не забронирован или аннулирован)
502 превышение допустимого таймлимита
600 недостаточное количество параметров запроса

Запрос об оплате

При получении «запроса об оплате» Nemo.Travel проставляет счету статус оплачено и предоставляет клиенту услугу. При этом никаких проверок не производится.

Внимание! Проверка таймлимитов рекомендуется для избежания ситуации изменения тарифа до момента получения «запроса об оплате». Тем не менее эта мера предосторожности не гарантирует простановку статуса «оплачено» и успешную выписку билета до момента изменения параметров заказа, т.к. между моментом получения «запроса о состоянии счета» и моментом получения «запроса об оплате» может пройти больше времени, чем указано в настройке Таймлимит или параметры заказа могут измениться по независящим от таймлимита причинам.

Бонусная карта «Кукуруза»

Бонусная карта «Кукуруза»

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

См. также

Полезные ссылки