Метод account-info

Описание

Получение информации о состоянии счета пользователя.

Требуемые права токена: account-info

Входные параметры

Отсутствуют

Возвращает

В случае успеха возвращает JSON-документ со следующим содержимым:

Параметр Тип Описание
account string Номер счета пользователя.
balance amount Баланс счета пользователя.
currency string Код валюты счета пользователя. Всегда 643 (рубль РФ по стандарту ISO 4217).
account_status string Статус пользователя. Возможные значения:
  • anonymous - анонимный счет
  • named - именной счет
  • identified - идентифицированный счет
account_type string Тип счета пользователя. Возможные значения:
  • personal - счет пользователя в Яндекс.Деньгах
  • professional - профессиональный счет в Яндекс.Деньгах
avatar object Ссылка на аватар пользователя. Если аватарка пользователя не установлена, параметр отсутствует.
balance_details object Расширенная информация о балансе. По умолчанию этот блок отсутствует. Блок появляется если сейчас или когда либо ранее были:
  • зачисления в очереди;
  • задолженности;
  • блокировки средств.

Подробности.

cards_linked array

Информация о привязанных банковских картах.

Если к счету не привязано ни одной карты, параметр отсутствует. Если к счету привязана хотя бы одна карта, параметр содержит список данных о привязанных картах.

Параметры объекта avatar:

Параметр Тип Описание
url string Ссылка на аватар пользователя.
ts datetime Timestamp последнего изменения аватарки.

Параметры объекта balance_details:

Параметр Тип Описание
total amount Общий баланс счета.
available amount Сумма доступная для расходных операций.
deposition_pending amount Сумма стоящих в очереди пополнений. Если зачислений в очереди нет, то параметр отсутствует.
blocked amount Сумма заблокированных средств по решению исполнительных органов. Если заблокированных средств нет то параметр отсутствует.
debt amount Сумма задолженности (отрицательного остатка на счете). Если задолженности нет, то параметр отсутствует.
hold amount Сумма замороженных средств. Если замороженных средств нет, то параметр отсутствует.

Параметры объекта cards_linked:

Параметр Тип Описание
pan_fragment string Маскированный номер карты.
type string Тип карты. Может отсутствовать, если неизвестен. Возможные значения:
  • VISA;
  • MasterCard;
  • AmericanExpress;
  • JCB.

Пример запроса:

POST /api/account-info HTTP/1.1
Host: money.yandex.ru
Authorization: Bearer 410012345678901.0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ0123
Content-Type: application/x-www-form-urlencoded
Content-Length: 0

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

{
  "account": "4100123456789",
  "balance": 1000.00,
  "currency": "643",
  "account_status": "anonymous",
  "account_type": "personal",
  "avatar": {
    "url": "http://avatars.yandex.net/get-yamoney-profile/yamoney-profile-30633298/normal",
    "ts": "2013-03-13T20:43:00.000+04:00"
  },
  "cards_linked": [
    {
      "pan_fragment": "510000******9999",
      "type": "MasterCard"
    }
  ]
}