开发者调试
四个调试工具面向管理员与对接方:不写代码、在页面上发起真实调用,验证配置与签名是否正确。菜单路径:开发调试。
调试工具使用真实的商户与应用配置发起调用(不是沙箱模拟器),产生的订单是真实订单,验证后记得关单或退款。
支付调试(普通)
模拟商户调用统一支付接口发起一笔支付,验证「密钥配置 + 签名 + 路由 + 通道商户」整条链路:
- 设置商户私钥:填入商户的 RSA 私钥(仅保存在本浏览器,换电脑需重填);
- 选路由模式:
- 跟随通道路由:选商户 + 应用 + 支付方式,按通道路由解析——验证路由配置首选;
- 直接指定:选商户 + 通道商户 + 支付能力,跳过路由——隔离排查通道商户本身的问题;
- 填订单:订单号可一键生成,金额单位为分;JSAPI / 小程序方式需先填 openId(用认证调试获取);付款码场景填 authCode 后支付方式可留空(按码前缀自动识别微信 / 支付宝 / 银联);
- 提交支付:浏览器本地签名后直调接口,结果弹窗按返回形态渲染——跳转链接 / 二维码扫码支付、JSAPI 参数用 JSON 查看;业务失败(签名错、参数错)也会弹窗展示错误码。
高级参数(同步跳转地址、附加参数、限制支付类型如禁信用卡、扩展参数 JSON)按需展开。
网关支付调试
验证网关支付(统一收银台 / 聚合扫码)的预下单:选网关类型(收银台 / 聚合扫码)→ 商户 + 应用 → 订单信息 → 提交预下单,结果页给出落地页链接与小程序链接(各带二维码,可直接扫码体验收银台全流程)。
签名调试
对接方排查签名问题的独立工具,不依赖商户配置:
| 页签 | 输入 | 输出 |
|---|---|---|
| 签名生成 | 待签名参数 JSON + RSA 私钥 | 待签名字符串 + 签名值(可复制) |
| 签名验证 | 参数 JSON(不含 sign)+ 签名值 + RSA 公钥 | 通过 / 不通过 |
商户回调验签失败、接口报签名错误时,用此工具比对双方的签名串拼接是否一致(多为参数排序或编码差异)。
认证调试
验证 OAuth 授权链路能否取到 openId(JSAPI / 小程序支付的前置):
- 认证类型:支付宝 H5、微信公众号、微信支付、抖音 H5、抖音支付(小程序 openId 调试已移到收银台小程序);
- 微信支付 / 抖音支付需选商户与对应应用(平台应用或商户应用);其余类型直接使用平台级配置的凭据;
- 点「生成授权链接」出二维码,手机扫码完成授权,页面每 3 秒轮询结果,成功后展示 openId / userId / accessToken(可复制,粘到支付调试的 openId 字段用)。
二维码授权成功即失效,重复测试请重新生成。
常见排障路径
「JSAPI 支付报 openId 与应用不匹配」→ 认证调试取一次 openId,确认所用应用与支付时传的 channelAppId 同源;「下单报签名错误」→ 签名调试比对签名串;「下单报无可用通道商户」→ 回通道路由看命中预览。