api/wallet/pay-in-sbp-qr-link - Получение ссылки на перевод через СБП

HTTP‑метод: POST
URL: /api/wallet/pay-in-sbp-qr-link
Форма взаимодействия: Сервер-сервер
Формат тела запроса: application/json
Назначение: получение от ПЦ ссылки на выполнение перевода через СБП.

Сервис работает только с предварительно зарегистрированным Заказом (api/register).

URL

URLPATH

https://gateway-docs.wallet.kvell.group/api/wallet/pay-in-sbp-qr-link

/api/wallet/pay-in-sbp-qr-link

Структура запроса

Поле	Тип	Обяз.	Описание
`terminal`	`str`	✔	Уникальный идентификатор учетной записи ТСП в ПЦ.
`order_id`	`int`	✔	Уникальный идентификатор предварительно зарегистрированного Заказа в ПЦ, полученный по результатам `api/register`.
`signature`	`str`	✔	Цифровая подпись запроса. Алгоритм расчёта — см. Формирование подписи.
Необязательные параметры
`receiver`	`object`		Данные Кошелька-получателя. Значимое поле (см. структуру payer/receiver): `wallet_public_id`.
`is_get_token`	`int`		Запрос на предоставление токена использованной в операции платёжной карты в составе уведомления на `url`. Возможные значения: `0` (по умолчанию) — не возвращать; `1` — вернуть токен.

Структура ответа

Поле	Тип	Обяз.	Описание
`order_id`	`int`	✔	Идентификатор заказа в ПЦ. Пример: `1234`
`qrcode_ref`	`int`		Референс QR-кода. Пример: `1234`
`tx_status`	`str`	✔	Статус операции (`PENDING`, `REJECTED`, ...). Пример: `PENDING`
`tx_reason_code`	`int`	✔	Код ответа на операцию. Пример: `1`
`message`	`str`		Сообщение. Пример: `Successful financial transaction`
`qroper_ref`	`int`		Референс операции QR. Пример: `1234`
`qrc_id`	`str`		Идентификатор QR-кода. Пример: `AD10005F3ED9GCLM94U`
`qr_link`	`str`	✔	URL для перевода через СБП. Пример: `https://qr.nspk.ru/`
`qr_img`	`str`		Байтовое представление картинки с QR-кодом в виде строки base64.

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

Успех (200)Отказ от НСПК (200)Пример ошибки (404)

{
    "order_id": 1234,
    "qrcode_ref": 1234,
    "tx_status": "PENDING",
    "tx_reason_code": 1,
    "message": "Successful financial transaction",
    "qroper_ref": 1234,
    "qrc_id": "AD10005F3ED9GCLM94U",
    "qr_link": "https://qr.nspk.ru/",
    "qr_img": "<base64-строка с изображением QR-кода>"
}

{
    "order_id": 1001123,
    "qrcode_ref": 10004,
    "tx_status": "REJECTED",
    "tx_reason_code": null,
    "message": "Wrong message format"
}

{
    "error_code": "TERMINAL_NOT_FOUND",
    "technical_message": "Terminal not found",
    "timestamp": 1751976000,
    "details": null,
    "request_id": "b3b3c1f0-4b3a-4f3a-9b1a-1234567890ab"
}

Примечания

При получении запроса ПЦ проверяет:
Правильность расчета подписи и корректность параметров запроса;
Статус Заказа должен быть REGISTERED, иначе возвращается ошибка «Неверный статус заказа»;
Если в запросе указан receiver.wallet_public_id, который ранее уже был зарегистрирован для терминала, зачисление средств по операции, выполненной с использованием предоставленной ссылки, будет проводиться на баланс этого ранее зарегистрированного Кошелька. Иначе будет создан и пополнен новый Кошелёк.
У этого ответа нет отдельного поля order_status — статус самой SBP-операции передаётся только через tx_status.