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

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

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

​
Поток

new → pending_approval → approved → queued → signing → broadcasted → confirmed
                       → rejected
new → queued (при авто-одобрении)
queued      → cancelled (только до signing) | failed
broadcasted → failed (если транзакция отклонена сетью)
При создании через Public API выплата стартует в queued (авто-одобрение) либо в pending_approval, если сработала политика одобрения, лимит, белый список адресов или velocity-проверка. В ответе на создание поле requiresApproval показывает, какой из путей выбран.
Когда requiresApproval = true, выплата уходит в сеть только после ручного одобрения в личном кабинете. Это защита от ошибочных крупных выводов; поведение настраивается политиками одобрения. До одобрения поле approvedAt равно null.

​
On-chain статусы (networkStatus)

Относятся к исходящей транзакции и заполняются после её отправки. До отправки networkStatus равен null.
СтатусЗначение
pendingтранзакция подписана и сохранена, ещё не в сети
mempoolотправлена, находится в мемпуле
confirmedподтверждена сетью
failотклонена сетью
Прогресс подтверждений виден в полях confirmations и requiredConfirmations: финализация наступает, когда confirmations достигает requiredConfirmations.

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

СобытиеТриггер (переход)
payout.broadcastedтранзакция отправлена в сеть — статус стал broadcasted
payout.confirmedвыплата подтверждена сетью — статус стал confirmed
payout.failedвыплата не удалась — статус стал failed
Переходы pending_approval, approved, rejected, cancelled отслеживаются через личный кабинет и опрос GET /v1/public/payouts/{uuid} — отдельных вебхуков для них нет. На стороне CMS реагируйте на три события выше; для остальных статусов используйте опрос.
См. также Обзор выплат и Вебхуки.