Начальный шаг выбранным способом

POST /Cards/Sbp/create

Токен едет заголовком Authorization: Bearer <token> — так требует документ виджета (сам адрес iframe несёт его параметром ?token=). ?method= выбирает sbp, alfapay или sberpay. Начальный шаг зависит от условий подписки, а не от способа: первый период оплачивается вместе с привязкой; если BillingStartTimeUtc в будущем, первая оплата отложена и доступен только sbp — привязка без списания. T-Pay временно отключён (400 METHOD_UNAVAILABLE).

Идемпотентно: повтор тем же способом отдаёт уже начатую операцию — повторной платной авторизации нет. Другой способ для начатой операции отклоняется 409 METHOD_LOCKED; в ответе can_change_method: false.

Токен проверяется до обращения к БД, неизвестный даёт 401, а не 404: иначе по ответам перебираются идентификаторы сессий.

⚠️ Тела — контракт песочницы (документ описывает только адреса и смысл). binds_account: true — привязка происходит при любом способе; is_first_payment — оплачивается ли первый период в этом шаге. sandbox_confirm_url существует только в песочнице.

Sandbox

Пример ответа


{
  "success": true,
  "data": {
    "reference": "1000000001",
    "method": "sbp",
    "screen": "qr",
    "deeplink_url": "https://subs-sandbox.digitalspb.com/Cards/TB/0d0f3c58-9b1e-4a77-9a0c-000000000003/sbp/confirm",
    "qr_payload": "https://subs-sandbox.digitalspb.com/Cards/TB/0d0f3c58-9b1e-4a77-9a0c-000000000003/sbp/confirm",
    "price": {
      "amount": "10.00",
      "currency": "RUB",
      "vat_included": true
    },
    "merchant_order_id": "ORDER-000000001",
    "expires_at": "2026-09-21T12:00:00Z",
    "poll_interval_seconds": 5,
    "sandbox_confirm_url": "https://subs-sandbox.digitalspb.com/Cards/TB/0d0f3c58-9b1e-4a77-9a0c-000000000003/sbp/confirm",
    "binds_account": true,
    "is_first_payment": true,
    "can_change_method": false
  }
}

Коды ответов

Код	Описание
`201`	Данные QR
`401`	Токен не подошёл
`409`	Операция уже начата другим способом

Начальный шаг выбранным способом

Sandbox

Prod

Коды ответов