Оплата Цифровым рублем через редирект

Платежный сервис Роутер поддерживает оплату Цифровым рублем с платежной страницы.

Чтобы включить возможность принимать платежи Цифровым рублем, выбрать целевые банки и настроить критерии маршрутизации, обратитесь в службу технической поддержки. Текущие настройки можно узнать, отправив запрос /settings/getRouterParams.do.

Включение способа оплаты Цифровым рублем на платежной странице

Чтобы оплата Цифровым рублем была доступна на платежной странице Платежного сервиса, необходимо в запросе регистрации заказа указать в параметре allowedPaymentWays среди прочих способов оплаты значение "DR_C2B". Ниже приведен пример запроса.

1. Клиент инициирует покупку товара или услуги на сайте Партнера.

2. Партнер отправляет в Платежный сервис Роутер запрос на регистрацию заказа:

   • register.do для одностадийной оплаты, или

   • registerPreAuth.do для двухстадийной оплаты.

     Подробнее об этих видах оплаты см. в разделе Двухстадийные платежи.

   Для того чтобы на платежной странице появилась кнопка для оплаты Цифровым рублем, при регистрации заказа в параметре allowedPaymentWays среди прочих способов оплаты должен быть добавлен способ оплаты "DR_C2B".

   Пример запроса:

   curl -X POST 'https://api.router.rbsuat.com/v2/register.do' -H 'Content-Type: application/json' \
   --data-raw '{
       "orderNumber": "order_123508",
       "amount": 77777,
       "currency": "643",
       "language": "ru",
       "returnUrl": "https://mybestmerchantreturnurl.com/success",
       "failUrl": "https://mybestmerchantreturnurl.com/fail",
       "userName": "test_user",
       "password": "test_user_password",
       "allowedPaymentWays": [
           "DR_C2B",
           "SBP_C2B"
       ]
   }'

   curl -X POST 'https://api.router.rbsuat.com/v1/register.do' -H 'Content-Type: application/json' \
   --data-raw '{
       "orderNumber": "order_123508",
       "amount": 77777,
       "currency": "643",
       "language": "ru",
       "returnUrl": "https://mybestmerchantreturnurl.com/success",
       "failUrl": "https://mybestmerchantreturnurl.com/fail",
       "userName": "test_user",
       "password": "test_user_password",
       "allowedPaymentWays": [
           "DR_C2B",
           "SBP_C2B"
       ]
   }'

3. Платежный сервис Роутер проверяет данные Партнера и регистрирует заказ.

4. Платежный сервис Роутер передает Партнеру ссылку на платежную страницу.

   Пример ответа:

   {
       "errorCode": "0",
       "formUrl": "https://router.rbsuat.com/wl/payment.html?mdOrder=f9584546-2613-4a0d-896f-0194d243865f&language=ru",
       "orderId": "f9584546-2613-4a0d-896f-0194d243865f",
       "orderNumber": "order_123508"
   }

5. Партнер перенаправляет Клиента на платежную страницу.

6. Клиент переходит на платежную страницу.

Оплата Цифровым рублем

1. Клиент переходит на платежную страницу и выбирает платежный инструмент Цифровой рубль Банка России.

   

2. (Опция) При оплате с десктопа платежная страница запрашивает в Платежном сервисе QR код.

3. (Опция) При оплате с мобильного устройства платежная страница отправляет Клиенту виджет выбора банка.

4. Клиент выбирает банк, в котором открыт счет Клиента, с которого он хочет произвести оплату.

   • На мобильном устройстве Клиента должно быть установлено приложение выбранного банка. Переход на следующий шаг не произойдет, пока не будет выбран банк с установленным приложением.
   • В зависимости от того, какой банк выбрал Клиент, Роутер на своей стороне может выбрать наиболее подходящего эквайера. Например, если среди эквайеров Партнера имеется банк Клиента, то можно настроить правила маршрутизации таким образом, что Роутер выберет тот же банк-эквайер, что выбрал клиент. Таким образом, перевод средств происходит внутри одного банка, что уменьшает комиссию.
   

5. Платежная страница передает в Роутер информацию о выбранном банке.

6. Платежный сервис Роутер осуществляет выбор банка из тех, в котором у Партнера настроен прием платежей Цифровым рублем.

7. Платежный сервис Роутер отправляет в выбранный банк необходимые запросы для регистрации заказа.

8. Платежный сервис получает QR-код или ссылку для перенаправления Клиента.

9. (Опция) При оплате с десктопа Платежный сервис Роутер отправляет QR код на платежную страницу Клиента.

   

10. (Опция) При оплате с мобильного устройства Платежный сервис Роутер перенаправляет Клиента в приложение выбранного банка или на страницу онлайн-банка (в зависимости от настроек банка на стороне системы Цифрового рубля).

11. Платежная страница ожидает, пока Клиент оплатит заказ.

12. Клиент оплачивает заказ в мобильном приложении банка.

13. Мобильное приложение передает в Банк информацию об оплате.

Финальный статус заказа

1-4. Платежная страница периодически запрашивает статус оплаты в Платежном сервисе. После изменения статуса происходит перенаправление Клиента на финальную страницу в зависимости от результата платежа: в случае ошибки на failUrl, а в случае успешной оплаты на returnUrl. При этом к URL адресу будет добавлен query-параметр orderId=[идентификатора заказа в Платежном сервисе].

5. Финальная страница запрашивает в Платежном сервисе финальный статус операции методом getOrderStatusExtended.do.

6-8. Платежный сервис Роутер запрашивает в банке статус заказа и отправляет его Партнеру для отображения на финальной странице Клиента.