交易状态

所有交易状态的列表。

交易的 status 值可以是以下值之一，具体取决于系统内的状态和所使用的支付服务内的状态。

授权状态

status	描述
processing	交易记录已在系统中创建，现正在使用您的支付服务进行处理。
authorization_pending	交易授权正在与支付服务进行中。
authorization_succeeded	交易已成功授权但尚未捕获。
authorization_failed	由于技术问题或支付服务的限制，交易无法通过任何支付服务授权。
authorization_void	交易已成功授权，但在捕获之前已被撤销。

买家审批状态

status	描述
buyer_approval_pending	交易已创建，但需要买家批准，通过将他们重定向到托管页面或其银行进行3DS验证。
buyer_approval_succeeded	买家已成功完成审批流程。
buyer_approval_failed	买家审批流程失败或被拒绝。
buyer_approval_timeout	买家审批流程在未完成的情况下超时。

捕获状态

status	描述
capture_pending	交易已成功提交给支付服务进行捕获，现在正在等待处理。
capture_succeeded	交易已成功授权和捕获。
capture_failed	在成功授权后，捕获尝试失败。

退款状态

status	描述
refund_pending	退款请求已提交并正在处理中。
refund_succeeded	退款已成功处理，资金已返还给买家。
refund_failed	由于技术问题或支付服务限制，退款尝试失败。
refund_void	待处理的退款在完成前已被取消/撤销。

拒付状态

status	描述
chargeback_pending	拒付已发起并正在审查中。
chargeback_won	商户成功对拒付进行了争议。
chargeback_lost	拒付案件判决支持持卡人。
chargeback_expired	拒付案件在未解决的情况下过期。

最终状态

status	描述
settled	交易已结算，资金已转移到商户账户。
cancelled	交易在完成前被取消。
expired	交易在未完成的情况下过期（例如，买家未在时间内完成审批）。

状态图

以下状态图概述了所有不同的 status 值以及它们之间的关系。

完整交易生命周期

processing
    ↓
buyer_approval_pending（如果需要）
    ↓               ↓
buyer_approval_succeeded  buyer_approval_failed
    ↓                           ↓
authorization_succeeded      expired/cancelled
    ↓           ↓
authorization_void   capture_pending
    ↓               ↓
（结束）          capture_succeeded
                    ↓
                settled ――→ refund_pending ――→ refund_succeeded
                    ↓           ↓
                    ↓       refund_failed
                    ↓
                chargeback_pending
                    ↓           ↓           ↓
            chargeback_won  chargeback_lost  chargeback_expired

分离式授权和捕获流程

原始 intent 为 authorize 的交易：

processing
    ↓
buyer_approval_pending（如果需要）
    ↓
authorization_succeeded ――→ authorization_void
    ↓
capture_pending
    ↓        ↓
capture_succeeded  capture_failed
    ↓
settled
    ↓
[退款/拒付流程]

直接捕获流程

原始 intent 为 capture 的交易：

processing
    ↓
buyer_approval_pending（如果需要）
    ↓
capture_succeeded
    ↓
settled
    ↓
[退款/拒付流程]

状态分类

活跃交易状态

• processing, buyer_approval_pending, authorization_pending, capture_pending, refund_pending, chargeback_pending

成功完成状态

• authorization_succeeded, capture_succeeded, settled, refund_succeeded, chargeback_won

失败状态

• authorization_failed, buyer_approval_failed, capture_failed, refund_failed, chargeback_lost

终端状态

• authorization_void, settled, refund_succeeded, chargeback_won, chargeback_lost, chargeback_expired, cancelled, expired

状态使用指南

对于商户

• 监控 buyer_approval_pending 状态以处理重定向和3DS认证
• 使用 authorization_succeeded 在履约前确认资金已预留
• 在发货前检查 capture_succeeded 以确认支付完成
• 注意 chargeback_pending 以准备争议文档
• 跟踪 refund_* 状态用于客户服务和对账

对于开发者

• 为所有状态变更实现webhook处理器
• 为 buyer_approval_pending 状态设置适当的超时（通常15-30分钟）
• 为 authorization_failed 与 buyer_approval_failed 处理不同的重试逻辑
• 为 refund_* 和 chargeback_* 状态实现适当的对账流程
• 使用终端状态确定交易处理何时完成

常见模式

• 两步支付：authorize → 等待履约 → capture → settled
• 直接支付：数字商品立即 capture → settled
• 预授权：authorize → 如果需要可能 void
• 退款流程：settled → refund_pending → refund_succeeded
• 争议处理：settled → chargeback_pending → 解决