跳到主要内容

支付状态、确认与资金异常

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 与付款明细的开放范围见状态表。