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.cnr2.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」,填公众号 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 支付(有的账号叫「公众号支付」)。
- 状态「已开通」→ 跳过
- 显示「未开通」→ 点开通,按提示完成(一般 1~3 个工作日审核)
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 appsecreterrcode: 40001 | AppSecret 填错,或重置过没更新。重新复制填进系统 |
invalid appiderrcode: 40013 | AppID 填错。注意别把商户号填到 AppID 里 |
| 48001 api 未经授权 | 公众号没有素材管理权限。确认是已认证服务号,不是订阅号/测试号 |
invalid ip, not in whitelisterrcode: 40164 | 服务器 IP 没加进公众号「IP 白名单」 |
| 该链接已过期 / 页面顶部红条 | 业务域名没配,或校验文件没传对。到公众号后台「业务域名」重配 |
支付相关
| 报错 | 原因与处理 |
|---|---|
| NOAUTH 商户号该产品权限未开通 | 最常见。商户平台没开「JSAPI 支付」产品,见 3.3 |
| 签名错误 | API 密钥不对:不是 32 位 / 填成了 APIv3 密钥 / 刚改过没更新。核对 3.2 |
| appid 和 mch_id 不匹配 | 商户号与公众号没关联,见 3.1 |
| 当前页面的 URL 未注册 支付授权目录错误 | 授权目录少了 https:// 或结尾斜杠,见 3.4 |
| 未找到可用的支付渠道 | 系统的支付渠道没启用,或请求落到了别的服务器 |
05上线前自检清单
逐项勾掉,全部打勾才算配完。
一分钟 · 微信配置指引
按不到底的报错,发给我们