订单状态

订单状态分为处理中状态和终态。webhook 只投递终态，处理中状态需要通过查询接口查看。

处理中

PENDING、PROCESSING 表示订单尚未完成，不触发 webhook。

终态

SUCCEEDED、FAILED、EXPIRED、CANCELED 等终态可用于业务落账。

冲突

回调重复或乱序时，以查询接口确认的订单状态为准。

Payment 状态

PENDING处理中

订单已创建，等待付款或等待通道处理；不投递 webhook。

PROCESSING处理中

通道处理中；不投递 webhook。

SUCCEEDED终态，会回调

代收成功，可用于业务落账。

FAILED终态，会回调

代收失败，可关闭本地待支付单。

EXPIRED终态，会回调

订单过期，不应继续等待用户完成支付。

CANCELED终态，会回调

订单取消，不应继续等待用户完成支付。

Payout 状态

PENDING处理中

订单已创建，等待处理；不投递 webhook。

PROCESSING处理中

出款处理中；不投递 webhook。

SUCCEEDED终态，会回调

代付成功，可进入放款完成、对账或通知用户流程。

FAILED终态，会回调

代付失败，可按业务规则释放余额或提示用户更换收款信息。

内部异常处理状态不对商户暴露；查询接口会继续表现为 PROCESSING。订单恢复到成功或失败终态后，再投递最终状态 webhook。

商户落账以查询接口和已验签的 webhook 终态为准。回调重复或乱序时，以查询结果为准。

代付退回

代付 SUCCEEDED 后，上游仍可能退回资金；平台完成商户退款入账后，查单及通知返回 REFUNDED，并携带 refundNo、refundAmount（全额本金，十进制字符串）和 refundTime（Unix 毫秒）。商户不要重新发起代付或重复入账，晚到的成功通知不能回退已退款状态。该状态和退款字段仅用于代付退回，不改变代收及收银台状态。详见代付退款通知。