Правильная ссылка на эту статью: |
Получение списка счетов на оплату
URL¶
POST https://security.webmoney.com/V1/GetInInvoices.ashx
Заголовки¶
Authorization: Bearer {JWT}
— обязательный JWT-токен. Выдается на https://security.webmoney.com/.- Content-Type:application/json; charset=utf-8
Тело запроса (JSON)¶
{ "reqn": 1730486400000, "wminvid": 0, "datestart": "2025-09-01T00:00:00", "datefinish": "2025-10-02T23:59:59" }
*. Поле | *. Тип | Описание |
---|---|---|
reqn | long | Номер запроса (рекомендуется Unix-время в мс) |
wminvid | long | Номер счета в WebMoney (> 0 — остальные фильтры игнорируются), иначе 0 |
datestart | DateTime | Начало периода (ISO 8601 `YYYY-MM-DDThh:mm:ss`), обязателен при `wminvid = 0` |
datefinish | DateTime | Конец периода (ISO 8601 `YYYY-MM-DDThh:mm:ss`), обязателен при `wminvid = 0` |
- WMID получателя берется из JWT (
slave
). - Если
wminvid > 0
, поляdatestart
иdatefinish
игнорируются.
Пример успешного ответа¶
{ "reqn": 1730486400000, "invoices": [ { "id": 987654321, "ts": 1234567890, "orderid": 1730486400000, "storewmid": "000000000001", "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.
Пример ошибки (частичные данные уже отданы)¶
{ "reqn": 1730486400000, "invoices": [ { "id": 1, "orderid": 1, "storewmid": "000000000001", "storepurse": "Z...", "amount": 1.00, "state": 0 } ], "retval": -2, "retdesc": "Partial data followed by error: <описание>" }
Примеры ошибок¶
401 Unauthorized:
{ "reqn": 1730486400000, "retval": 401, "retdesc": "Authorization error: <описание>" }
400 Bad Request:
{ "reqn": 1730486400000, "retval": -3, "retdesc": "Request processing error: <описание>" }
Возможные коды возврата¶
*. Код | Описание |
---|---|
0 | Ok |
401 | Ошибка авторизации |
405 | Метод не разрешён (только POST) |
-2 | Данные отданы частично, затем ошибка |
-3 | Ошибка обработки запроса |
... | Другие коды описаны в Интерфейс X10 |
Хочешь, я переделаю твои остальные API в таком же wiki-формате (например `GetOutInvoices.ashx`, `GetOperations.ashx`, `SendMessage.ashx` и т.д.), чтобы они выглядели единообразно для размещения на wiki?