首页 › 教程中心 › 支付回调失败排查

支付回调失败排查方法

发布并更新于 2026年10月26日

先确认订单是否已经到账，再从“支付服务能否访问回调地址、业务端能否正确验签、最终是否返回纯文本 success”三个层次排查，可以快速缩小问题范围。

一、先判断故障发生在哪一段

• 订单仍等待支付：优先检查安卓监听、到账通知和金额匹配。
• 订单显示通知失败：到账已确认，问题集中在业务回调地址或响应。
• 订单完成但业务未发货：检查业务端订单更新、事务和幂等逻辑。

二、检查回调地址

1. 确认创建订单传入的 notifyUrl 是否正确；它会优先于后台默认地址。
2. 从公网直接访问域名，检查 DNS、HTTPS 证书和防火墙。
3. 回调接口不要依赖登录态、验证码或浏览器 Cookie。
4. 若 URL 已有查询参数，业务框架应正确解析后续参数。

三、确认请求方式和字段

蓝鲸支付异步通知使用 GET，请确认路由允许 GET 请求。字段包括 payId、param、type、price、reallyPrice 和 sign。不要只读取 JSON 请求体。

四、逐字符核对签名

md5(payId + param + type + price + reallyPrice + 通讯密钥)

• 字段顺序必须一致，中间没有分隔符。
• param 即使为空也要按空字符串参与拼接。
• 区分原订单金额 price 与实际支付金额 reallyPrice。
• 检查密钥是否与创建订单时使用的后台配置相同。
• 避免金额在解析后被格式化成不同字符串再参与验签。

五、返回内容必须准确

验签和业务处理成功后，响应体应为小写纯文本：

success

不要返回 {"code":1}、Success、HTML 页面或额外调试信息。检查框架是否统一包装了响应，代理层是否插入错误页，以及异常是否导致 HTTP 500。

六、检查业务订单处理

验签成功后还应校验订单存在、尚未完成、支付方式和金额合理。建议先开启数据库事务，按唯一订单号执行条件更新，再发放权益。回调可能重复到达，重复请求必须返回成功但不能重复发货。

七、建立可对照的日志

支付服务日志记录平台订单号、商户订单号、目标 URL、响应状态和响应摘要；业务日志记录接收时间、订单号、验签结果、更新行数和最终响应。密钥与完整签名原文应脱敏。

八、快速检查清单

• 回调域名可公网访问且证书有效。
• 接口允许 GET，不要求登录。
• 六个字段读取完整，签名顺序正确。
• 金额字符串未被意外改写。
• 订单更新幂等，异常会回滚。
• 成功后仅输出 success。