ym88659208ym87991671
SberPay SDK Web: Стандартный режим оплаты | Документация для разработчиков

Стандартный режим оплаты

Обновлено 12 мая 2026

Сценарий отличается в зависимости от того, в каком канале происходит открытие страницы: для mWeb - это редирект в отдельный таб, для desktop – шторка iFrame для всех шагов.

Процесс авторизации

Авторизация в МП СБОЛ

Авторизация в mWeb

Для пользователей iOS устройств в сценарии mWeb реализована через поднятие deeplink (выполняется перебор версий МП СБОЛ для iOS). Авторизация на Android в сценарии mWeb реализована через поднятие deeplink на актуальную версию МП СБОЛ. Если на устройстве клиента отсутствует приложение или переход к нему невозможен, происходит авторизация по номеру телефона.

В случае если WebSDK SberPay не удалось запустить МП СБОЛ, авторизация пользователя осуществляется по номеру мобильного телефона. Пользователю отображается страница ввода номера телефона, номер не предзаполнен.

Авторизация в desktop

Авторизация в сценарии desktop для всех версий браузеров реализована через считывание QR-кода камерой МП СБОЛ:

QR-код на десктопе

Авторизация по номеру телефона

Партнер может запретить пользователю корректировать номер телефона, по которому осуществляется авторизация с помощью передачи на вход в библиотеку параметра isPhoneChangeDisabled=true. В данном случае страница ввода номера телефона пользователю не отображается.

Авторизация в mWeb

Если партнеру требуется принудительно провести авторизацию пользователя через ввод кода-подтверждения, отправленного по номеру телефона пользователя, требуется передать номер телефона в параметре phone на вход в библиотеку.

Вне зависимости от семейства ОС iOS или Android пользователю отображается страница ввода с предзаполненным номером телефона из параметра phone. При необходимости доступна возможность скорректировать номер телефона. Пользователь подтверждает личность через ввод кода-подтверждения, отправленного ему в СМС сообщении.

Ввод номера телефона mWeb
Ввод СМС-кода mWeb

Авторизация в desktop

Аналогично сценарию mWeb партнер может запросить принудительную авторизацию пользователя через ввод кода-подтверждения, отправленного по номеру телефона пользователя в сценарии desktop. Для запуска сценария требуется передать номер телефона в параметре phone на вход в библиотеку.

Пользователю отображается страница ввода с предзаполненным номером телефона из параметра phone. При необходимости доступна возможность скорректировать номер телефона. Пользователь подтверждает личность через ввод кода-подтверждения, отправленного ему в СМС сообщении.

Ввод номера телефона mWeb
Ввод СМС-кода mWeb

Выбор карты

WebSDK SberPay автоматически определяет приоритетную карту для оплаты. Карты отображается на главном экране после авторизации.

Главный экран после авторизации для канала mWeb:

Главный экран мобильной версии

Главный экран после авторизации для канала desktop:

Главный экран десктопной версии

При желании пользователь может выбрать другую карту из списка доступных. Библиотека анализирует доступный баланс на картах пользователя и не даст провести оплату, если средств не достаточно.

Экран выбора карты

Карта, которой была произведена оплата помечается, как приоритетная, для следующих оплат.

Процесс оплаты

Если покупатель совершает вторую и далее покупку с устройства, где уже была совершена оплата, и сумма покупки меньше 10 тыс.руб., то клиенту не нужно авторизовываться для совершения оплаты. Если сумма при этом больше 10 тыс.руб., то клиенту для подтверждения оплаты может потребоваться ввести СМС-код, отправленный ему на номер телефона:

Экран ввода СМС-кода для канала mWeb:

Ввод СМС-кода mWeb

Экран ввода СМС-кода для desktop:

Ввод СМС-кода desktop

Завершение сценария

После выбора карты для списания и завершения оплаты покупки происходит отображение финишного экрана внутри WebSDK. Для настройки отображения финишного экрана партнер на вход в библиотеку может передать признак isFinishPage и параметр finishPageTimeOut.

Если признак isFinishPage=false финишный экран внутри WebSDK не отображается, сразу после совершения оплаты осуществляется переход по sberpay.backurl. Если признак принимает значение true или не передан финишный экран отображается.

Параметр finishPageTimeOut задает время (в секундах), которое будет отображаться финишный экран внутри WebSDK до перехода по sberpay.backurl. Если параметр не передан и признак isFinishPage=false финишный экран отображается в течении 5 секунд. Если передан finishPageTimeOut=0 финишный экран внутри WebSDK не отображается даже если передан признак isFinishPage=true.

После отображения финального статуса внутри WebSDK происходит возврат пользователя по backurl, указанному в запросе на открытие виджета (widget.open(params)). В конце ссылки указывается статус операции путем передачи дополнительного параметра &state=@{BankResultState}:

  • success – оплата успешно прошла, требуется отправить на успешный экран
  • return – в сценарии произошла ошибка, требуется отправить на неуспешный экран.
  • cancel – клиент нажал на кнопку «Отменить». Актуально только для мобильной версии. В десктопной версии виджет закрывается, промис разрешается со значением 'cancel'.

Также требуется передавать аналогичное значение sberpay.backurl в запросе на регистрацию заказа.

Заметили ошибку?

Выделите текст и нажмите Ctrl + Enter, чтобы сообщить нам о ней

ПАО Сбербанк использует cookie для персонализации сервисов и удобства пользователей. Вы можете запретить сохранение cookie в настройках своего браузера.