Skip to main content

订单状态流转

订单状态参考

订阅状态

订阅从 IN_PROGRESS 开始。需要用户选择支付方式或完成授权时进入 AUTHORIZATION_REQUIRED;用户完成授权后,订阅继续处理并进入 ACTIVE,失败或超时则进入 CLOSE。取消类状态和 EXPIRED 都是终态。下图只展示创建、授权、生效和结束的关键链路;各终态的具体枚举见下表。

退款状态

最佳实践

仅以 Webhook 作为唯一事实来源:重定向 URL 仅用于用户体验,不应被用来判断支付结果。
  1. 处理中间状态:不要在 PAY_IN_PROGRESS 时自动关闭订单;请等待 Webhook 或主动查询
  2. 幂等处理:Webhook 可能会被重复投递;请确保你的处理逻辑具备幂等性。详见 幂等性
  3. 未知状态:当遇到错误码 E0001 时,请使用原始的 paymentRequestId 进行查询,不要自动关闭订单。完整处理流程见 错误处理