易支付验签失败怎么办:原因与排查步骤

「验签失败」是易支付对接里最常见的报错,原因几乎总是这四类之一:密钥不对、参数值被 URL 编码了、空值参数被算进了签名、密钥拼接方式不对。本页按从易到难的顺序排查。

  • 验签失败
  • MD5 签名
  • 易支付 V1
  • 更新于

先分清是哪种情况

你的情况看哪一节
用的是现成系统(发卡网、面板、中转站),没有自己写代码只可能是配置问题,看「现成系统:检查配置」
自己写代码对接,下单时网关提示验签失败看「自己写代码:对照签名规则」
下单正常,但收到通知后自己的系统验签不过看「通知验签失败」

现成系统:检查配置

  1. 重新复制一次 key 粘贴保存,确认前后没有空格或换行。
  2. 确认 pid 和 key 来自同一个接入应用,不要把两个应用的参数混着填。
  3. 确认密钥填在了对的输入框里。例如旧版独角数卡,密钥要填在「商户密钥」,而「商户 KEY」填的是下单地址。
  4. 如果密钥重置过,旧密钥已经失效,所有用到它的系统都要换成新的。

各系统每一栏具体填什么,见对应教程:独角数卡、异次元发卡、New-API、One-Hub、Xboard / V2Board。

自己写代码:对照签名规则

签名只有四步,逐步对照:

  1. 筛选:剔除 sign、sign_type,以及值为空的参数。
  2. 排序:按参数名 ASCII 升序(a→z)排列。
  3. 拼接:拼成 k1=v1&k2=v2,值不做 URL 编码。
  4. 签名:在末尾直接追加商户密钥,中间没有 &key= 之类的分隔,再取 MD5 的 32 位小写。

用下面这组数据自测。密钥是 a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6,如果你的代码算不出同样的结果,问题就在签名函数里:

待签名串(末尾再直接拼上密钥):
clientip=1.2.3.4&money=1.00&name=VIP会员&notify_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 里。验签规则和下单时一样,另外注意三点:

  1. 用 URL 解码后的参数值验签。多数框架取参数时已经自动解码,直接用即可,不要自己再去解析原始地址。
  2. 只用平台发来的参数参与验签。你的框架或伪静态规则自己加进来的参数(例如路由参数)不能算进去。
  3. 同样要剔除 sign、sign_type 和空值参数。

还是不行

把不含密钥的待签名串和你算出的 sign 发给官方客服比对。不要在群里或截图里暴露密钥;如果已经暴露,请让客服重置。

其他报错见 排错指引;协议细节见 签名算法 与 异步通知。

其他对接文档

获取商户 ID 与密钥

联系官方客服开通接入应用,网关地址、pid 与 key 由客服直接提供,专人协助联调。

联系官方客服