跳到主要内容

测试、对账与上线准备

先用测试账户完成创建 Checkout、付款、查询及履约的流程,再按开放状态启用额外能力。在目标测试环境逐项验证以下场景,再决定上线范围。

收款与请求恢复​

场景预期结果
正常创建并支付保存真实 Checkout ID 与 URL,服务端查询成功后订单履约一次
相同键与相同参数重试返回同一首次结果;查询取得最新状态
相同键但改金额参数不一致错误,不额外生成成功业务操作
创建响应丢失或服务重启恢复已保存请求,不用新键立即重复收款
同一订单两个 Checkout 都成功一次履约,额外资金进入独立处理
前端回跳、伪造成功或提交他人 ID不越过订单授权和服务端确认
到期、关闭或确认未及时达到正确处理 failed 与原入口,不误把迟到资金当原单成功
paidOver / paidPartial独立处理异常,不覆盖既有支付事实
限流、超时、无效 JSON保留未知状态并退避,不改成未付款

Webhook 开通后的验收​

确认签名头与原始请求体算法符合签名规则,再验证错误 secret、过期与过早时间戳、body 改动、重复事件、处理失败及延迟通知。接收后先持久化事件;返回成功后依靠自己的任务重试业务处理。即使事件重复或顺序变化,订单仍只能履约一次。

当前通知能力待确认,不要只因为本地验签示例通过,就关闭服务端查询补偿。

退款与归集开通后的验收​

  • 退款:确认付款明细可查询,精确区分 finalized 与可退额度;验证部分退款、全额退款、进行中额度占用、签名拒绝和取消竞态。
  • 归集:确认目标环境真正支持创建和钱包执行;验证可兼容归集项、幂等创建、钱包拒签、发送后响应丢失、状态回退与最终确认。
  • 钱包交易使用最新 next_action,不手动改 from、to、data 或 value;保存发送结果后恢复原任务。

日常对账​

分别记录订单、Checkout、付款明细、退款和归集任务。它们的状态和金额不是可相加替代的同一张账。定期查询未决状态和异常,保留 Request-Id 与自己的业务操作 ID,按规定保管资金相关记录,日志不写密钥与完整私密凭据。

上线前确认目标环境可调用、账户获准使用,并完成所依赖资金流程的端到端测试。