# Transaction statuses

Payment or payout API responses, callbacks, and status requests include two related fields:

- `status` — numeric code;
- `status_description` — text literal (Latin, uppercase).


Values always come **as a pair**. **Do not translate** or replace machine codes in integration.

## `status` and `status_description` mapping

| `status` | `status_description` | Description |
|  --- | --- | --- |
| `1` | `INIT` | Transaction initiated. |
| `2` | `PENDING` | Transaction in progress. |
| `3` | `SUCCESS` | Transaction completed successfully. |
| `4` | `FAILURE` | Transaction declined. |
| `5` | `REFUND` | Refund completed successfully. |
| `9` | `REFUND_PENDING` | Refund in progress. |


## How to use in integration

| Status | Action |
|  --- | --- |
| `INIT`, `PENDING` | Wait for final status: poll the status method or handle callback on `notify_url`. |
| `SUCCESS` | Credit the order / close the operation on your side. |
| `FAILURE` | Do not treat payment as successful; handle `status_code` from the callback — see [Error codes (declines)](/en/pages/decline-error-codes). |
| `REFUND`, `REFUND_PENDING` | Account for the refund; wait for `REFUND` when status is `REFUND_PENDING`. |


Final statuses for payments: `SUCCESS`, `FAILURE`; for refunds: `REFUND` (intermediate — `REFUND_PENDING`).

## Related sections

- [Error codes (declines)](/en/pages/decline-error-codes)
- [Error codes (API)](/en/pages/error-codes-api)
- [API request format](/en/pages/init-request)