webapi/b2puser/sd-services/SDPurchase - Перечисление средств со счета Кубышки

Описание

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

В случае затруднений с заполнением полей для платежа по свободным реквизитам, ориентируйтесь на правила заполнения платежного поручения. Названия параметров этого блока идентичны названиям полей платежного поручения.

Предупреждение: перед выполнением запроса рекомендуется зарегистрировать в ПЦ Заказ с описанием всех деталей предстоящего платежа. Сделайте это отдельным запросом webapi/Register.

URL

URLPATH

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

/webapi/b2puser/sd-services/SDPurchase/

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

Поле	Тип	Обяз.	Описание
`sector`	`str`	✔	Уникальный идентификатор учетной записи ТСП в ПЦ.
`sd_ref`	`str`	✔	Уникальный идентификатор Кубышки.
`signature`	`str`	✔	Цифровая подпись. В формировании подписи участвуют параметры (если они использованы в запросе): sector, id, amount, currency, sd_ref, unique_key, password в указанном порядке.
Условно-обязательные параметры
`amount`	`int`		Сумма операции в минимальных единицах валюты. Для рублей — копейки. Если указан id, значение amount берётся из заказа.
`currency`	`int`		Код валюты по ISO4217 (643 для RUB; 978 для EUR; 840 для USD). Если указан id, значение currency берётся из заказа.
`description`	`str`		Описание перевода. Если указан id, значение description берётся из заказа.
Необязательные параметры
`reference`	`str`		Номер Заказа на стороне ТСП (в ИС ТСП).
`id`	`int`		Уникальный идентификатор предварительно зарегистрированного Заказа в ПЦ.
`unique_key`	`str`		Ключ уникальности запроса. Генерируется на стороне ТСП. При получении ключа ПЦ выполняет проверку на наличие дубликата среди обрабатываемых запросов и созданных операций. Формат: допустимы цифры [0-9], латинские буквы [a-zA-Z], дефис и нижнее подчеркивание [-_]. Предупреждение: возможность использования ключа уникальности осуществляется по согласованию с Оператором.
`email`	`str`		Адрес электронной почты Плательщика. Если в запросе передан параметр id, данное значение email игнорируется (при наличии берется email из заказа).
`phone`	`str`		Телефон Плательщика.
`country`	`str`		Двухсимвольный код страны Плательщика в соответствии с ISO 3166-1.
`region`	`str`		Название региона (области, края) Плательщика. Для США указывается название штата.
`bank_name`	`str`		Наименование банка Плательщика.
`first_name`	`str`		Имя Плательщика.
`last_name`	`str`		Фамилия Плательщика.
`patronymic`	`str`		Отчество Плательщика.
`fio`	`str`		Фамилия Имя Отчество получателя денежных средств.
`acc_number`	`str`		Номер счета получателя денежных средств.
`contract`	`str`		Номер договора получателя денежных средств.
`receipt_type`	`int`		Номер шаблона уведомления, отправляемого на email Плательщику. По умолчанию используется первый (стандартный) шаблон. Предупреждение: применяется по согласованию с Оператором, только если бизнес-требования ТСП подразумевают использование разных шаблонов уведомлений.
`P008-1`	`str`		Наименование Плательщика.
`P008-2`	`str`		Адрес Плательщика.
`P014`	`int`		БИК получателя (ровно 9 цифр).
`P015`	`int`		Корр. счёт банка получателя. Номер банковского счёта, входящего в состав единого казначейского счёта (ровно 20 цифр).
`P016`	`str`		Наименование Получателя.
`P017`	`int`		Счет получателя (ровно 20 цифр).
`P018`	`int`		Вид операции. Возможные значения: 01 — платежное поручение; 06 — инкассовое поручение; 02 — платежное требование.
`P020`	`int`		Назначение платежа. Заполняется при указании банка. Возможные значения: 1 — Заработная плата, премии, больничные листы и дивиденды сотрудникам (возможно удержание не более 50%); 2 — Периодические выплаты, алименты (удержания отсутствуют); 3 — Компенсация вреда здоровью (удержание только на оплату алиментов); 4 — Разовые выплаты: командировочные, выплаты на погребение (удержание 0%); 5 — Разовый доход (удержания в пользу алиментов, возмещения вреда здоровью или потери кормильца).
`P021`	`int`		Очередность платежа. Возможные значения: 1 — Алименты и платежи по судебным решениям о возмещении вреда жизни и здоровью; 2 — Авторские права, заработная плата и выходные пособия сотрудникам; 3 — Заработная плата, налоговые обязательства и погашение задолженностей по налогам и взносам в фонды; 4 — Средства по остальным исполнительным документам судебных приставов; 5 — Средства прочим контрагентам в соответствии с порядком очерёдности.
`P022`	`int`		УИН (20 или 25 цифр). Если отсутствует — проставьте 0.
`P024`	`str`		Назначение платежа.
`P060`	`int`		ИНН Плательщика (10 или 12 цифр). Если отсутствует — проставьте 0.
`P061`	`int`		ИНН Получателя (10 или 12 цифр). Если отсутствует — проставьте 0.
`P101`	`int`		Статус Плательщика.
`P102`	`int`		КПП Плательщика (9 цифр). Если отсутствует — проставьте 0.
`P103`	`int`		КПП Получателя (9 цифр). Если отсутствует — проставьте 0.
`P104`	`int`		КБК Получателя.
`P105`	`int`		ОКТМО (8 или 11 цифр).
`P106`	`str`		Основание платежа.
`P107`	`str`		Налоговый период.
`P108`	`str`		Номер документа, который является основанием платежа, либо 0.
`P109`	`str`		Дата документа (формат yyyy.MM.dd). Если отсутствует — проставьте 0.
`P110`	`str`		Тип документа.

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

