Оплата SberPay через редирект

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

До появления поддержки этого способа оплаты другими банками-эквайерами, оплата с помощью SberPay всегда производится в Сбербанк. Банк для SberPay должен быть указан в настройках Партнера в Платежном сервисе. Чтобы изменить настройки, обратитесь в службу поддержки. Текущие настройки можно узнать, отправив запрос /settings/getRouterParams.do.

Схема интеграции

Включение SberPay на платежной странице

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

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

2. Партнер отправляет в Платежный сервис Роутер запрос на регистрацию заказа: register.do для одностадийной оплаты или registerPreAuth.do для двухстадийной оплаты. Подробнее об этих видах оплаты см. в разделе Двухстадийные платежи.

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

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

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

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. Клиент выбирает способ оплаты SberPay.

7. Если при регистрации заказа в Платежном сервисе Партнер не передал телефон Клиента (параметр phone), у Клиента запрашивается номер телефона.

Оплата SberPay

8. Платежная страница отправляет запрос на регистрацию операции в мобильном приложении Сбербанк Онлайн (СБОЛ).

9. Платежный сервис Роутер отправляет в Банк запросы на регистрацию заказа в СБОЛ.

10. Выполняются необходимые операции для создания заказа в СБОЛ. В приложение СБОЛ поступает уведомление о заказе.

11. Банк возвращает результат регистрации заказа в СБОЛ.

12. Платежный сервис Роутер возвращает платежной странице результат регистрации операции в СБОЛ.

13. Платежная страница отображает экран инструкций и ожидания оплаты через СБОЛ.

14. Клиент оплачивает заказа через СБОЛ.

15. СБОЛ передает данные об оплате в Банк.

16. С некоторой периодичностью платежная страница опрашивает у Платежного сервиса статус оплаты. В это время Клиент выполняет оплату через СБОЛ на своем устройстве.

17. Платежный сервис Роутер перенаправляет запрос в целевой Банк.

18. Платежный сервис Роутер получает статус оплаты из целевого Банка.

19. Платежный сервис Роутер возвращает статус оплаты платежной странице. При наличии ошибки она отображается на платежной странице.

20. Когда в статусе оплаты возвращается URL финальной страницы, платежная страница перенаправляет Клиента на этот URL. В зависимости от результата платежа это либо ссылка на failUrl, либо на returnUrl.

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

21. Клиент (финальная страница) отправляет в Платежный сервис Роутер запрос для получения финального статуса заказа getOrderStatusExtended.do.

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