webapi/b2puser/sd-services/SDGetBalance - Получение баланса Кубышки

Описание

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

URL

URLPATH

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

/webapi/b2puser/sd-services/SDGetBalance/

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

Поле	Тип	Обяз.	Описание
sector	str	✔	Уникальный идентификатор учетной записи ТСП в ПЦ.
sd_ref	str	✔	Уникальный идентификатор Кубышки.
signature	str	✔	Цифровая подпись. В формировании подписи участвуют параметры: sector, sd_ref, password в указанном порядке.

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

Элемент	Тип	Описание
sd_ref	str	Уникальный идентификатор Кубышки.
balance	int	Значение основного баланса "в копейках".
available_balance	int	Значение доступного баланса "в копейках".
currency	int	Валюта баланса Кубышки.
sd_state	str	Статус Кубышки.

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

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

<?xml version="1.0" encoding="UTF-8"?>
<sd_balance>
    <sd_ref>zzz</sd_ref>
    <balance>124209703</balance>
    <currency>643</currency>
    <sd_state>ACTIVE</sd_state>
    <available_balance>124209703</available_balance>
</sd_balance>

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

Примечания

• При получении запроса ПЦ проверяет:
• Правильность расчета подписи и корректность параметров запроса;
• Наличие sd_ref в запросе и принадлежность к указанному сектору;
• Если заданный sd_ref не найден в системе, то создается Кубышка с нулевым балансом;