Info

Returns the details of the invoice: status, amount, receipt items and refunds.

Optional fields are returned only if they have a value.

To check only the status, use Status.

Invoice info flow

Result

HTTP	Meaning	Next step
`200`	The details are returned.	—
`400`, `401`, `422`, `500`	The request is rejected.	See «Errors» below.

Errors

The error is returned in error_description; error_code is returned for 401, 422 and for the 400 errors that have a code below.

HTTP	`error_code`	When	What to do
`400`	`3001`	The invoice is not found.	Check `id`.
`401`	`9998`	The signature is invalid.	Check the signature: see Overview.
`422`	`9403`	The X-JWS-Signature header is missing.	Pass the signature.
`500`	—	`id` is not passed or is not a UUID.	Fix the request.

Responses

🟢200OK

application/json

Headers

Bodyapplication/json

Example

{
    "status": "success",
    "type": "superapp",
    "amount": 100,
    "currency": "KZT",
    "external_id": "order_1001",
    "refunds": [
        {
            "id": "019d0653-1a2b-7c3d-8e4f-5a6b7c8d9e0f",
            "amount": 30,
            "status": "success",
            "created_at": "2026-10-29T12:59:29+00:00"
        }
    ],
    "shop_name": "Example shop",
    "description": "Order #1001",
    "expires_at": "2026-10-30T16:24:47+05:00",
    "state_callback": "https://merchant.example.com/callback",
    "tax": [
        {
            "name": "Item 1",
            "count": 1,
            "price": 100,
            "type": "vat12"
        }
    ],
    "created_at": "2026-10-29T16:24:47+05:00"
}

🟠400Bad Request

🟠401Unauthorized

🟠422Unprocessable Entity

🔴500Internal Server Error

Invoice info flow#

Result#

Errors#

Request

Responses

Invoice info flow

Result

Errors