深浅模式
微信（小程序 / 公众号 / 支付）
功能说明
配置微信小程序、公众号与微信支付，使用户可通过微信登录、接收模板消息并完成在线支付。
前置条件
- 站点已完成初始化，系统设置 → 网站信息 中填写的域名与生产环境 HTTPS 地址一致。
- 已在微信公众平台注册小程序、公众号（如需 H5 微信登录）。
- 已在微信支付商户平台开通收单，并将小程序 AppID 与商户号绑定。
- 您的账号具备 系统配置 的修改权限（超级管理员，或在 系统设置 → 账号权限 中已分配相应权限）。
管理后台配置步骤
1. 微信小程序
路径：系统设置 → 系统配置 → 微信小程序 Tab
| 配置项 | 填写来源 |
|---|---|
| AppID | 微信公众平台 → 开发管理 → 开发设置 |
| AppSecret | 同上 |
| 原始 ID | 部分能力需要时填写 |
填写后点击 「立即获取 Token」，显示成功即表示与微信服务器连通。
2. 微信公众号
路径：系统设置 → 系统配置 → 微信公众号 Tab
填写公众号 AppID、AppSecret 等参数。用于 H5 网页微信登录与公众号模板消息。
配置完成后同样可测试 Token。
3. 微信支付
路径：系统设置 → 系统配置 → 微信支付 Tab
完整逐步配置（商户平台绑定 AppID、API 证书、回调 URL、后台逐字段、提现打款、验收 checklist）请参阅：
此处仅列回调地址：
text
https://你的域名/api/payment/wx-notify请将 你的域名 替换为 网站信息 中的正式 HTTPS 域名。
4. 开启用户微信登录
路径：区域管理 → 用户配置
在目标区域（或「平台默认」）中开启：
- 允许微信小程序登录
- 允许微信公众号登录（如需 H5 登录）
未开启时，即使用户端有微信入口，登录也会被拒绝。
区域配置
微信登录按 区域 控制，不在系统配置 Tab 里单独开关。
| 菜单 | 作用 |
|---|---|
| 区域管理 → 用户配置 | 各区域是否允许小程序 / 公众号登录 |
| 区域管理 → 区域列表 | 编辑区域基本信息；关闭私信等与本功能间接相关的项 |
平台默认行（region_id=0）作为兜底；各区域可单独覆盖。
验证是否生效
- Token 测试：系统配置页点击「立即获取 Token」，两项均成功。
- 小程序登录：在已开启登录的区域，用小程序尝试微信一键登录，能进入首页。
- 支付：发起一笔小额测试订单，支付成功后 财务管理 → 资金交易 可见流水。
- 回调：系统监控 → 系统状态 中支付相关状态正常，无持续验签失败告警。
常见问题
Token 获取失败
- 检查 AppID / AppSecret 是否复制完整、无多余空格。
- 确认服务器能访问微信 API（防火墙 / 代理未拦截）。
用户无法微信登录
- 确认 区域管理 → 用户配置 中对应登录方式已开启。
- 小程序：确认小程序 AppID 与代码包一致；体验版需加入体验成员。
支付成功但订单未更新
- 核对商户平台回调 URL 是否与上文完全一致（含
https、路径大小写）。 - 确认 API 证书、平台公钥与商户平台一致；反向代理勿缓存 POST 请求。
H5 公众号登录跳转失败
- 公众号后台 网页授权域名 须与站点域名一致且已备案。