webapi/b2puser/sd-services/SDPayInSBPQRLink - Получение ссылки на перевод через СБП

Описание

HTTP‑метод: POST
URL: /webapi/b2puser/sd-services/SDPayInSBPQRLink/
Форма взаимодействия: Сервер-сервер
Формат тела запроса: application/x-www-form-urlencoded
Назначение: получение от ПЦ ссылки на выполнение перевода через СБП.

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

URL

URLPATH

https://b2p.wallet.kvell.group/webapi/b2puser/sd-services/SDPayInSBPQRLink/

/webapi/b2puser/sd-services/SDPayInSBPQRLink/

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

Поле	Тип	Обяз.	Описание
`sector`	`str`	✔	Уникальный идентификатор учетной записи ТСП в ПЦ.
`id`	`int`	✔	Уникальный идентификатор платежа (Заказа) в ПЦ.
`signature`	`str`	✔	Цифровая подпись. В формировании подписи участвуют параметры: sector, id, sd_ref, password в указанном порядке.
Необязательные параметры
`sd_ref`	`str`		Уникальный идентификатор Кубышки.
`get_token`	`int`		Запрос на предоставление СБП-токена в составе уведомления на url. Возможные значения: 0 (по умолчанию) — токен не возвращать; 1 — вернуть СБП-токен.

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

Элемент	Тип	Описание
`order_id`	`int`	Идентификатор заказа в ПЦ.
`qrcode_ref`	`str`	Референс QR-кода.
`state`	`str`	Статус операции (PENDING, REJECTED).
`code`	`str`	Код ответа.
`message`	`str`	Сообщение.
`qroper_ref`	`str`	Референс операции QR.
`qrcId`	`str`	Идентификатор QR-кода.
`payload`	`str`	URL для перевода через СБП.
`qr_img`	`str`	Байтовое представление картинки с QR-кодом в виде строки base64.

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

Успех (200)Отказ от НСПК (200)Ошибка валидации (400)

<?xml version="1.0" encoding="UTF-8"?>
<SDPayInSBPQRLink>
    <order_id>1234</order_id>
    <qrcode_ref>1234</qrcode_ref>
    <state>PENDING</state>
    <code>1</code>
    <message>Successful financial transaction</message>
    <qroper_ref>1234</qroper_ref>
    <qrcId>AD10005F3ED9GCLM94U</qrcId>
    <payload>https://qr.nspk.ru/</payload>
    <qr_img>байтовое представление картинки с QR-кодом в виде строки base64</qr_img>
</SDPayInSBPQRLink>

<?xml version="1.0" encoding="UTF-8"?>
<SDPayInSBPQRLink>
    <order_id>1001123</order_id>
    <qrcode_ref>10004</qrcode_ref>
    <state>REJECTED</state>
    <code>RQ03001</code>
    <message>Wrong message format</message>
</SDPayInSBPQRLink>

<?xml version="1.0" encoding="UTF-8"?>
<error>
    <description>Sector not found</description>
    <code>105</code>
</error>

Примечания

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