订单状态
支付相关接口(创建交易、交易查询、支付结果通知)中的 status 字段表示订单当前状态。业务侧请根据 status 做分支处理(如仅当 Success 时发货、入账)。不同接口返回的状态枚举可能不同,以各接口文档为准。
状态枚举
以下枚举常见于交易查询、支付结果通知等接口;创建交易同步应答状态请以 创建交易 · 应答说明 为准。
| 状态值 | 说明 | 常见出现场景 |
|---|---|---|
Processing | 处理中,待用户支付 | 查询/通知中:已创建成功,等待用户完成支付流程 |
Success | 支付成功 | 订单已完成支付 |
Failed | 失败 | 订单创建失败,或支付渠道返回失败 |
Refunded | 已全额退款 | 订单支付成功后,已通过退款接口完成全额退款 |
Partial_Refunded | 已部分退款 | 订单支付成功后,已完成一笔或多笔部分退款,仍保留部分有效金额 |
状态说明
Processing(处理中)
创建订单已成功,平台已生成支付链接并返回给商户。商户将用户引导至该支付链接,等待用户完成支付流程。在此状态下需通过异步回调或查询接口轮询,直至订单变为 Success、Failed 或 Expired。
Success(支付成功)
订单已完成支付。仅当回调或查询结果为 Success 时再执行上述业务逻辑。
Failed(失败)
- 订单创建失败:调用创建接口时因风控、参数错误等原因未成功,直接返回
Failed。 - 支付渠道返回失败:用户支付被拒、余额不足、通道异常等,在回调或查询中会看到
Failed。
收到 Failed 后不应再等待该订单变为成功,可根据需要提示用户或重新发起支付。
Refunded(已全额退款)
订单曾经支付成功,后续通过退款接口已对原订单金额做全额退款。
Partial_Refunded(已部分退款)
订单曾经支付成功,后续对原订单金额进行了一次或多次部分退款,仍有剩余金额未退款。
状态与接口对应关系
| 接口 | 可能返回的状态 |
|---|---|
| 创建交易 | Success、Failed |
| 交易查询 | Processing、Success、Failed、Refunded、Partial_Refunded |
| 支付结果通知 | Success、Failed、Refunded、Partial_Refunded 等终态 |