下单失败时，先保存接口返回的错误码和提示，再按请求链路逐项核对。不要只看页面是否跳转，也不要把包含私钥或完整签名的请求日志发到公开渠道。
先收集这几项信息
- 请求时间、使用的接口地址和接口版本。
- 商户ID、商户订单号、支付类型和金额（可脱敏）。
- HTTP响应状态以及接口响应中的
code、msg。 - 是否已生成平台订单号；若请求超时，先用订单查询接口确认订单状态，再决定是否重新下单。
常见问题速查
| 现象 | 优先检查 |
|---|---|
| 商户ID或商户信息错误 | 确认使用的是当前账号的商户ID，账号状态正常，接口版本与商户配置相符。 |
| 签名验证失败 | 核对RSA或MD5接口版本、参与签名的字段、参数值编码和密钥。按签名错误排查教程逐项检查。 |
| 支付类型无效或不可用 | 核对请求中的支付类型是否与支付方式列表一致，并确认该商户当前可以使用该方式。 |
| 支付域名未授权 | 确认发起支付的网站域名已在商户中心“授权域名”提交，且状态显示“正常”。 |
| 参数缺失或格式不符 | 按所用接口文档核对必填字段、金额格式、商户订单号和回调地址。商户订单号应能唯一识别本地订单。 |
| 请求超时或页面没有结果 | 先查询该商户订单号对应的支付状态。确认原请求未成功前，不要直接创建新的本地订单或重复扣款。 |
建议的排查顺序
- 确认调用的是正确的下单接口和版本。
- 检查商户ID、必填参数、金额和支付类型。
- 检查域名授权状态及通知、返回地址是否填写正确。
- 最后核对签名原文、编码和密钥；签名问题参考签名规则。
- 发生超时后通过查单确认平台状态，再决定是否重试。
成功判断与安全记录
不要仅凭用户返回页面或HTTP请求完成，就把本地订单标记为已支付。应通过验签后的支付结果通知或订单查询核对订单号、金额和状态。记录排查信息时，删除商户私钥、敏感参数和用户个人信息。
不同接口版本和支付类型的错误提示可能不同。以实际响应和当前开发文档为准；不要照搬其他版本的参数或签名示例。