Правильная ссылка на эту статью: |
Выписывание счета
URL¶
POST https://security.webmoney.com/V1/CreateInvoice.ashx
Заголовки¶
Authorization: Bearer {JWT}
— обязательный JWT-токен. ( Выдается на https://security.webmoney.com )- Content-Type:application/json; charset=utf-8
Тело запроса (JSON)¶
{ "reqn": 1730486400000, "orderid": 1730486400000, "customerwmid": "111122223333", "amount": 0.02, "desc": "Тестовый счет", "address": "", "period": 0, "expiration": 0, "onlyauth": 1, "lmishopid": 123456 }
Пояснения к полям¶
*. Поле | *. Тип | Описание |
---|---|---|
reqn | long | Номер запроса (рекомендуется Unix-время в мс) |
orderid | long | Идентификатор счета у магазина (часто совпадает с reqn) |
customerwmid | string | WMID плательщика |
amount | decimal | Сумма (> 0) |
desc | string | Назначение платежа (не пустое) |
address | string | Адрес/комментарий (опционально) |
period | int | Период протекции, дней (>= 0) |
expiration | int | Срок действия счета, дней (>= 0) |
lmishopid | long | ID магазина (Merchant, опционально; если > 0 — передаётся) |
Примечания:
- Кошелёк магазина берётся из JWT и не передаётся в теле запроса.
Пример успешного ответа¶
{ "reqn": 1730486400000, "retval": 0, "retdesc": "Ok", "invoice": { "id": 987654321, "ts": 987654321, "orderid": 1730486400000, "customerwmid": "111122223333", "storepurse": "Z123456789012", "amount": 0.02, "desc": "Тестовый счет", "address": "", "period": 0, "expiration": 0, "state": 0, "datecrt": "2025-10-02T12:34:56.789Z", "dateupd": "2025-10-02T12:34:56.789Z" } }
Примечания по ответу:
datecrt
/dateupd
— ISO 8601, UTC.
Примеры ошибок¶
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) |
-3 | Ошибка обработки запроса |
... | Другие коды описаны в Интерфейс X1 |