微信配置指引 ← 返回官网
WeChat Setup

微信配置指引

公众号 + 商户号的全流程配置。这一步涉及两个后台、七八个参数,错一个就整条链路不通。按顺序做,别跳步。

00前置条件(不满足就别往下走)

Must
必须是「已认证的服务号」
订阅号不行,个人号不行。只有服务号才有「网页授权」和「微信支付」两个能力。
Must
已有可用的微信支付商户号
在 pay.weixin.qq.com 有商户号,且已完成结算账户验证,能正常收款。
Must
商户号与公众号已关联
两个主体必须是同一家公司,或已完成授权关联。否则拿不到同一个 openid。
Must
域名已备案并已解析
微信要求业务域名完成 ICP 备案,DNS 已指向服务器,HTTPS 证书配好。
最常见的卡点:拿订阅号去接入 网页授权接口会直接报错,整条链走不通,后面配什么都是白费。开始前先确认是服务号且已认证。

01域名对照表(先理清,后面全程要用)

这套系统用四类域名,建议一开始就按这个规划分配子域名。下面以 yimintop.cn 为例:

用途示例填在哪个微信后台
微信授权域名
处理微信登录回调
w.yimintop.cn服务号 → 网页授权域名
支付回调域名
拉起支付、接收支付结果
pay.yimintop.cn商户平台 → JSAPI 支付授权目录
业务域名(可多个)
观众实际看直播、下单
r1.yimintop.cn
r2.yimintop.cn
服务号 → JS 接口安全域名
短链域名(可多个)
分享出去的短链接
a.yimintop.cn无需单独配置(跳转后落到业务域名)
所有域名都不能带 http:// 和路径 微信后台的填写框只认域名:填 w.yimintop.cn,不要填 https://w.yimintop.cn/wx_callback,也不要带结尾斜杠。

02服务号(公众号)配置

登录 mp.weixin.qq.com,用公众号管理员微信扫码。

2.1获取 AppID 和 AppSecret

左侧菜单 › 设置与开发 › 开发 › 基本配置。

参数怎么拿
AppID页面上直接显示,18 位,wx 开头
AppSecret点「重置」生成,只显示一次,立刻复制保存,32 位字母数字
AppSecret 丢了只能重置,重置后旧值立即失效 所有用到它的地方(系统的公众号配置、支付配置)都要同步改成新值,否则全部报 invalid appsecret。
顺手把「IP 白名单」加了 同一页面下方有 IP 白名单。要用素材上传、模板消息这些接口(生成分享图文必须用),得把服务器公网 IP 加进去。不加会报 errcode: 40164。

2.2设置「网页授权域名」

左侧菜单 › 设置与开发 › 公众号设置 › 功能设置 › 网页授权域名。

点「设置」,填授权域名
填 w.yimintop.cn,不带协议和路径。
下载校验文件
微信会生成一个 MP_verify_xxxx.txt,点下载。
把文件放到服务器根目录
交给我们放到站点根目录,系统会自动对外提供访问。
确认文件可访问
浏览器打开 https://w.yimintop.cn/MP_verify_xxxx.txt,能看到文件内容才算成功。
回微信点「确认」
校验通过后保存,域名会出现在列表里。

2.3设置「JS 接口安全域名」

左侧菜单 › 设置与开发 › 公众号设置 › 功能设置 › JS 接口安全域名。把所有业务域名都加上(最多 3 个),比如 r1.yimintop.cn、r2.yimintop.cn。

校验文件和上一步是同一个 MP_verify_*.txt,传过就不用再传。

为什么要配这个 观众在业务域名下打开直播间,页面要调微信 JS-SDK(分享、图片预览等)。域名没配,JS-SDK 会拒绝执行——表现就是分享按钮点了没反应。

2.4把参数填入系统

后台 › 系统配置 › 微信登录认证:

