Получение истории операций по кошельку

URL¶

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

Заголовки¶

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

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

{
  "reqn": 1730486400000,
  "wmtranid": 0,
  "tranid": 0,
  "datestart": "2025-09-01T00:00:00",
  "datefinish": "2025-10-02T23:59:59" 
}

Поля¶

*. Поле	*. Тип	Описание
reqn	long	Номер запроса (рекомендуется Unix-время в мс)
wmtranid	long	Номер операции в системе WebMoney (> 0 — datestart/datefinish игнорируются), иначе 0
tranid	long	Номер перевода у отправителя (> 0 — datestart/datefinish игнорируются), иначе 0
datestart	DateTime	Начало периода (ISO 8601: YYYY-MM-DDThh:mm:ss), обязателен при wmtranid = 0 и tranid = 0
datefinish	DateTime	Конец периода (ISO 8601: YYYY-MM-DDThh:mm:ss), обязателен при wmtranid = 0 и tranid = 0

Примечания:

• Кошелёк берётся из JWT и не передаётся в теле запроса. Если в теле указан purse, он должен совпадать с кошельком из токена.
• Если wmtranid > 0 или tranid > 0, поля datestart и datefinish игнорируются.

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

{
  "reqn": 1730486400000,
  "operations": [
    {
      "id": 123456789,
      "ts": 987654321,
      "tranid": 1730486400000,
      "pursesrc": "Z123456789012",
      "pursedest": "Z163484365864",
      "amount": 0.02,
      "comiss": 0.01,
      "opertype": 0,
      "wminvid": 0,
      "orderid": 0,
      "period": 0,
      "desc": "Оплата теста",
      "datecrt": "2025-10-02T12:34:56.789Z",
      "dateupd": "2025-10-02T12:34:56.789Z" 
    }
  ],
  "retval": 0,
  "retdesc": "OK" 
}

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

• datecrt/dateupd — ISO 8601, UTC.

Пример ошибки (частичные данные уже отданы)¶

Если ошибка произошла после начала выдачи массива operations, ответ завершается флагом ошибки.

{
  "reqn": 1730486400000,
  "operations": [
    {
      "id": 123456789,
      "ts": 987654321,
      "tranid": 1730486400000,
      "pursesrc": "Z123456789012",
      "pursedest": "Z163484365864",
      "amount": 0.02,
      "comiss": 0.01,
      "opertype": 0,
      "wminvid": 0,
      "orderid": 0,
      "period": 0,
      "desc": "Оплата теста",
      "datecrt": "2025-10-02T12:34:56.789Z",
      "dateupd": "2025-10-02T12:34:56.789Z" 
    }
  ],
  "retval": -2,
  "retdesc": "Partial data followed by error: <описание>" 
}

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

401 Unauthorized:

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

403 Forbidden:

{
  "retval": 403,
  "retdesc": "Access denied: <описание>" 
}

404 Not Found:

{
  "retval": 404,
  "retdesc": "Resource not found: <описание>" 
}

500 Internal Server Error:

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

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

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

---