# Статусы транзакций

В ответах API, колбеках и при запросе статуса платежа или выплаты передаются два связанных поля:

- `status` — числовой код;
- `status_description` — текстовый литерал (латиница, uppercase).


Значения всегда идут **парой**. Машинные коды **не переводите** и не подменяйте в интеграции.

## Соответствие `status` и `status_description`

| `status` | `status_description` | Описание |
|  --- | --- | --- |
| `1` | `INIT` | Транзакция инициирована. |
| `2` | `PENDING` | Транзакция в обработке. |
| `3` | `SUCCESS` | Транзакция успешно проведена. |
| `4` | `FAILURE` | Отказ в проведении транзакции. |
| `5` | `REFUND` | Возврат успешно проведён. |
| `9` | `REFUND_PENDING` | Возврат в обработке. |


## Как использовать в интеграции

| Статус | Действие |
|  --- | --- |
| `INIT`, `PENDING` | Ожидайте финальный статус: опрашивайте метод статуса или обрабатывайте колбек на `notify_url`. |
| `SUCCESS` | Зачисляйте заказ / закрывайте операцию у себя. |
| `FAILURE` | Не считайте платёж успешным; при наличии `status_code` в колбеке см. [Коды ошибок (отказы)](/pages/decline-error-codes). |
| `REFUND`, `REFUND_PENDING` | Учитывайте возврат в учёте; дождитесь `REFUND` при `REFUND_PENDING`. |


Финальные статусы для платежа: `SUCCESS`, `FAILURE`; для возврата: `REFUND` (промежуточный — `REFUND_PENDING`).

## Связанные разделы

- [Коды ошибок (отказы)](/pages/decline-error-codes)
- [Коды ошибок (API)](/pages/error-codes-api)
- [Формат запроса к API](/pages/init-request)