先分清是哪种情况
| 你的情况 | 看哪一节 |
|---|---|
| 用的是现成系统(发卡网、面板、中转站),没有自己写代码 | 只可能是配置问题,看「现成系统:检查配置」 |
| 自己写代码对接,下单时网关提示验签失败 | 看「自己写代码:对照签名规则」 |
| 下单正常,但收到通知后自己的系统验签不过 | 看「通知验签失败」 |
现成系统:检查配置
- 重新复制一次
key粘贴保存,确认前后没有空格或换行。 - 确认
pid和key来自同一个接入应用,不要把两个应用的参数混着填。 - 确认密钥填在了对的输入框里。例如旧版独角数卡,密钥要填在「商户密钥」,而「商户 KEY」填的是下单地址。
- 如果密钥重置过,旧密钥已经失效,所有用到它的系统都要换成新的。
各系统每一栏具体填什么,见对应教程:独角数卡、异次元发卡、New-API、One-Hub、Xboard / V2Board。
自己写代码:对照签名规则
签名只有四步,逐步对照:
- 筛选:剔除
sign、sign_type,以及值为空的参数。 - 排序:按参数名 ASCII 升序(a→z)排列。
- 拼接:拼成
k1=v1&k2=v2,值不做 URL 编码。 - 签名:在末尾直接追加商户密钥,中间没有
&key=之类的分隔,再取 MD5 的 32 位小写。
用下面这组数据自测。密钥是 a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6,如果你的代码算不出同样的结果,问题就在签名函数里:
待签名串(末尾再直接拼上密钥):
clientip=1.2.3.4&money=1.00&name=VIP会员¬ify_url=https://shop.com/notify&out_trade_no=MCH20260728001&pid=100001&return_url=https://shop.com/return&type=alipay
MD5 结果:
77c46b1a2cb7063f4d01003379863f5e| 常见错误 | 说明 |
|---|---|
| 对参数值做了 URL 编码再签名 | 最常见。中文、://、& 都要用原文参与签名,编码只发生在实际发送请求时 |
| 把空值参数算进了签名 | 传了 param= 这样的空参数,就不能让它出现在签名串里 |
密钥前加了 &key= | 易支付是把密钥直接拼在最后一个值后面,没有任何分隔符 |
| MD5 结果用了大写 | 要 32 位小写 |
| 发送的值和签名的值不一样 | 商品名带首尾空格或尖括号、金额签名时是 1.00 发送时变成 1,都会导致偶发失败 |
通知验签失败
异步通知是平台用 GET 请求你的 notify_url,参数在地址的 query 里。验签规则和下单时一样,另外注意三点:
- 用 URL 解码后的参数值验签。多数框架取参数时已经自动解码,直接用即可,不要自己再去解析原始地址。
- 只用平台发来的参数参与验签。你的框架或伪静态规则自己加进来的参数(例如路由参数)不能算进去。
- 同样要剔除
sign、sign_type和空值参数。
还是不行
把不含密钥的待签名串和你算出的 sign 发给官方客服比对。不要在群里或截图里暴露密钥;如果已经暴露,请让客服重置。
其他对接文档
获取商户 ID 与密钥
联系官方客服开通接入应用,网关地址、pid 与 key 由客服直接提供,专人协助联调。
联系官方客服