На странице
Статусы вывода
Статусы вывода
| Статус | Описание | Терминальный |
|---|---|---|
created |
Вывод создан и ещё не ушёл в сеть | Нет |
signed |
Транзакция подписана и отправлена в блокчейн | Нет |
cancelling |
Вывод отменяется; чем это кончится, скажет следующий статус | Нет |
completed |
Транзакция подтверждена в блокчейне, средства доставлены | Да |
failed |
Вывод не ушёл. Средства вернулись на баланс | Да |
cancelled |
Мерчант отменил вывод, он не ушёл. Средства вернулись на баланс | Да |
pending_review |
Транзакция ещё не подтверждена в сети, сумма остаётся в резерве. В дашборде этот статус показан как «Не подтверждён» | Нет |
Как это читать в коде
Финальных статусов три — completed, failed и cancelled. В каждом ответе и каждом вебхуке есть поле is_final: ветвитесь по нему, а не по списку имён, который вам придётся поддерживать самим.
Отменить вывод можно, только пока он в created. Дальше запрос на отмену отклоняется — см. Отмену вывода. Причину, по которой вывод не ушёл, API не возвращает: у failed есть статус, но нет поля с объяснением.
В песочнице вывод переводится из created в completed вызовом POST /v1/sandbox/withdrawals/{id}/simulate-completion — без подписания и без блокчейна.