支付状态、确认与资金异常
Checkout 表示一次收款会话。HTTP 请求成功、付款上链、Checkout 成功、商户订单已履约以及资金已归集是不同事实。
主状态
| 状态 | 含义 | 商户处理 |
|---|---|---|
open | 等待付款,尚未检测到付款上链 | 服务端查询,允许付款人在有效期内恢复原入口 |
processing | 已检测到付款上链,等待指定确认要求 | 展示确认进度,不引导继续付款 |
succeeded | 付款在到期或关闭前达到所选 transaction_speed 的确认要求 | 核对业务订单、金额、币种与异常后幂等履约 |
failed | 到期或主动关闭前未满足收款条件 | 根据 failure_reason 处理,不把迟到到账改成原会话成功 |
succeeded 与 failed 是终态,不因退款、后续到账或异常变化而翻转。用户关闭页面或返回商户不等于关闭 Checkout;failure_reason=closed 才说明平台处理了商户主动关闭。
选择确认速度
transaction_speed | 成功门槛 |
|---|---|
high | 交易成功执行并入块 |
medium | 达到原生 safe 确认 |
low | 达到原生 finalized,默认 |
速度越快,后续付款不再满足要求的风险越高。有效期包含等待确认的时间;即使交易已入块,截止前未达到所选门槛也会失败。选择与商品可追回程度匹配的策略,不把等待秒数当成指定原生等级。
独立处理异常
exception_status | 含义 | 应用应做什么 |
|---|---|---|
null | 当前无资金异常,也可能尚未付款 | 仍须核对主状态 |
paidOver | 有额外且尚未退净的到账,包括重复或迟到资金 | 保留原支付事实,对额外资金进入售后流程 |
paidPartial | 原认定正常收款不再满足资金要求 | 按业务规则暂缓/检查履约;持续查询,不用其他到账擅自替代 |
两个异常同时存在时优先显示 paidPartial。正常售后退款本身不构成缺款异常;异常清除不代表商户已经完成售后。
关闭、重试与新会话
关闭当前 open Checkout 使用关闭接口和独立幂等键。已成功会话不能关闭成未付款。原会话终止后创建新会话是新的业务决策,不能拿新幂等键作为网络超时后的无条件重试。
同订单多个会话要在本地做订单级履约去重。任何一个请求查询失败都不改变既有支付事实。当前可先用服务端查询补偿;Webhook 与付款明细的开放范围见状态表。