webapi/b2puser/sd-services/SDPayInAlfaPay - Пополнение Кубышки через AlfaPay

Описание

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

URL

URLPATH

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

/webapi/b2puser/sd-services/SDPayInAlfaPay/

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

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

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

Элемент	Тип	Описание
`order_id`	`int`	Идентификатор заказа в ПЦ.
`order_state`	`str`	Статус заказа
`reference`	`str`	Номер заказа на стороне ТСП.
`operation_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).
`alfapay_url`	`str`	URL оплаты по AlfaPay.
`signature`	`str`	Цифровая подпись сообщения. В подписи участвуют значения всех тегов в порядке их следования и пароль для расчёта цифровой подписи, предоставляемый ТСП после его регистрации в ПЦ.

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

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

<?xml version="1.0" encoding="UTF-8"?>
<SDPayInAlfaPay>
    <order_id>1009982</order_id>
    <order_state>REGISTERED</order_state>
    <reference>test</reference>
    <operation_id>5587788</operation_id>
    <date>2024.01.28 00:23:19</date>
    <type>P2PTRANSFER</type>
    <state>PENDING</state>
    <amount>50000</amount>
    <currency>643</currency>
    <alfapay_url>https://alfa.rbsuat.com/payment/acsRedirect.do?orderId=03e3eb4c-e799-7b1e</alfapay_url>
</SDPayInAlfaPay>

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

Примечания

При получении запроса ПЦ проверяет правильность расчета подписи и корректность параметров запроса.