webapi/b2puser/sd-services/SDPayOutSBPPrecheck - Проверка возможности СБП-выплаты

Описание

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

URL

URLPATH

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

/webapi/b2puser/sd-services/SDPayOutSBPPrecheck/

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

Поле	Тип	Обяз.	Описание
`sector`	`str`	✔	Уникальный идентификатор учетной записи ТСП в ПЦ.
`sd_ref`	`str`	✔	Уникальный идентификатор Кубышки. Если был объявлен, то ПЦ проверит, достаточно ли денежных средств для вывода с Кубышки на данный момент. Важно: Параметр должен быть передан при регистрации заказа (webapi/Register).
`signature`	`str`	✔	Цифровая подпись. В формировании подписи участвуют параметры (если они использованы в запросе): sector, id, token, phone, bank_id, amount, fee, currency, password в указанном порядке.
Условно-обязательные параметры
`phone`	`str`		Номер телефона Получателя. Указывать либо phone и bank_id, либо token.
`bank_id`	`str`		Уникальный идентификатор банка Получателя. Указывать либо phone и bank_id, либо token.
`token`	`str`		СБП-токен, полученный ТСП во время осуществления привязки. Чтобы осуществлять выплаты по такому СБП-токену, необходимо предварительно разово провести по нему операцию списания с последующей отменой. Указывать либо phone и bank_id, либо token.
Условно-обязательные параметры
`amount`	`int`		Сумма операции в минимальных единицах валюты. Для рублей — копейки. Если указан id, значение amount берётся из заказа. Заполнять все, если не указан id.
`currency`	`int`		Код валюты по ISO4217 (643 для RUB; 978 для EUR; 840 для USD). Если указан id, значение currency берётся из заказа.
`description`	`str`		Описание перевода. Если указан id, значение description берётся из заказа.
`fee`	`int`		Комиссия за осуществление выплаты в минимальных единицах валюты. Для рублей — копейки. Если указан id, значение fee берётся из заказа.
Необязательные параметры
`id`	`int`		Уникальный идентификатор платежа (Заказа) в ПЦ, полученный по результатам запроса webapi/Register.
`reference`	`str`		Номер перевода на стороне Площадки. Если не указан, значение формируется автоматически на стороне ПЦ. Если в запросе указан параметр id, значение параметра reference из запроса игнорируется.

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

Элемент	Тип	Описание
`precheck_id`	`str`	Идентификатор проверки.
`order_id`	`int`	Идентификатор заказа в ПЦ.
`amount`	`int`	Сумма операции.
`recipientBankId`	`str`	Идентификатор банка получателя.
`pam`	`str`	ФИО получателя.
`sd_ref`	`str`	Идентификатор Кубышки.
`signature`	`str`	Цифровая подпись ответа ПЦ.

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

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

<?xml version="1.0" encoding="UTF-8"?>
<SDPayOutSBPPrecheck>
    <precheck_id>730211959044920001</precheck_id>
    <order_id>471556</order_id>
    <amount>10000</amount>
    <recipientBankId>1crt88888881</recipientBankId>
    <pam>Петр Петрович П</pam>
    <sd_ref>471554</sd_ref>
    <signature>Y2Y0ZjllMGI3NDc0YjhjYTU2Yzk1ZTg1NGMxMmI1MDQ=</signature>
</SDPayOutSBPPrecheck>

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

Примечания

При получении запроса ПЦ проверяет:
Правильность расчета подписи и корректность параметров запроса;
Наличие разрешения сектора на использование сервиса;
Наличие на балансе Кубышки денежных средств в размере суммы значений параметров amount и fee, переданных в запросе или объявленных в Заказе с переданным id.