> ## Documentation Index
> Fetch the complete documentation index at: https://wallet-docs.iexexchanger.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Статусы выплаты

> Полный жизненный цикл выплаты, on-chain статусы и срабатывание вебхуков

Выплата возвращает два независимых статуса: **бизнес-статус** (`status`) — где она в нашем
процессе, и, после отправки в сеть, **on-chain статус** (`networkStatus`) исходящей транзакции.

## Бизнес-статусы (`status`)

| Статус             | Терминальный | Значение                                          |
| ------------------ | :----------: | ------------------------------------------------- |
| `new`              |      нет     | создана, проходит проверки                        |
| `pending_approval` |      нет     | ждёт ручного одобрения оператором                 |
| `approved`         |      нет     | одобрена, ставится в очередь                      |
| `rejected`         |      да      | отклонена оператором                              |
| `queued`           |      нет     | в очереди на отправку                             |
| `signing`          |      нет     | подписывается                                     |
| `broadcasted`      |      нет     | отправлена в сеть, ждёт подтверждений             |
| `confirmed`        |      да      | подтверждена сетью — выплата завершена            |
| `failed`           |      да      | не удалась (отклонена сетью или ошибка broadcast) |
| `cancelled`        |      да      | отменена (только до `signing`)                    |

<Note>
  Терминальные статусы (`confirmed`, `failed`, `rejected`, `cancelled`) — финальные: дальше
  выплата не меняется. Все остальные — промежуточные.
</Note>

## Поток

```
new → pending_approval → approved → queued → signing → broadcasted → confirmed
                       → rejected
new → queued (при авто-одобрении)
queued      → cancelled (только до signing) | failed
broadcasted → failed (если транзакция отклонена сетью)
```

При создании через Public API выплата стартует в `queued` (авто-одобрение) либо в
`pending_approval`, если сработала политика одобрения, лимит, белый список адресов или
velocity-проверка. В ответе на создание поле `requiresApproval` показывает, какой из путей
выбран.

<Note>
  Когда `requiresApproval = true`, выплата уходит в сеть только **после** ручного одобрения
  в личном кабинете. Это защита от ошибочных крупных выводов; поведение настраивается политиками
  одобрения. До одобрения поле `approvedAt` равно `null`.
</Note>

## On-chain статусы (`networkStatus`)

Относятся к исходящей транзакции и заполняются после её отправки. До отправки `networkStatus`
равен `null`.

| Статус      | Значение                                        |
| ----------- | ----------------------------------------------- |
| `pending`   | транзакция подписана и сохранена, ещё не в сети |
| `mempool`   | отправлена, находится в мемпуле                 |
| `confirmed` | подтверждена сетью                              |
| `fail`      | отклонена сетью                                 |

Прогресс подтверждений виден в полях `confirmations` и `requiredConfirmations`: финализация
наступает, когда `confirmations` достигает `requiredConfirmations`.

## Когда срабатывают вебхуки

| Событие              | Триггер (переход)                                        |
| -------------------- | -------------------------------------------------------- |
| `payout.broadcasted` | транзакция отправлена в сеть — статус стал `broadcasted` |
| `payout.confirmed`   | выплата подтверждена сетью — статус стал `confirmed`     |
| `payout.failed`      | выплата не удалась — статус стал `failed`                |

<Note>
  Переходы `pending_approval`, `approved`, `rejected`, `cancelled` отслеживаются через личный
  кабинет и опрос `GET /v1/public/payouts/{uuid}` — отдельных вебхуков для них нет. На стороне
  CMS реагируйте на три события выше; для остальных статусов используйте опрос.
</Note>

См. также [Обзор выплат](/payouts/overview) и [Вебхуки](/webhooks/overview).