Метод account-info
Получение информации о состоянии счета пользователя.
Требуемые права токена:
account-info
Запрос
Входные параметры отсутствуют.
Пример запроса
POST /api/account-info HTTP/1.1 Host: yoomoney.ru Authorization: Bearer 410012345678901.0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ0123 Content-Type: application/x-www-form-urlencoded Content-Length: 0
Ответ
В случае успеха возвращает JSON-документ со следующим содержимым:
Параметр | Тип | Описание |
---|---|---|
account | string | Номер счета пользователя. |
balance | amount | Баланс счета пользователя. |
currency | string | Код валюты счета пользователя. Всегда 643 (рубль РФ по стандарту ISO 4217). |
account_status | string | Статус пользователя. Возможные значения:
|
account_type | string | Тип счета пользователя. Возможные значения:
|
balance_details | object | По умолчанию этот блок отсутствует. Блок появляется, если сейчас или когда-либо ранее были зачисления в очереди, задолженности, блокировки средств. |
cards_linked | array | Информация о привязанных банковских картах. Если к счету не привязано ни одной карты, параметр отсутствует. Если к счету привязана хотя бы одна карта, параметр содержит список данных о привязанных картах. |
Параметры объекта balance_details
Параметр | Тип | Описание |
---|---|---|
total | amount | Общий баланс счета. |
available | amount | Сумма доступная для расходных операций. |
deposition_pending | amount | Сумма стоящих в очереди пополнений. Если зачислений в очереди нет, то параметр отсутствует. |
blocked | amount | Сумма заблокированных средств по решению исполнительных органов. Если заблокированных средств нет то параметр отсутствует. |
debt | amount | Сумма задолженности (отрицательного остатка на счете). Если задолженности нет, то параметр отсутствует. |
hold | amount | Сумма замороженных средств. Если замороженных средств нет, то параметр отсутствует. |
Параметры объекта cards_linked
Параметр | Тип | Описание |
---|---|---|
pan_fragment | string | Маскированный номер карты. |
type | string | Тип карты. Может отсутствовать, если неизвестен. Возможные значения:
|
Пример ответа
JSON
{ "account": "4100123456789", "balance": 1000.00, "currency": "643", "account_status": "anonymous", "account_type": "personal", "cards_linked": [ { "pan_fragment": "510000******9999", "type": "MasterCard" } ] }