GET /invoice/status

Возвращает текущий статус инвойса. Используется для polling, проверки статуса и сверки операций.

Параметры запроса

Query

Параметр	Тип	Обязательный	Описание
`invoice_id`	string	Да	ID инвойса из ответа создания, например `inv_01970f4f6b7c7d52b2d9`

Headers

Параметр	Тип	Обязательный	Описание
`Authorization`	string	Да	`Bearer <token>`
`X-Merchant`	string	Да	Идентификатор мерчанта

Тело запроса не передаётся.

Ответы

200 OK — Статус успешно получен

Поле	Тип	Описание
`result`	boolean	`true`
`data.invoice_id`	string	ID инвойса
`data.status`	integer	1 PENDING, 2 PAID, 3 EXPIRED, 4 CANCELED
`data.end_date`	integer	Дата истечения (UTC ms)

{
  "result": true,
  "data": {
    "invoice_id": "inv_01970f4f6b7c7d52b2d9",
    "status": 2,
    "end_date": 1779454179000
  },
  "error": null
}
        

401 Unauthorized

{
  "result": false,
  "data": null,
  "error": {
    "message": "Unauthorized",
    "error_code": 401
  }
}
        

404 Not Found — Инвойс не найден

{
  "result": false,
  "data": null,
  "error": {
    "message": "Invoice not found",
    "error_code": 404
  }
}
        

422 Validation Error

{
  "detail": [
    {
      "loc": ["query", "invoice_id"],
      "msg": "Field required",
      "type": "missing"
    }
  ]
}
        

500 Internal Server Error

{
  "result": false,
  "data": null,
  "error": {
    "message": "Internal server error",
    "error_code": 500
  }
}
        

01 июня 2026