api/p2p-credit-balance - Баланс счета терминала

HTTP‑методы: POST
URL: /api/p2p-credit-balance
Форма взаимодействия: Сервер-сервер
Формат тела запроса: application/json
Назначение: получение информации о доступном балансе на счету терминала.

URL

URLPATH

https://gateway-docs.wallet.kvell.group/api/p2p-credit-balance

/api/p2p-credit-balance

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

Поле	Тип	Обяз.	Описание
`terminal`	`str`	✔	Уникальный идентификатор учетной записи ТСП в ПЦ.
`nonce`	`int`	✔	Уникальный номер Запроса. Каждый очередной Запрос должен иметь значение параметра `nonce` не меньшее, чем в предыдущем Запросе.
`signature`	`str`	✔	Цифровая подпись запроса. Алгоритм расчёта — см. Формирование подписи.

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

Поле	Тип	Обяз.	Описание
`nonce`	`int`	✔	Значение `nonce` из запроса. Пример: `10`
`balance`	`int`	✔	Сумма остатка на счету в минимальных единицах валюты (для RUB — копейки). Пример: `2842261`
`currency`	`int`		Код валюты по ISO 4217 (643 — RUB, 978 — EUR, 840 — USD). Пример: `643`
`signature`	`str`		Цифровая подпись сообщения. Пример: `8f2a1c9e3b7d4056a1f8c2e9d3b6a70158fce29b4d7a1e6c0938fa2d17bc45e9`

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

Успех (200)Пример ошибки (404)

{
    "nonce": 10,
    "balance": 2842261,
    "currency": 643,
    "signature": "8f2a1c9e3b7d4056a1f8c2e9d3b6a70158fce29b4d7a1e6c0938fa2d17bc45e9"
}

{
    "error_code": "TERMINAL_NOT_FOUND",
    "technical_message": "Terminal not found",
    "timestamp": 1751976000,
    "details": null,
    "request_id": "b3b3c1f0-4b3a-4f3a-9b1a-1234567890ab"
}

Примечания

Ответ может содержать ряд необязательных параметров, которые важно учесть при составлении подписи.
Параметр nonce не учитывается в логике запроса и не проверяется на валидность последовательности.