跳到主要内容
版本:当前指南

处理迟到、多付与少付

能力状态与处理原则​

当前可通过 Checkout 查询读取主状态和资金异常;逐笔付款明细及退款仍待确认开放。无法取得明细时先建待核对记录,不推算可退额度,不承诺自动退款。

主状态回答“会话是否满足收款条件”,exception_status 回答“资金是否有异常”。两者独立;succeeded/failed 不因后续到账、异常或售后退款翻转。异常为空也不代表已经付款。

发现异常后的共同步骤​

  1. 暂停该订单自动追加交付或再次催款,找到业务订单及全部 Checkout ID。
  2. 从商户服务端查询原会话,核对环境、金额、币种、主状态、异常和失败原因;记录查询时间。
  3. 检查是否已经履约、退款或发送资金交易,避免另一位同事重复处理。
  4. 如付款明细已获准开放,核对实际付款项及可退额度;否则将未知明细交由已核实的对接人核查。
  5. 保存处理决定、负责人及下次复核时间。付款截图可以帮助定位,不作为确认或退钱依据。

按场景处理​

场景判断与动作
processing 长时间等待已检测到上链,继续核对确认进度;不要求再次付款,不按等待秒数强行记成功
failed 后客户称到账核对到期或关闭原因及迟到资金;保留失败主状态,单独处理资金,不自动履约或另收一次
paidOver存在额外且未退净资金,可能来自重复或迟到支付;正常订单是否先履约按商户规则决定,额外款单独售后
paidPartial原认定正常收款不再满足资金要求;暂停或复核未完成履约,持续查询,不直接把另一笔款拿来替代
同订单两个 Checkout 成功核对所有尝试,只交付约定的一份;额外资金独立处理
客户说少付但无异常标签先核对主状态及当前记录,不能仅凭客户说法生成补款或退款操作
查询超时或加载失败结果未知,恢复原会话查询;不认定为未付款

同时满足多付和缺款时优先显示 paidPartial。正常售后退款本身不构成缺款;异常清除也不证明售后已完成。

迟到与确认速度​

有效期包含等待确认的时间。默认 low 要求原生 finalized;medium 要求 safe;high 是成功执行并入块。更快确认存在更高后续风险,不能用固定等待分钟数或统一区块数代替这些原生确认等级。变更策略前由业务与技术共同评估商品是否可追回。

关闭异常记录前​

确认原单是否履约、额外资金最终去向、退款任务是否真正成功及是否仍有未决会话。退款条件见退款指南,重复履约防护见订单与对账。没有明确结果时保留待核对,不用“已解决”掩盖未知资金。