Skip to main content

Documentation Index

Fetch the complete documentation index at: https://help.jinshuju.net/llms.txt

Use this file to discover all available pages before exploring further.

适用场景
  • 配置「微信支付直连商户号」时遇到错误提示;
  • 表单付款时支付失败;
  • 微信商户号绑定异常。

签名错误

具体错误表现:签名错误。 问题原因
  • 商户支付密钥填写错误;
  • 密钥格式不符合要求;
  • 商户号与密钥不匹配。

解决方案

步骤 1:验证密钥正确性

  1. 登录微信支付商户平台
  2. 导航至:账户中心API安全API v2密钥
  3. 查看或重新设置 32 位密钥。
⚠️ 重要提示
  • 密钥必须为 32 位字符;
  • 推荐使用随机密码生成器生成;
  • 自编密钥安全强度不足可能导致支付失败。
步骤 2:核对商户信息
  • 确认商户号填写正确(10 位纯数字);
  • 确认商户名称与实际一致。

步骤 3:验证匹配关系

  • 确保商户号与密钥一一对应;
  • 避免将 A 商户号配置 B 商户的密钥。

步骤 4:重置密钥(如仍有问题)

  1. 在商户平台重新生成新密钥;
  2. 更新系统中的密钥配置;
  3. 等待 5 分钟后测试。

AppID 与 mch_id 或商户号不匹配

顶部提示 底部提示 错误表现:「appid 与 mch_id 不匹配」 或「商户号 与 appid 不相符」。 问题原因:微信服务号未与商户号正确关联。

解决方案

方法 A:确认关联状态

  1. 商户平台端检查
  1. 公众平台端检查

方法 B:建立关联

  1. 进入商户平台:产品中心APPID授权管理
  2. 选择已关联账号申请账号关联
  3. 输入公众号 AppID 完成关联;
详细配置文档:微信支付商户号关联 AppID。

方法 C:重置配置

如确认关联无误但仍报错:
  1. 删除现有微信支付配置;
  2. 路径:系统设置第三方服务微信公众号与支付
  3. 重新配置微信支付,详细文档情参考文档:「金数据绑定微信直连商户号配置」。

当前商户号暂不支持关联该类型的 AppID

问题原因:AppID 对应的不是认证服务号。

解决方案

  • 确认使用的是已认证的微信服务号;
  • 订阅号、未认证服务号均不支持;
  • 如需认证,请前往微信公众平台申请。

商户号该产品权限未开通

错误表现
  • 商户号该产品权限未开通
  • 该商户号未开通公众号支付

解决方案

  1. 确认支付权限
    • 登录微信支付商户平台查看产品中心的权限状态,确认 JSAPI 支付和 Native 支付是否开通。
  1. 完成 APPID 授权
    • 商户平台:产品中心APPID授权管理
    • 完成授权绑定。
  2. 等待生效
    • 授权成功后需等待 24 小时;
    • 期间可能出现间歇性失败。

商户号该产品权限预开通中,请等待产品开通后重试签名错误

错误表现商户号该产品权限预开通中

解决方案

  • 选项 1:等待 H5 支付权限开通(需 1-3 个工作日);
  • 选项 2:取消勾选 H5 支付选项,仅使用服务号支付。

商户号参数格式有误

错误表现
  • 商户号参数格式有误
  • 正则表达式校验失败
问题原因:商户号包含非数字字符

解决方案

  1. 登录商户平台确认商户号;
  2. 路径:账户设置账户信息微信支付商户号
  3. 确保输入的是 10 位纯数字,无空格或特殊字符。

服务号认证信息不存在

错误类型
  • 服务号认证信息不存在
  • 绑定微信公众号失败

解决方案

错误场景解决方法
扫码后刷新页面重新扫码,避免中途刷新
非服务号类型确认使用认证服务号
管理员权限不足使用超级管理员微信扫码

此商家的收款功能已被限制

错误表现此商家的收款功能已被限制 可能原因
  • 长期未交易被冻结;
  • 企业信息变更;
  • 被投诉冻结。

解决方案

  1. 登录微信商户平台查看具体原因。
  2. 按平台提示完成相应操作:
    • 补充资料;
    • 完成验证;
    • 处理投诉。
  3. 如无法自行解决,联系微信客服:95017-2 。

受理机构必须传入 sub_商户号

错误表现受理机构必须传入sub_商户号 问题说明:使用了服务商类型商户号。

解决方案

  • 确认使用普通商户类型商户号;
  • 服务商类型暂不支持配置。

其他常见问题

Q1:配置正确但仍然报错怎么办?

:请按以下顺序排查:
  1. 清除浏览器缓存;
  2. 等待 5-10 分钟后重试;
  3. 删除配置重新添加;
  4. 确认是否有未生效的更改(如刚修改密钥)。

Q2:如何判断我的商户号类型?

:登录微信商户平台,「账号中心——商户信息」查看商户号信息:
  • 普通商户:支持直接配置;
  • 服务商:需要特殊处理,暂不支持。