Order Statuses

An order moves through the following lifecycle:

new → paid → processing → completed
         ↘               ↘ failed
cancel →  cancelled
ttl expires → expired

Status table

Status	Terminal	Description
new	No	Order created, waiting for the TRX deposit from address_from.
paid	No	Matching deposit received. Order is queued for processing.
processing	No	Energy and/or bandwidth are being delivered to address_to.
completed	Yes	Resources delivered. Referral commission credited to partner.
failed	Yes	Order could not be fulfilled.
cancelled	Yes	Cancelled by the client via POST /v1/orders/cancel.
expired	Yes	No matching deposit received within the ttl window.

Important notes

• Only orders in new status can be cancelled.
• A deposit received against a cancelled or expired order is not refunded automatically.
• Referral commission is credited only when the order reaches completed.
• Poll Check Order until the status is terminal (completed, failed, cancelled, or expired) to know when delivery is done.

Recommended polling interval

Poll every 5–10 seconds after detecting payment. Most orders complete within 5–10 seconds of payment confirmation.