Получение баланса кошелька

URL¶

POST https://security.webmoney.com/V1/GetPurses.ashx

Заголовки¶

• Authorization: Bearer {JWT} — обязательный JWT-токен. Выдается на https://security.webmoney.com
• Content-Type: application/json; charset=utf-8

Тело запроса (JSON)¶

{
  "reqn": 1730486400000,
  "wmid": "" 
}

Поля¶

*. Поле	*. Тип	Описание
reqn	long	Номер запроса (рекомендуется Unix-время в мс)
wmid	string	Необязателен; если указан — должен совпадать со slaveWMId из JWT, иначе 400

Примечания:

• WMID берётся из JWT (slaveWMId) и не требуется в теле.
• Интерфейс доступен для участников с аттестатом не ниже персонального и правом Permission.Balance.

Пример успешного ответа¶

{
  "reqn": 1730486400000,
  "purses": [
    {
      "id": 1234567,
      "pursename": "Z123456789012",
      "amount": 10.25,
      "desc": "Основной Z",
      "income": true,
      "incomestate": 0,
      "lastintr": 987654321,
      "lastouttr": 123456789
    }
  ],
  "retval": 0,
  "retdesc": "OK" 
}

Примечания по ответу:

• lastintr — номер последней входящей операции (wmtranid).
• lastouttr — номер последней исходящей операции.

Примеры ошибок¶

401 Unauthorized:

{
  "retval": 401,
  "retdesc": "Authorization error: <описание>" 
}

405 Method Not Allowed:

{
  "retval": 405,
  "retdesc": "Method not allowed. Use POST." 
}

400 Bad Request (валидация запроса):

{
  "reqn": 1730486400000,
  "retval": -3,
  "retdesc": "Request processing error: <описание>" 
}

Возможные коды возврата¶

*. Код	*. Описание
0	Ok
401	Ошибка авторизации
405	Метод не разрешён (только POST)
-3	Ошибка обработки запроса
...	Другие коды описаны в Интерфейс X9

---