交付出件箱

微信支付 JSAPI 接入 · 长官侧准备清单

2026-08-14 · dev2 云机 · 门店签约并行化 v2（微信支付版）
本清单全部条目来自微信支付官方文档知识库真读原文，每条标注出处；未 verify 的单独标注。
用法：您照 A→B→C 顺序办，我同步开发批 A，互不等待。

问题	答案
要等开发完再配商户号吗？	不用。除了「支付授权目录」需要一个 URL，其余全部与代码无关
那「支付授权目录」呢？	也不用等 —— 官方允许只配到域名级（见 C-1）。我上一轮说"要等我给页面 URL"，读原文后更正：配到域名即可
最优做法	您走 A→B→C，我同时写批 A（价格管理）。等您办完，批 B（支付）前置就齐了

#	事项	在哪办	卡点
A-1	公众号必须是已认证的服务号（或政府/媒体类公众号）	公众平台	🔴 订阅号申请不到 JSAPI 支付权限。此条不成立，整个方案推翻
A-2	商户号申请 JSAPI 支付产品权限	商户平台（超管）	商户号开了 ≠ 有 JSAPI 权限，要单独申请
A-3	appid ↔ mchid 绑定：商户平台发起授权 → 再去公众平台点确认	两个平台各一次	🔴 双向的，只做一半最容易卡住
A-4	配置技术负责人账号并设为安全联系人	商户平台（超管）	后面 B 组的证书/密钥都归他下载管理

出处：开发接入准备-4015423216

#	事项	一次性风险
B-1	商户 API 证书（含私钥 + 证书序列号）	⚠️ 只能下载一次，丢了/泄露只能重新申请
B-2	APIv3 密钥	⚠️ 设完商户平台看不到，丢了只能重设。🔴 不设这个，微信压根不发回调通知（官方原文）
B-3	微信支付公钥 + 公钥 ID	官方推荐用公钥，别选平台证书（平台证书 5 年一换，多一道运维负担）

出处：开发必要参数说明-4013070756、回调通知注意事项-4012075420 第 3 节

C-1 支付授权目录（商户平台 → 产品中心 → 开发配置，设后约 5 分钟生效）

可以只配到域名（如 https://xxx.tongban.love/），不校验后面的多级目录 —— 所以不用等我的页面路由
硬规则：必须 https:// 开头 · 域名须已 ICP 备案 · 必须以 / 结尾 · 大小写要和实际页面完全一致 · 不支持 IP · 一个商户号最多 5 个
出处：配置JSAPI支付授权目录-4013287088

C-2 回调地址 notify_url

必须 https 开头的完整全路径（只有域名会报错）· 公网可达 · 不能带参数 · 不能内网 IP/localhost · 域名须 ICP 备案
具体路径我开发时给您，但域名和 HTTPS 证书现在就得备好
出处：回调通知注意事项-4012075420

C-3 防火墙 / 安全组 / WAF 放行微信回调 IP 段

C-4 公众平台配置「网页授权域名」

官方原文：「同一个用户在不同的公众号下也对应不同的 openid」（开发必要参数说明-4013070756）。

所以必须确认：现网智脑那个授权落地页（方案里说要照抄的 seat-wx-auth-landing）用的 appid，和这次要绑定支付的 appid 是不是同一个。

需要交给我的共 6 项：mchid · appid · 商户 API 证书私钥 · 证书序列号 · APIv3 密钥 · 微信支付公钥 + 公钥 ID

🔴 交付纪律（重要）

立即开工：批 A 价格管理（零依赖，不碰支付）
批 B（支付）动手前，我会先按方案红线自查：代码落 settlement/ 不落核心 app/、订单号用序列不用 COUNT(*)+1、支付页绝不自动跳授权、算钱不读 profile.service_end_at
完工前跑微信支付 Skill「接入质量评估」，🔴🟠 清零才提验收

APIv3/普通商户/支付产品/JSAPI支付/开发接入准备-4015423216.md — https://pay.weixin.qq.com/doc/v3/merchant/4015423216
APIv3/普通商户/通用规则/开发须知/开发参数申请和配置/开发必要参数说明-4013070756.md — https://pay.weixin.qq.com/doc/v3/merchant/4013070756
APIv3/普通商户/通用规则/最佳实践/回调通知注意事项-4012075420.md — https://pay.weixin.qq.com/doc/v3/merchant/4012075420