订单状态

订单会经历以下生命周期：

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

状态表

状态	终态	描述
new	否	订单已创建，等待 address_from 发送 TRX 充值。
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 秒内完成。