跳转到主要内容

状态生命周期

Quick Reference

What扣款状态参考
Why追踪支付生命周期中的每个状态

扣款按一组既定的状态流转。文档和集成中使用的标准顺序为:

issuedpendingconfirmedpre_capturedpaid → (refunded | 争议路径) → 终态,包括 cancelederror

状态说明

具体的转换取决于支付方式、捕获模式和收单机构规则。使用 Webhook(网络钩子)和对 GET 扣款端点的轮询来保持与平台状态同步。

状态顺序(参考列表)

  1. issued
  2. pending
  3. confirmed
  4. pre_captured
  5. paid
  6. refunded
  7. refund_error
  8. pre_chargeback_resolution
  9. chargeback
  10. chargeback_requested
  11. chargeback_reversed
  12. chargeback_refunded
  13. canceled
  14. error

状态转换图

状态参考

状态含义是否终态
issued扣款记录已创建;尚未提交处理。
pending等待授权、3DS 或收单机构异步操作。
confirmed已收到授权或承诺;可能仍需捕获。
pre_captured授权金额已冻结;捕获待处理或进行中。
paid资金已捕获或结算路径确认成功。
refunded退款已成功完成。
refund_error退款尝试失败;需要调查或重试。
pre_chargeback_resolution争议已开启;等待最终分类前的审核。
chargeback拒付已被接受或败诉;账本反映争议结果。
chargeback_requested发卡行或持卡人发起拒付;尚未最终裁定。
chargeback_reversed拒付被撤销,对商户有利;可能恢复为 paid
chargeback_refunded因拒付退款流程进行资金调整。
canceled扣款在完成前已作废或过期。
error此次扣款尝试发生不可恢复的处理失败。