Виджет оплаты подписок в песочнице

Виджет оплаты подписок работает в песочнице так же, как в бою: те же embed.js, mount() / open(), способы оплаты, параметры methods и webview, события и маршрут собственных кнопок. Полное описание параметров — в гайде. Здесь — что подставить в песочнице и как довести начальный шаг до результата без настоящего банка.

Что нужно

Шаг 1. Создать подписку

Подписка создаётся на сервере партнёра — тем же CreateSubscription с CustomerType=Card, что в разделе Подписка картой и СБП. Секрет проекта и подпись в браузер не попадают.

<Request>
  <SubscriptionProjectID>2001</SubscriptionProjectID>
  <CustomerType>Card</CustomerType>
  <CustomerId>12345</CustomerId>
  <Now>20260625120000</Now>
  <Signature>d2f36558ca5455be...</Signature>
</Request>

В ответе — AuthorizeUrl и SubscriptionStatus=Pending. Токен для виджета лежит внутри AuthorizeUrl — 32 шестнадцатеричных символа.

Набор способов зависит от условий подписки (§6.8 гайда):

Шаг 2. Встроить виджет

<div id="bind"></div>
<script src="https://subs-sandbox.digitalspb.com/Cards/Sbp/embed.js"></script>
<script>
  SbpWidget.mount('#bind', {
    token: '8c0c8870d6fb4ee8a995ae183a44b928',   // из AuthorizeUrl ответа CreateSubscription
    methods: ['sbp', 'sberpay'],                 // необязательно: сузить набор способов
    onSuccess: function () { location.href = '/subscribed'; },
    onFail:    function () {},
    onExpired: function () {},
    onError:   function (e) { console.log(e.message, e.code); }
  });
</script>

Счёта здесь нет, поэтому invoiceId не передаётся — виджет адресует сессию подписки токеном. Режим модального окна — SbpWidget.open() с теми же параметрами без селектора. webview: true включает режим WebView, как в бою.

Шаг 3. Подтвердить начальный шаг

Настоящих банков в песочнице нет, поэтому подтверждение заменено симуляцией:

Что происходит дальше:

1. Виджет опрашивает состояние раз в 5 секунд и присылает success — сработает onSuccess.
2. Подписка переходит в Active, партнёру уходит коллбек EventType=APPROVED — первый коллбек песочница отправляет с задержкой 15 секунд.
3. Отдельного уведомления о первом списании песочница не шлёт: после успешного начального шага приходит только APPROVED. Чтобы увидеть цикл списаний и уведомления о них, его включают блоком <TestInfo> — см. Хуки песочницы: Списания. Без него придут только уведомления об активации, отказе и отмене.

Свои кнопки — redirect-маршрут

Маршрут из §6.12 гайда в песочнице тоже работает:

GET https://subs-sandbox.digitalspb.com/Cards/Sbp/pay?token={token}&method=sberpay

alfapay и sberpay уводят на имитацию приложения банка, sbp — на экран виджета без выбора способа. Неизвестный или недоступный для подписки способ, в том числе tpay, даёт 400 HTML-страницей.

Список способов без создания платежа — GET https://subs-sandbox.digitalspb.com/Cards/Sbp/methods с заголовком Authorization: Bearer {token}.

Что проверить кроме успешного начального шага

Отличия от боя