WooCommerce订单状态含义及流转方向

1️⃣ WooCommerce 默认订单状态及说明

状态	说明	流向说明
pending	待付款（用户已下单，但未支付）	可取消 → 付款成功转 processing 或失败保持 pending
failed	付款失败（支付网关返回失败）	可重新付款 → 成功转 processing
on-hold	暂停/等待（管理员手动设置，或库存不足时自动设置）	管理员可手动转 processing 或 cancelled
processing	处理中（已付款，需要发货）	发货完成 → completed
completed	已完成（订单已付款并完成发货/服务提供）	最终状态，一般不可再修改
refunded	已退款（全部或部分退款）	最终状态
cancelled	已取消（用户取消或管理员取消）	最终状态
trash	回收站	最终状态，删除订单

---

2️⃣ 流转方向（典型电商订单）

pending -> processing -> completed
      \-> failed
on-hold -> processing -> completed
          \-> cancelled
processing -> completed

• pending → 等待付款 → 成功转 processing → 发货完成转 completed
• pending → 付款失败 → failed
• on-hold → 等待管理员操作 → 转 processing 或 cancelled
• processing → 发货完成 → completed
• completed → 已完成订单，通常不可逆
• cancelled/refunded → 终态，不再流转

---

3️⃣ 备注

1. 退款状态
   • refunded 是退款成功的订单状态。
   • WooCommerce 会保留订单数据，但金额已退回。
2. 自定义状态
   • 有些插件可能会增加自定义订单状态（如 shipped、awaiting-shipment）。
   • 流转逻辑可以通过 register_post_status() 定义。
3. 统计/功能用法
   • 在插件里如果你只关心用户可以评论的订单，一般只算 已付款且需要发货的订单： 'status' => ['wc-completed', 'wc-processing']
   • 因为这些状态代表 用户已实际购买该商品。

---