Статусы заказов
Заказ проходит следующий жизненный цикл:
new → paid → processing → completed
↘ ↘ failed
cancel → cancelled
ttl expires → expiredТаблица статусов
| Статус | Терминальный | Описание |
|---|---|---|
new | Нет | Заказ создан, ожидает TRX-депозита с address_from. |
paid | Нет | Соответствующий депозит получен. Заказ поставлен в очередь на обработку. |
processing | Нет | Энергия и/или пропускная способность доставляются на address_to. |
completed | Да | Ресурсы доставлены. Реферальная комиссия начислена партнёру. |
failed | Да | Заказ не удалось выполнить. |
cancelled | Да | Отменён клиентом через POST /v1/orders/cancel. |
expired | Да | Соответствующий депозит не получен в течение срока ttl. |
Важные замечания
- Отменить можно только заказы в статусе
new. - Депозит, полученный для заказа в статусе
cancelledилиexpired, не возвращается автоматически. - Реферальная комиссия начисляется только при достижении заказом статуса
completed. - Опрашивайте Проверку заказа до тех пор, пока статус не станет терминальным (
completed,failed,cancelledилиexpired), чтобы знать о завершении доставки.
Рекомендуемый интервал опроса
Опрашивайте каждые 5–10 секунд после обнаружения платежа. Большинство заказов выполняются в течение 5–10 секунд после подтверждения оплаты.
