webapi/b2puser/sd-services/SDPayInSBPByToken - Пополнение Кубышки через СБП-токен

Описание

HTTP‑метод: POST
URL: /webapi/b2puser/sd-services/SDPayInSBPByToken/
Форма взаимодействия: Сервер-сервер
Формат тела запроса: application/x-www-form-urlencoded
Назначение: пополнение Кубышки через безакцептное списание денежных средств с использованием ранее выпущенного СБП-токена.

URL

URLPATH

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

/webapi/b2puser/sd-services/SDPayInSBPByToken/

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

Поле	Тип	Обяз.	Описание
`sector`	`str`	✔	Уникальный идентификатор учетной записи ТСП в ПЦ.
`id`	`int`	✔	Уникальный идентификатор платежа (Заказа) в ПЦ.
`token`	`str`	✔	СБП-токен, полученный ТСП во время осуществления привязки через SDPayInSBP или SDPayInSBPQRLink.
`signature`	`str`	✔	Цифровая подпись. В формировании подписи участвуют параметры: sector, id, token, sd_ref, unique_key, password в указанном порядке.
Необязательные параметры
`sd_ref`	`str`		Уникальный идентификатор Кубышки.
`unique_key`	`str`		Ключ уникальности запроса. Генерируется на стороне ТСП. При получении ключа ПЦ выполняет проверку на наличие дубликата среди обрабатываемых запросов и созданных операций. Формат: допустимы цифры [0-9], латинские буквы [a-zA-Z], дефис и нижнее подчеркивание [-_]. Предупреждение: возможность использования ключа уникальности осуществляется по согласованию с Оператором.

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

Элемент	Тип	Описание
`order_id`	`int`	Идентификатор заказа в ПЦ.
`order_state`	`str`	Статус заказа
`reference`	`str`	Номер заказа на стороне ТСП.
`id`	`int`	Идентификатор операции в ПЦ
`date`	`datetime`	Дата и время совершения операции в ПЦ (`YYYY.MM.DD HH:MM:SS`).
`type`	`str`	Тип операции.
`state`	`str`	Статус операции
`amount`	`int`	Сумма заказа в минимальных единицах валюты (для RUB — копейки).
`fee`	`int`	Сумма комиссии в минимальных единицах валюты (для RUB — копейки).
`curency`	`int`	Код валюты по ISO 4217 (643 — RUB, 978 — EUR, 840 — USD).
`approval_code`	`str`	Код авторизации, полученный в Банке на данную операцию.
`unique_key`	`str`	Ключ уникальности
`sd_ref`	`str`	Уникальный идентификатор Кубышки.
`sector_id`	`str`	Уникальный идентификатор учётной записи ТСП в ПЦ.
`ofd_link`	`str`	Ссылка на фискальный чек.
`payload`	`str`	НСПК ссылка для проведения оплаты.
`qrcId`	`str`	Идентификатор транзакции.
`sbpTranId`	`str`	Идентификатор транзакции СБП.
`payerId`	`str`	Идентификатор плательщика.
`signature`	`str`	Цифровая подпись сообщения. В подписи участвуют значения всех тегов в порядке их следования и пароль для расчёта цифровой подписи, предоставляемый ТСП после его регистрации в ПЦ.

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

Успех (200)Ошибка валидации (400)

<?xml version="1.0" encoding="UTF-8"?>
<operation>
    <order_id>1234</order_id>
    <order_state>COMPLETED</order_state>
    <reference>test</reference>
    <id>5587788</id>
    <date>2024.01.28 00:23:19</date>
    <type>PURCHASE_BY_QR</type>
    <state>APPROVED</state>
    <amount>10000</amount>
    <fee>0</fee>
    <currency>643</currency>
    <unique_key>test2</unique_key>
    <sd_ref>zzz</sd_ref>
    <sector_id>823</sector_id>
    <ps>2</ps>
    <ofd_link>https://ofd-link.ru/ofd/getReceipt?sector=123325425345&amp;operationId=141&amp;signature=ZjY1YTlkM2Y4NGE3N2M2NTVhYzFlZmVkMTgzYmI0YTY1MTAxYjI4ZGMwMTZkNTNiMDFjNmU1N2IwZjBiZDlmZQ%3D%3D</ofd_link>
    <payload>https://qr.nspk.ru/AD10005F3ED994U?type=02&amp;bank=100030&amp;sum=1000&amp;cur=RUB&amp;crc=A479</payload>
    <qrcId>AD10005F3ED9GCLM94U</qrcId>
    <sbpTranId>asdghwerydfhsjkdhfuwoijkk</sbpTranId>
    <payerId>*********0000</payerId>
    <signature>MTlhN2JhMDFmOWJlYjUwMGQyZGM4Yzc5NjA1OGRmZjY</signature>
</operation>

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

Примечания

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