Элемент	Тип	Описание
`order_id`	`int`	Идентификатор заказа в ПЦ.
`order_state`	`str`	Статус заказа
`reference`	`str`	Номер заказа на стороне ТСП.
`id`	`int`	Идентификатор операции в ПЦ
`date`	`datetime`	Дата и время совершения операции в ПЦ (`YYYY.MM.DD HH:MM:SS`).
`type`	`str`	Тип операции.
`state`	`str`	Статус операции
`reason_code`	`int`	Код ответа на операцию ПЦ
`message`	`str`	Краткое описание кода ответа на операцию ПЦ
`amount`	`int`	Сумма заказа в минимальных единицах валюты (для RUB — копейки).
`curency`	`int`	Код валюты по ISO 4217 (643 — RUB, 978 — EUR, 840 — USD).
`approval_code`	`str`	Код авторизации, полученный в Банке на данную операцию.
`sector_id`	`str`	Уникальный идентификатор учётной записи ТСП в ПЦ.
`bin_issuer`	`str`	Идентификационный номер банка-Эмитента.
`expdate`	`str`	Дата истечения срока действия карты.
`iso`	`str`	Код валюты по ISO 4217 (643 — RUB, 978 — EUR, 840 — USD).
`ps`	`str`	Платёжная система. Возможные значения параметра: 0 (по умолчанию) — не установлена; 1 — Visa; 2 — MasterCard; 8 — Maestro; 10 – MIR; 11 — СБП; 12 — Uzcard; 13 — JCB; 14 — оплата со счёта мобильного телефона; 16 — HUMO; 17 — CHUP.
`rrn`	`str`	RRN банковской транзакции.
`terminal_id`	`str`	Идентификатор банковского терминала.
`ofd_state`	`str`	Статус обработки платежа онлайн-кассой.
`signature`	`str`	Цифровая подпись сообщения. В подписи участвуют значения всех тегов в порядке их следования и пароль для расчёта цифровой подписи, предоставляемый ТСП после его регистрации в ПЦ.

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

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

<?xml version="1.0" encoding="UTF-8"?>
<operation>
    <order_id>1009982</order_id>
    <order_state>REGISTERED</order_state>
    <reference>test</reference>
    <id>5587788</id>
    <date>2024.01.28 00:23:19</date>
    <type>P2PTRANSFER</type>
    <state>APPROVED</state>
    <reason_code>1</reason_code>
    <message>Successful financial transaction</message>
    <amount>100</amount>
    <currency>643</currency>
    <approval_code>122004</approval_code>
    <sector_id>893</sector_id>
    <bin_issuer>JOINT STOCK COMMERCIAL BANK MOSCOW INDUSTRIAL BANK</bin_issuer>
    <expdate>10/2024</expdate>
    <iso>643</iso>
    <ps>2</ps>
    <rrn>33147812</rrn>
    <terminal_id>POS_1</terminal_id>
    <ofd_state>APPROVED</ofd_state>
    <signature>Y2Y0ZjllMGI3NDc0YjhjYTU2Yzk1ZTg1NGMxMmI1MDQ=</signature>
</operation>

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

<?xml version="1.0" encoding="UTF-8"?>
<error>
    <duplicated_operation>
        <unique_key>test2</unique_key>
        <id>449800</id>
        <type>PURCHASE</type>
        <state>APPROVED</state>
        <order_id>480413</order_id>
        <reference>721716fc-6837-4dbc-8308-37de445c30f0</reference>
    </duplicated_operation>
    <code>299</code>
    <description>unique_key is not unique</description>
    <signature>OWY5YTY5YjljOTFhNTNkOGQyMDQ0YTY4ZGUxOTBhM2I=</signature>
</error>

Примечания

При получении запроса ПЦ проверяет:
Если в запросе передан параметр unique_key, то ПЦ проверяет запрос на наличие дубля;
Правильность расчета подписи и корректность параметров запроса;
sd_ref должен быть ранее зарегистрирован для данного сектора;
Сумма параметров amount + fee, указанных в запросе, не должна превышать сумму текущего баланса Кубышки, идентификатор которой указан в параметре sd_ref.
По окончании работы сервиса:
В случае успешной операции заказ переводится в статус COMPLETED;
Доступный баланс Кубышки sd_ref уменьшается на сумму amount + fee.