Вывод WebSDK на сайты партнеров

Обновлено 26 ноября 2024

Необходимо заменить на сайтах оплату через SberPay на обновленную реализацию WebSDK SberPay.
Создание e-com заказа партнером остается без изменений. При регистрации заказа SberPay значение bankInvoiceID необходимо передать в jsonParams в ответе партнеру на запрос регистрации e-com заказа, чтобы партнер смог его передать при вызове WebSDK. При этом отправлять push-уведомление не требуется (убрать вызов сервиса отправки push-уведомления CreateOrderSberPayAppRq ИЛИ paymentSberPay). Осуществлять редирект пользователя в МП СБОЛ по deeplink также не требуется.
WebSDK представляет собой готовую библиотеку, в рамках которой реализован сценарий авторизации клиента в СБОЛ, выбор карты для оплаты, подтверждение оплаты, получения статуса оплаты внутри WebSDK.
Сценарий оплаты отличается в зависимости от того, в каком канале происходит открытие страницы: для mWeb это редирект в отдельный таб, desktop – шторка iframe для всех шагов, кроме авторизации.
Для запуска WebSDK на вход необходимо передать bankinvoiceID и sberpay.backurl. При этом sberpay.backurl передаваемый на вход виджету должен совпадать с sberpay.backurl указанным при регистрации заказа на платежном шлюзе. В случае успеха оплаты внутри WebSDK клиент увидит статус успеха внутри WebSDK и будет перенаправлен по sberpay.backurl с параметром state=success. В случае неуспеха внутри WebSDK пользователь после статусного экрана WebSDK будет перенаправлен по sberpay.backurl с параметром state=return.
Функционал WebSDK требуется поддержать как для одностадийной оплаты, так и для двухстадийной.
Нативное встраивание WebSDK на витрину Партнера – при нажатии на кнопку SberPay Партнер самостоятельно регистрирует заказ, передавая параметр back2app. Шлюз регистрирует заказ в Банке, при этом не инициирует вызов сервиса CreateOrderSberPayAppRq ИЛИ paymentSberPay. По факту регистрации заказа Партнеру следует вернуть в ответе bankInvoiceId заказа.
В getOrderStatusExtended партнеру передавать paymentWay = SBERPAY_SDK_SB