进入微信公众号设置
使用有设置管理权限的账号进入「瓜奇 → 第三方 → 微信设置」，先选中要接入公众号的前端网站，再填写同一公众号的参数。
当前公众号网页授权主要读取 App ID 和 App Secret，用于微信内登录，以及微信支付流程中获取当前微信用户身份。公众号参数不能替代微信支付商户配置，也不能替代微信开放平台扫码登录应用的凭据。
准备公众号和访问环境
先在微信公众平台确认公众号具备所需接口权限。后台字段说明以服务号为接入对象，仅拿到 App ID 并不代表所有功能都已开通。
- 检查公众号的 IP 白名单，将实际发起后端请求的服务器公网出口 IP 按要求加入。
- 按使用场景配置业务域名、JS 接口安全域名和网页授权域名，确保与访客打开的前端一致。
- 如果微信要求域名验证文件，可在瓜奇综合设置中的站点验证文件入口配置。保存后，访问目标域名下的实际文件地址，确认内容可公开读取。
原文提供的公众号接入说明可作为相关接入资料；配置瓜奇本身不要求部署 CloudBase。
填写四个参数
| 字段 | 来源和用途 |
|---|---|
| App ID | 填写公众号的开发者 ID。当前网页授权使用它识别公众号。 |
| App Secret | 填写同一公众号的开发者密钥。当前网页授权与 App ID 配对使用。 |
| Token | 对应公众号消息服务器配置中的 Token。不要填写微信支付 API 密钥或临时获取的 access_token。 |
| EncodingAESKey | 对应公众号消息服务器配置中的消息加解密密钥，不能用 App Secret 或支付密钥代替。 |
Token 和 EncodingAESKey 虽然有保存字段，但当前公众号网页授权代码不读取这两项。填写它们不会自动建立消息接收、自动回复或消息解密服务；需要这些功能时，还应核对具体接入功能和消息服务器地址。
接通实际使用场景
- 保存当前前端的微信公众号参数，确认没有保存或同步错误。
- 需要微信登录时，在「瓜奇 → 登录 → 社交登陆」中开启社交登录，并添加微信平台入口。
- 在微信内打开该前端，点击微信登录，完成公众号网页授权。当前登录回调路径为 /authorize?type=wechat。
- 需要微信外扫码登录时，另外配置社交登录中的微信应用客户端 ID 和密钥；公众号参数不等于扫码应用参数。
- 需要微信支付时，另外完成支付配置并核对相关 AppID。支付身份授权使用 /authorize?type=wechat_payment，不能当作登录回调或消息服务器地址。
验证是否接入成功
使用未登录的测试浏览器，在微信内打开正确前端，检查授权后能否返回原网站并完成登录。网站如果要求补充手机、邮箱或邀请码，还要完成后续步骤，不能只看见授权成功就结束测试。
支付应使用测试订单单独验证。公众号授权成功只证明这一段流程可用，不证明支付商户、支付回调等配置也正确。
按提示排查
- 域名不匹配：检查当前实际访问域名和网页授权域名，以及授权回调返回的前端地址。
- IP 白名单错误：核对后端服务器的公网出口 IP，不要填写本机内网地址。
- 凭据错误：确认 App ID 和 App Secret 来自同一公众号，密钥更新后同步修改瓜奇配置。
- 微信外无法扫码：检查社交登录中的微信应用配置，不要只检查公众号参数。
- 保存后仍使用旧参数：确认修改的是目标前端，检查配置同步提示，必要时使用「刷新前端」。
普通 localhost 不能供微信从公网完成域名验证或访问回调。实际接入测试应使用可访问、已正确配置的域名。