字段填什么
app_id公众号 AppID,wx 开头 18 位
app_secret公众号 AppSecret,32 位
回调域名w.yimintop.cn(不带 https://)
状态设为「启用」
填完先验一次,别急着配支付 手机微信打开一个直播间分享链接,弹出「允许获取你的公开信息」授权页就说明公众号通了。报错就去第四节查表。

03微信支付商户配置

登录 pay.weixin.qq.com,用商户号管理员账号。

这套系统用 API v2 + MD5 签名 只需要 32 位 API 密钥,不需要 APIv3 密钥,也不需要上传 API 证书(apiclient_cert.pem 那一套)。把 APIv3 密钥填进来会签名失败。

3.1确认商户号与 AppID 已关联

商户平台 › 产品中心 › AppID 账号管理,检查列表里有没有你的公众号 AppID。

没关联的后果 支付时报「appid 与 mch_id 不匹配」。微信支付要用公众号的 openid 发起,两者必须绑定。

3.2设置 API 密钥(32 位)

商户平台 › 账户中心 › 账户设置 › API 安全 › API 密钥。

点「设置 API 密钥」
首次是设置,已有则是「修改」。
按提示验证身份
通常要管理员微信扫码 + 手机短信验证码。
输入 32 位密钥
必须严格 32 位字母数字,建议用密码生成器随机生成,务必抄下来。
立刻填进系统
改完旧密钥立即失效,正在进行的支付会全部失败,建议挑没人的时段操作。
API 密钥 ≠ APIv3 密钥 ≠ 商户号 商户号是 10 位数字(要);API 密钥 v2 是 32 位(要,就是它);APIv3 密钥也是 32 位(不要,填了签名失败)。这三个最容易混。

3.3开通「JSAPI 支付」产品

商户平台 › 产品中心 › 我的产品,找到 JSAPI 支付(有的账号叫「公众号支付」)。

err_code=NOAUTH
err_code_des=商户号该产品权限未开通,请前往商户平台>产品中心检查后重试

看到这个不是代码问题,是权限没开,必须去商户平台操作。

3.4设置「JSAPI 支付授权目录」

商户平台 › 产品中心 › 开发配置 › JSAPI 支付 › 支付授权目录。填支付回调域名的根目录,必须带 https:// 和结尾斜杠:

https://pay.yimintop.cn/
这一条最容易错 ✗ pay.yimintop.cn —— 少了 https://
✗ https://pay.yimintop.cn —— 少了结尾斜杠
✗ https://pay.yimintop.cn/topay —— 不能具体到页面
✓ https://pay.yimintop.cn/

支付结果回调地址是 https://pay.yimintop.cn/notify,由系统在发起支付时自动带上,商户平台里不用单独配。

3.5把参数填入系统

后台 › 系统配置 › 支付渠道:

字段填什么
渠道微信支付
商户号10 位数字
AppID必须和公众号配置里的完全一致
API 密钥32 位 v2 密钥(3.2 步设的)
回调域名pay.yimintop.cn(不带 https://)
状态设为「启用」
验证方法:拿 0.01 元的商品试 手机微信打开商品页 → 选规格 → 立即购买 → 弹出输入支付密码的界面就说明通了。付完确认订单状态变「已支付」、回调收到了,再上正式商品。

04常见报错排查

公众号相关

报错原因与处理
redirect_uri 参数错误
授权页白屏
「网页授权域名」没配或配错。域名要完全一致,不能带端口、不能带路径
invalid appsecret
errcode: 40001
AppSecret 填错,或重置过没更新。重新复制填进系统
invalid appid
errcode: 40013
AppID 填错。注意别把商户号填到 AppID 里
48001 api 未经授权公众号没有素材管理权限。确认是已认证服务号,不是订阅号/测试号
invalid ip, not in whitelist
errcode: 40164
服务器 IP 没加进公众号「IP 白名单」
该链接已过期 / 页面顶部红条业务域名没配,或校验文件没传对。到公众号后台「业务域名」重配

支付相关

报错原因与处理
NOAUTH
商户号该产品权限未开通
最常见。商户平台没开「JSAPI 支付」产品,见 3.3
签名错误API 密钥不对:不是 32 位 / 填成了 APIv3 密钥 / 刚改过没更新。核对 3.2
appid 和 mch_id 不匹配商户号与公众号没关联,见 3.1
当前页面的 URL 未注册
支付授权目录错误
授权目录少了 https:// 或结尾斜杠,见 3.4
未找到可用的支付渠道系统的支付渠道没启用,或请求落到了别的服务器

05上线前自检清单

逐项勾掉,全部打勾才算配完。

一分钟 · 微信配置指引 按不到底的报错,发给我们
↑