Status

Returns the current status of the invoice.

Find the invoice by id or by external_id.

Without state_callback in Create, call this method until the invoice reaches a final status: success, error, canceled or incomplete.

Full details of the invoice and its refunds: Info.

Invoice status flow

Statuses are the values of status.
unpaid is not a status: it groups new and process. From both of them, the invoice can move to any final status.

Status	Meaning
`new`	The invoice is created and waits for the payment.
`process`	The payment is in progress.
`success`	The invoice is paid. Refunds do not change the status.
`error`	The payment failed.
`canceled`	The invoice is cancelled.
`incomplete`	The invoice expired: it was not paid before `expires_at`.

Label	Meaning
payment started	The payment is in progress.
paid	The client paid the invoice.
failed	The payment failed.
cancelled	The merchant cancelled the invoice with Cancel.
expired	`expires_at` passed before the payment.

Result

HTTP	Meaning	Next step
`200`	The status is returned in `status`.	If the status is not final, repeat the request later.
`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` or `external_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`	—	Neither `id` nor `external_id` is passed, or `id` is not a UUID. `error_description` names the field.	Fix the request.

Invoice status flow

Result

Errors

Request

Responses

Status

Invoice status flow#

Result#

Errors#

Request

Responses

Invoice status flow

Result

Errors