Рапида: различия между версиями
(→Настройки на стороне Nemo) |
(→Настройки на стороне Nemo) |
||
| Строка 33: | Строка 33: | ||
*'''Добавить PNR в идентификатор операции''' - изменяет стандартный формат платежного кода: | *'''Добавить PNR в идентификатор операции''' - изменяет стандартный формат платежного кода: | ||
(Префикс, 123)а(номер биллинга наш, 9цифр)a(PNR) | (Префикс, 123)а(номер биллинга наш, 9цифр)a(PNR) | ||
| + | В случае если в запросе была ошибка номера биллинга или имени PNR, то системе логирования будет соответствующие уведомление. <br/> | ||
<span style="background-color:#fff0f5;">'''<span style="color:#ff0000;">Внимание!</span>''' После префикса следует латинская буква "a", которая вставляется системой Немо автоматически, в настройки её добавлять не нужно.</span> | <span style="background-color:#fff0f5;">'''<span style="color:#ff0000;">Внимание!</span>''' После префикса следует латинская буква "a", которая вставляется системой Немо автоматически, в настройки её добавлять не нужно.</span> | ||
| − | + | ||
*'''Сообщение пользователю, %CODE% - платежный код''' - сообщение, выводимое пользователю при получении платежного кода. В тексте обязательно использовать '''%CODE%''', при выводе данный плейсхолдер заменяется платежным кодом. | *'''Сообщение пользователю, %CODE% - платежный код''' - сообщение, выводимое пользователю при получении платежного кода. В тексте обязательно использовать '''%CODE%''', при выводе данный плейсхолдер заменяется платежным кодом. | ||
*'''Сообщение пользователю на странице с кнопкой «Получить код»''' - здесь можно добавить текст, который будет виден пользователю на странице с кнопкой «Получить код». | *'''Сообщение пользователю на странице с кнопкой «Получить код»''' - здесь можно добавить текст, который будет виден пользователю на странице с кнопкой «Получить код». | ||
Версия 17:01, 13 января 2015
Рапида - платежная система, предоставляющая услуги в сфере розничных расчетов. Имеет крупную сеть пунктов приема платежей: кассы магазинов бытовой техники, сетей сотовой связи, терминалы самообслуживания и банкоматы (90 000 точек по всей России). Перевод денежных средств на счета получателя платежа можно также осуществить с помощью мобильного телефона и платежного сервиса Rapida Online.
Компания «Евросеть» является участником платежной системы «Рапида».
Содержание
Взаимодействие между Nemo и Евросетью
Алгоритм взаимодействия Nemo и Евросети:
1. Клиент бронирует услугу на стороне Nemo и выбирает способ оплаты.
2. Клиент получает от Nemo уникальный платежный код (ПК).
3. Клиент называет ПК представителям Евросети.
4. Евросеть делает «запрос о состоянии счета» в Nemo.
5. Nemo уточняет стоимость заказа, возможность оплаты счета и отдает сумму заказа в Евросеть.
6. Евросеть взимает деньги с клиента и выписывает чек.
7. Евросеть отправляет «запрос об оплате» в Nemo.
8. Nemo подтверждает получение денег.
Заполнение регистрационной карты
«Параметры платежа для идентификации и проверки (название поля, количество знаков)» - поле OPERATION_ID, кол-во знаков на данный момент не ограничено, минимально возможное значение - 9 цифр.
Настройки на стороне Nemo
- Включить проверку таймлимита - включает проверку таймлимита при получении инфо-запроса.
- Значение таймлимита в минутах - время до ближайшего таймлимита, меньше которого инфо-запросы обрабатываются с ошибкой.
- Боевой и тестовый режимы - в тестовом режиме на «запрос об оплате» Nemo отвечает ошибкой и не проставляет статус оплаты. Используется для тестирования системы.
- Пропускать страницу с кнопкой «Получить код» - включение данной настройки позволяет пропускать страницу с кнопкой «Получить код». При этом выбирая данный платежный шлюз сразу же предоставляется номер для оплаты и устанавливается состояние платежа «ожидание оплаты», что блокирует выбор другого способа оплаты.*«Генерировать ссылку на маршрут-квитанцию в инфо-запросе» - настройка включает генерацию ссылки на маршрут-квитанцию в инфо-запросе, ссылка появляется там только после того как билет выписан в системе Nemo.
- Префикс - согласуется с Евросетью и используется для формирования ПК.
- Ключ - согласуется с Евросетью, используется для подписи запросов.
- Добавить PNR в идентификатор операции - изменяет стандартный формат платежного кода:
(Префикс, 123)а(номер биллинга наш, 9цифр)a(PNR)
В случае если в запросе была ошибка номера биллинга или имени PNR, то системе логирования будет соответствующие уведомление.
Внимание! После префикса следует латинская буква "a", которая вставляется системой Немо автоматически, в настройки её добавлять не нужно.
- Сообщение пользователю, %CODE% - платежный код - сообщение, выводимое пользователю при получении платежного кода. В тексте обязательно использовать %CODE%, при выводе данный плейсхолдер заменяется платежным кодом.
- Сообщение пользователю на странице с кнопкой «Получить код» - здесь можно добавить текст, который будет виден пользователю на странице с кнопкой «Получить код».
Для получения доступа к маршрут-квитанции, формируемой в инфо-запросе неавторизованным пользователем код доступа не требуется.
Запрос о состоянии заказа
При получении «запроса о состоянии заказа» Nemo обновляет параметры заказа:
- Проверяется валидность тарифа, сегменты перелета и т.д. В этот момент возможно изменение суммы заказа в соответствии с требованиями поставщика. Если при этом обновлении возникают ошибки, система возвращает код ошибки 500;
- Проверяется состояние заказа в Nemo. Если заказ не является забронированным или выписанным, система возвращает код ошибки 501;
- Если включена настройка «Включить проверку таймлимитов», так же проверяется время до наступления ближайшего таймлимита и если оно менее значения поля «Значение таймлимита в минутах», система возвращает код ошибки 502.
Логи общения системы с платежным шлюзом можно отслеживать в разделе административного модуля системы "Способы оплаты" - "Платежный лог".
В ряде случаев на запрос о состоянии заказа система отвечает ошибкой.
Код ошибки 100 предполагает повторный запрос через определенный промежуток времени.
Код 5ХХ означает, что повторных запросы не должны отправляться, так как ситуация не изменится и платеж совершить невозможно.
- Расшифровка кодов возможных ошибок
| 100 | система занята, не может дать ответ |
| 200 | ошибка подписи |
| 400 | указанная операция не существует |
| 450 | несуществующий тип операции |
| 458 | неправильно заданный номер операции |
| 500 | операция не может быть оплачена (фатальная ошибка при обновлении заказа) |
| 501 | ошибка состояния заказа (заказ не забронирован или аннулирован) |
| 502 | превышение допустимого таймлимита |
| 600 | недостаточное количество параметров запроса |
Запрос об оплате
При получении «запроса об оплате» Nemo проставляет счету статус оплачено и предоставляет клиенту услугу. При этом никаких проверок не производится.
! Проверка таймлимитов рекомендуется для избежания ситуации изменения тарифа до момента получения «запроса об оплате». Тем не менее эта мера предосторожности не гарантирует простановку статуса "оплачено" и успешную выписку билета до момента изменения параметров заказа, т.к. между моментом получения "запроса о состоянии счета" и моментом получения "запроса об оплате»" может пройти больше времени, чем указано в настройке «Таймлимит» или параметры заказа могут измениться по независящим от таймлимита причинам.
Бонусная карта "Кукуруза"
При выборе данного способа оплаты часть стоимости заказа может быть оплачена бонусными баллами карты «Кукуруза». При этом на странице с информацией о бронировании можно увидеть суммы, оплаченные баллами и деньгами.
