Перейти в режим автора

Получение истории выписанных счетов

URL

POST https://secirity.webmoney.com/V1/GetOutInvoices.ashx

Заголовки

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

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

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

Поля

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

Примечания:

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

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

{
  "reqn": 1730486400000,
  "invoices": [
    {
      "id": 987654321,
      "ts": 1234567890,
      "orderid": 1730486400000,
      "customerwmid": "111122223333",
      "storepurse": "Z123456789012",
      "amount": 0.02,
      "desc": "Тестовый счет",
      "address": "",
      "period": 0,
      "expiration": 0,
      "state": 2,
      "datecrt": "2025-10-02T12:34:56.789Z",
      "dateupd": "2025-10-03T09:10:11.123Z",
      "wmtranid": 555777999
    }
  ],
  "retval": 0,
  "retdesc": "OK" 
}

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

  • datecrt/dateupd — ISO 8601, UTC.

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

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

{
  "reqn": 1730486400000,
  "invoices": [
    {
      "id": 987654321,
      "ts": 1234567890,
      "orderid": 1730486400000,
      "customerwmid": "111122223333",
      "storepurse": "Z123456789012",
      "amount": 0.02,
      "desc": "Тестовый счет",
      "address": "",
      "period": 0,
      "expiration": 0,
      "state": 2,
      "datecrt": "2025-10-02T12:34:56.789Z",
      "dateupd": "2025-10-03T09:10:11.123Z",
      "wmtranid": 555777999
    }
  ],
  "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 Ошибка обработки запроса
... Другие коды описаны в Интерфейс X4