测试、对账与上线准备
先用测试账户完成创建 Checkout、付款、查询及履约的流程,再按开放状态启用额外能力。在目标测试环境逐项验证以下场景,再决定上线范围。
收款与请求恢复
| 场景 | 预期结果 |
|---|---|
| 正常创建并支付 | 保存真实 Checkout ID 与 URL,服务端查询成功后订单履约一次 |
| 相同键与相同参数重试 | 返回同一首次结果;查询取得最新状态 |
| 相同键但改金额 | 参数不一致错误,不额外生成成功业务操作 |
| 创建响应丢失或服务重启 | 恢复已保存请求,不用新键立即重复收款 |
| 同一订单两个 Checkout 都成功 | 一次履约,额外资金进入独立处理 |
| 前端回跳、伪造成功或提交他人 ID | 不越过订单授权和服务端确认 |
| 到期、关闭或确认未及时达到 | 正确处理 failed 与原入口,不误把迟到资金当原单成功 |
paidOver / paidPartial | 独立处理异常,不覆盖既有支付事实 |
| 限流、超时、无效 JSON | 保留未知状态并退避,不改成未付款 |
Webhook 开通后的验收
确认签名头与原始请求体算法符合签名规则,再验证错误 secret、过期与过早时间戳、body 改动、重复事件、处理失败及延迟通知。接收后先持久化事件;返回成功后依靠自己的任务重试业务处理。即使事件重复或顺序变化,订单仍只能履约一次。
当前通知能力待确认,不要只因为本地验签示例通过,就关闭服务端查询补偿。
退款与归集开通后的验收
- 退款:确认付款明细可查询,精确区分 finalized 与可退额度;验证部分退款、全额退款、进行中额度占用、签名拒绝和取消竞态。
- 归集:确认目标环境真正支持创建和钱包执行;验证可兼容归集项、幂等创建、钱包拒签、发送后响应丢失、状态回退与最终确认。
- 钱包交易使用最新
next_action,不手动改from、to、data或value;保存发送结果后恢复原任务。
日常对账
分别记录订单、Checkout、付款明细、退款和归集任务。它们的状态和金额不是可相加替代的同一张账。定期查询未决状态和异常,保留 Request-Id 与自己的业务操作 ID,按规定保管资金相关记录,日志不写密钥与完整私密凭据。
上线前确认目标环境可调用、账户获准使用,并完成所依赖资金流程的端到端测试。