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

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

Что нужно

Шаг 1. Создать счёт

Счёт создаётся на сервере мерчанта — тем же CreateInvoice, что в Сценарии: карта. Креды и подпись в браузер не попадают.

Токен отдаётся только карточной ветке — клиенту UndefinedBankCardCustomer (в JSON undefined_bank_card) или BankCardCustomer. У DCB-счёта по номеру телефона виджета нет.

{
  "customer": {
    "type": "undefined_bank_card",
    "source": "my_source",
    "country": "RU",
    "merchant_customer_id": "user_123"
  },
  "order": {
    "merchant_order_id": "ORDER-001",
    "price": { "amount": "99.00", "currency": "RUB", "vat_included": true }
  }
}

Из ответа виджету нужны идентификатор счёта и токен: authorization.token в JSON, AuthorizationInfo.AuthorizationToken в XML.

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

<div id="pay"></div>
<script src="https://pay-sandbox.digitalspb.com/Card/Sbp/embed.js"></script>
<script>
  SbpWidget.mount('#pay', {
    invoiceId: 'A1B2C3...',   // из ответа CreateInvoice
    token: 'eyJ...',          // authorization.token / AuthorizationToken оттуда же
    lang: 'ru',               // необязательно: страницы песочницы двуязычные, ru или en
    onSuccess: function () { location.href = '/thanks'; },
    onFail:    function () {},
    onExpired: function () {},
    onError:   function (e) { console.log(e.code, e.message); }
  });
</script>

Режим модального окна — SbpWidget.open() с теми же параметрами без селектора. Без embed.js виджет открывается ссылкой — например, в WebView:

GET https://pay-sandbox.digitalspb.com/Card/Sbp/widget.html?invoiceId={invoiceId}&t={token}&lang=en

Токен передаётся параметром t; прежнее имя token песочница тоже принимает.

Шаг 3. Довести оплату до результата

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

Виджет опрашивает статус раз в 5 секунд и после оплаты присылает событие success — сработает onSuccess. Событие виджета — сигнал для интерфейса; состояние самого счёта проверяется как обычно: Статус инвойса, Коллбеки.

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

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

GET https://pay-sandbox.digitalspb.com/Card/Handlers/{invoiceId}/pay?method=alfapay&t={token}

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

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

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