Рапида: различия между версиями
м (→См. также) |
(→См. также) |
||
(не показано 15 промежуточных версий 7 участников) | |||
Строка 1: | Строка 1: | ||
− | [[Категория:Поставщики]][[Файл:Rapida.png|450px|справа|Интерфейс агентской программы Rapida]] | + | [[Категория:Поставщики платежных решений]] |
− | '''Рапида''' | + | [[Категория:Способы оплаты]] |
+ | <!-- --> | ||
+ | [[Файл:Rapida.png|450px|справа|Интерфейс агентской программы Rapida]] | ||
+ | '''Рапида''' — платежная система, предоставляющая услуги в сфере розничных расчетов. Имеет крупную сеть пунктов приема платежей: кассы магазинов бытовой техники, сетей сотовой связи, терминалы самообслуживания и банкоматы (90 000 точек по всей России). Перевод денежных средств на счета получателя платежа можно также осуществить с помощью мобильного телефона и платежного сервиса Rapida Online. | ||
Компания «Евросеть» является участником платежной системы «Рапида». | Компания «Евросеть» является участником платежной системы «Рапида». | ||
− | == Взаимодействие между | + | == Взаимодействие между {{NameSystem}} и Евросетью == |
− | Алгоритм взаимодействия | + | Алгоритм взаимодействия {{NameSystem}} и Евросети: |
− | + | # Клиент бронирует услугу на стороне {{NameSystem}} и выбирает способ оплаты. | |
− | + | # Клиент получает от {{NameSystem}} уникальный платежный код (ПК). | |
− | + | # Клиент называет ПК представителям Евросети. | |
− | + | # Евросеть делает «запрос о состоянии счета» в {{NameSystem}}. | |
− | + | # Система {{NameSystem}} уточняет стоимость заказа, возможность оплаты счета и отдает сумму заказа в Евросеть. | |
− | + | # Евросеть взимает деньги с клиента и выписывает чек. | |
− | + | # Евросеть отправляет «запрос об оплате» в {{NameSystem}}. | |
− | + | # Система {{NameSystem}} подтверждает получение денег. | |
== Заполнение регистрационной карты == | == Заполнение регистрационной карты == | ||
− | + | * {{Setting|Параметры платежа для идентификации и проверки (название поля, количество знаков)}} — поле {{Setting|OPERATION_ID}}, количество знаков на данный момент не ограничено, минимально возможное значение — 9 цифр. | |
− | |||
− | |||
− | + | == Настройки на стороне {{NameSystem}} == | |
− | + | [[Файл:Rapida nemo.png|right|600px]] | |
− | [[ | + | * {{Setting|Включить проверку таймлимита}} — включает проверку таймлимита при получении инфо-запроса. |
+ | * {{Setting|Значение таймлимита в минутах}} — время до ближайшего таймлимита, меньше которого инфо-запросы обрабатываются с ошибкой. | ||
+ | * {{Setting|Боевой и тестовый режимы}} — в тестовом режиме на «запрос об оплате» {{NameSystem}} отвечает ошибкой и не проставляет статус оплаты. Используется для тестирования системы. | ||
+ | * {{Setting|Пропускать страницу с кнопкой «Получить код»}} — включение данной настройки позволяет пропускать страницу с кнопкой «Получить код». При этом выбирая данный [[платежный шлюз]] сразу же предоставляется номер для оплаты и устанавливается состояние платежа «ожидание оплаты», что блокирует выбор другого способа оплаты. | ||
+ | * {{Setting|Генерировать ссылку на маршрут-квитанцию в инфо-запросе}} — настройка включает генерацию ссылки на маршрут-квитанцию в инфо-запросе, ссылка появляется там только после того как билет выписан в системе {{NameSystem}}. | ||
+ | * {{Setting|Префикс}} — согласуется с Евросетью и используется для формирования ПК. Пример значения: 123 | ||
+ | * {{Setting|Ключ}} — согласуется с Евросетью, используется для подписи запросов. Пример значения: r5K1xpa0C | ||
− | + | {{Attention|Значения ключа и префикса задаются самим менеджером агентства, система {{NameSystem}} их сама не генерирует. Значения данных параметров требуется передать в Евросеть для согласования.}} | |
− | + | * {{Setting|Добавить PNR в идентификатор операции}} — изменяет стандартный формат платежного кода: (Префикс, 123)а(номер биллинга наш, 9цифр)a(PNR) | |
− | |||
− | * | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | + | В случае если в запросе была ошибка номера биллинга или имени PNR, то в системе логирования будет соответствующие уведомление. | |
− | + | {{Attention|После префикса следует латинская буква «a», которая вставляется системой {{NameSystem}} автоматически, в настройки её добавлять не нужно.}} | |
+ | * {{Setting|Сообщение пользователю, %CODE% - платежный код}} — сообщение, выводимое пользователю при получении платежного кода. В тексте обязательно использовать '''%CODE%''', при выводе данный плейсхолдер заменяется платежным кодом. | ||
+ | * {{Setting|Сообщение пользователю на странице с кнопкой «Получить код»}} — здесь можно добавить текст, который будет виден пользователю на странице с кнопкой «Получить код». Для получения доступа к маршрут-квитанции, формируемой в инфо-запросе неавторизованным пользователем код доступа не требуется. | ||
+ | * {{Setting|Краткая информация о квитанции для отображения пользователю (доступно не во всех темах)}} — здесь можно добавить краткое описание платежного метода для отображения его в блоке ПШ при выборе способа оплаты. <!-- На данный момент доступно в теме для agent.ru --> | ||
+ | * {{Setting|Содержимое квитанции для печати (доступно не во всех темах)}} — здесь можно задать вид квитанции к печати. <!-- На данный момент доступно в теме для agent.ru --> | ||
− | *Проверяется валидность тарифа, сегменты перелета и т.д. В этот момент возможно изменение суммы заказа в соответствии с требованиями поставщика. Если при этом обновлении возникают ошибки, система возвращает код ошибки | + | Для двух вышеуказанных настроек работают следующие переменные: |
− | *Проверяется состояние заказа в | + | {| class="wikitable" |
− | *Если включена настройка | + | | %CODE% |
+ | | Код для оплаты | ||
+ | |- | ||
+ | | %TIME_LIMIT% | ||
+ | | Таймлимит на оплату (если включен в настройках ПШ) | ||
+ | |- | ||
+ | | %MONEY_AMOUNT% | ||
+ | | Сумма к оплате без валюты (в валюте агенства) | ||
+ | |- | ||
+ | | %MONEY_CURRENCY% | ||
+ | | Валюта, в которой будет произведена оплата | ||
+ | |} | ||
+ | |||
+ | == Запрос о состоянии заказа == | ||
+ | |||
+ | При получении «запроса о состоянии заказа» {{NameSystem}} обновляет параметры заказа: | ||
+ | |||
+ | * Проверяется валидность тарифа, сегменты перелета и т.д. В этот момент возможно изменение суммы заказа в соответствии с требованиями поставщика. Если при этом обновлении возникают ошибки, система возвращает код ошибки 500. | ||
+ | * Проверяется состояние заказа в {{NameSystem}}. Если заказ не является забронированным или выписанным, система возвращает код ошибки 501. | ||
+ | * Если включена настройка {{Setting|Включить проверку таймлимитов}}, так же проверяется время до наступления ближайшего таймлимита и если оно менее значения поля {{Setting|Значение таймлимита в минутах}}, система возвращает код ошибки 502. | ||
+ | |||
+ | Логи общения системы с платежным шлюзом можно отслеживать в разделе административного модуля системы «Способы оплаты» → «Платежный лог». | ||
+ | |||
+ | В ряде случаев на запрос о состоянии заказа система отвечает ошибкой. | ||
+ | |||
+ | Код ошибки 100 предполагает повторный запрос через определенный промежуток времени. | ||
+ | |||
+ | Код 5ХХ означает, что повторных запросы не должны отправляться, так как ситуация не изменится и платеж совершить невозможно. | ||
+ | |||
+ | === Расшифровка кодов возможных ошибок === | ||
+ | |||
+ | {| class="wikitable" | ||
+ | |100 | ||
+ | |система занята, не может дать ответ | ||
+ | |- | ||
+ | |200 | ||
+ | |ошибка подписи | ||
+ | |- | ||
+ | |400 | ||
+ | |указанная операция не существует | ||
+ | |- | ||
+ | |450 | ||
+ | |несуществующий тип операции | ||
+ | |- | ||
+ | |458 | ||
+ | |неправильно заданный номер операции | ||
+ | |- | ||
+ | |500 | ||
+ | |операция не может быть оплачена (фатальная ошибка при обновлении заказа) | ||
+ | |- | ||
+ | |501 | ||
+ | |ошибка состояния заказа (заказ не забронирован или аннулирован) | ||
+ | |- | ||
+ | |502 | ||
+ | |превышение допустимого таймлимита | ||
+ | |- | ||
+ | |600 | ||
+ | |недостаточное количество параметров запроса | ||
+ | |} | ||
== Запрос об оплате == | == Запрос об оплате == | ||
− | При получении «запроса об оплате» | + | При получении «запроса об оплате» {{NameSystem}} проставляет счету статус оплачено и предоставляет клиенту услугу. При этом никаких проверок не производится. |
− | |||
− | |||
− | == Бонусная карта | + | {{Attention|Проверка таймлимитов рекомендуется для избежания ситуации изменения тарифа до момента получения «запроса об оплате». Тем не менее эта мера предосторожности не гарантирует простановку статуса «оплачено» и успешную выписку билета до момента изменения параметров заказа, т.к. между моментом получения «запроса о состоянии счета» и моментом получения «запроса об оплате» может пройти больше времени, чем указано в настройке {{Setting|Таймлимит}} или параметры заказа могут измениться по независящим от таймлимита причинам.}} |
+ | == Бонусная карта «Кукуруза» == | ||
+ | [[Файл:Corn.png|250px|справа|Бонусная карта «Кукуруза»]] | ||
При выборе данного способа оплаты часть стоимости заказа может быть оплачена бонусными баллами карты «Кукуруза». При этом на странице с информацией о бронировании можно увидеть суммы, оплаченные баллами и деньгами. | При выборе данного способа оплаты часть стоимости заказа может быть оплачена бонусными баллами карты «Кукуруза». При этом на странице с информацией о бронировании можно увидеть суммы, оплаченные баллами и деньгами. | ||
== См. также == | == См. также == | ||
− | *[[Тариф]] | + | * [[Тариф]] |
− | *[[Таймлимит]] | + | * [[Таймлимит]] |
− | *[[Маршрут-квитанция]] | + | * [[Маршрут-квитанция]] |
− | *[[Платежный шлюз]] | + | * [[Платежный шлюз]] |
− | *[[Статистика#Статистика поставщиков|Статистика поставщиков]] | + | * [[Статистика#Статистика поставщиков|Статистика поставщиков]] |
+ | * [[Интеграция сервиса приёма платежей с помощью Payment Gateway API|Универсальный протокол Payment Gateway API]] | ||
== Полезные ссылки == | == Полезные ссылки == | ||
− | *[http://www.rapida.ru Сайт платежной системы | + | * [http://www.rapida.ru Сайт платежной системы «Рапида»] |
− | *[http://euroset.ru Сайт компании | + | * [http://euroset.ru Сайт компании «Евросеть»] |
Текущая версия на 14:00, 9 апреля 2020
Рапида — платежная система, предоставляющая услуги в сфере розничных расчетов. Имеет крупную сеть пунктов приема платежей: кассы магазинов бытовой техники, сетей сотовой связи, терминалы самообслуживания и банкоматы (90 000 точек по всей России). Перевод денежных средств на счета получателя платежа можно также осуществить с помощью мобильного телефона и платежного сервиса Rapida Online.
Компания «Евросеть» является участником платежной системы «Рапида».
Содержание
Взаимодействие между Nemo.Travel и Евросетью
Алгоритм взаимодействия Nemo.Travel и Евросети:
- Клиент бронирует услугу на стороне Nemo.Travel и выбирает способ оплаты.
- Клиент получает от Nemo.Travel уникальный платежный код (ПК).
- Клиент называет ПК представителям Евросети.
- Евросеть делает «запрос о состоянии счета» в Nemo.Travel.
- Система Nemo.Travel уточняет стоимость заказа, возможность оплаты счета и отдает сумму заказа в Евросеть.
- Евросеть взимает деньги с клиента и выписывает чек.
- Евросеть отправляет «запрос об оплате» в Nemo.Travel.
- Система Nemo.Travel подтверждает получение денег.
Заполнение регистрационной карты
- Параметры платежа для идентификации и проверки (название поля, количество знаков) — поле OPERATION_ID, количество знаков на данный момент не ограничено, минимально возможное значение — 9 цифр.
Настройки на стороне Nemo.Travel
- Включить проверку таймлимита — включает проверку таймлимита при получении инфо-запроса.
- Значение таймлимита в минутах — время до ближайшего таймлимита, меньше которого инфо-запросы обрабатываются с ошибкой.
- Боевой и тестовый режимы — в тестовом режиме на «запрос об оплате» 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 проставляет счету статус оплачено и предоставляет клиенту услугу. При этом никаких проверок не производится.
Внимание! Проверка таймлимитов рекомендуется для избежания ситуации изменения тарифа до момента получения «запроса об оплате». Тем не менее эта мера предосторожности не гарантирует простановку статуса «оплачено» и успешную выписку билета до момента изменения параметров заказа, т.к. между моментом получения «запроса о состоянии счета» и моментом получения «запроса об оплате» может пройти больше времени, чем указано в настройке Таймлимит или параметры заказа могут измениться по независящим от таймлимита причинам.
Бонусная карта «Кукуруза»
При выборе данного способа оплаты часть стоимости заказа может быть оплачена бонусными баллами карты «Кукуруза». При этом на странице с информацией о бронировании можно увидеть суммы, оплаченные баллами и деньгами.
См. также
- Тариф
- Таймлимит
- Маршрут-квитанция
- Платежный шлюз
- Статистика поставщиков
- Универсальный протокол Payment Gateway API