阶段 0 · 备料（一次备齐防驳回）

• 营业执照（个体户或企业，彩色照 ≤5M，可加「仅限微信支付认证使用」水印）；经营范围含 软件开发 / 技术服务，须与实际售卖一致。
• 法人身份证正反面彩色原件照；结算账户：个体户=法人本人储蓄卡，企业=对公账户（户名与执照主体全等）。
• 超级管理员一名（建议法人）：手机号+邮箱+本人微信号；客服电话畅通（审核有回拨）；商户简称勿纯人名（展示在付款凭证）；网站域名已 ICP 备案。

阶段 1 · 申请微信支付商户号 → 产出 mch_id

1. 入口（官方免费）：pay.weixin.qq.com 右上「成为商家」，或微信搜小程序「微信支付商家助手」。被引导付费「88 元开通」即进了第三方页，退回。
2. 主体类型按执照选个体户/企业（选错只能重新申请）；上传执照与身份证，自动识别的信用代码逐个核对。
3. 经营场景勾「公众号」；经营类目选「IT科技 → 软件/信息服务」（0.6% 标准费率；类目与实际不符是后期封号头号原因）。
4. 账户验证：个体户多为人脸识别秒过；企业对公小额打款回填金额。审核 1~3 个工作日，保持电话畅通。
5. 审核通过后必须由超管在线签署《微信支付服务协议》——不签约商户号收不了款。完成邮件内含 10 位商户号 mch_id。

阶段 2 · 注册公众号并微信认证 → 产出 AppID

1. mp.weixin.qq.com → 立即注册 → 类型选「订阅号」→ 邮箱激活 → 用同一执照完成主体登记。
2. 后台「设置与开发 → 公众号设置」页顶抄 18 位 wx 开头 AppID。
3. 「设置 → 微信认证」做企业实名认证（认证费以页面标价为准，1~3 个工作日）——不认证无微信支付能力。

阶段 3 · AppID ↔ 商户号绑定 + 开通 Native 支付

1. 公众号后台「管理与开发 → 微信支付」或商户平台「产品中心 → AppID账号管理」任一侧发起关联，另一侧确认；判定标准=列表状态「已生效」。
2. 商户平台「产品中心 → 我的产品」确认「Native 支付」已开通（签约后一般即时开通；顺手开 JSAPI 备将来公众号内支付）。本系统只依赖 Native。

阶段 4 · 商户平台「账户中心 → API安全」三件套

1. APIv3 密钥：自拼 32 位 ASCII 字符随机串设置（密码管理器生成；代码校验按字节长，勿用中文等多字节字符）；永不回显，只此一次；换钥瞬间在途回调会解密失败，选夜间无单时段并立刻同步本表单。
2. 商户 API 证书：申请方式选「系统生成」→ 下载得 apiclient_key.pem（私钥只能下载一次，立即多处备份；cert.pem/p12 本系统不需要）→ 证书列表页抄 40 位十六进制「证书序列号」。
3. 判定验签模式：页上有「平台证书」栏目 → 平台证书模式，公钥两格留空（代码自动拉取缓存）；只有「微信支付公钥管理」（PUB_KEY_ID_…，下载 wxp_pub.pem）→ 公钥模式，填公钥两格。硬规则：见「平台证书」栏目=两格一律留空——证书模式误贴公钥 PEM 会致整通道 503 挂死；只认「微信支付公钥管理」栏目才填两格。

阶段 5 · 填本表单九项（逐字段来源对照）

保存后看下方状态行：「尚缺 ×××」对照补齐；「资质齐备且已启用」即后台侧就绪。密钥类格子显示「已配置，留空保持不变」——以后改别的字段这些格子留空即不丢密钥。

阶段 5 附 · 保存前逐项核对（照单打勾）

• □ AppID：wx 开头 18 位，且公众号已完成微信认证
• □ mch_id：10 位且已在线签约；AppID 关联状态「已生效」；Native 支付已开通
• □ APIv3 密钥：32 位字符（ASCII），与商户平台当前设置值一致（设置当时已自存备份）
• □ 证书序列号 + 私钥：40 位十六进制与 apiclient_key.pem 同批次成对，粘贴无丢行
• □ notify_url：整串复制 https://www.wwwseo.net/api/v1/billing/callback/wxpay
• □ 公钥两格：平台证书模式=都留空（曾误填过的须贴正确值覆盖保存——留空沿用旧值不会清除）；公钥模式=ID+PEM 成对填且同来源
• □ 点「保存微信支付配置」后状态行无「尚缺」提示
• □ 服务器：.env 的 BILLING_ENABLED_PROVIDERS 含 wxpay、qrcode/pypng 已装、双站已重启
• □ 浏览器访问 /api/v1/billing/providers 返回含 "wxpay"
• □ 真机 1 元扫码：3 秒内翻转已支付弹卡密；商户平台「通知查询」回调绿色成功

阶段 6 · 服务器开闸（双保险，缺一不可）

1. 双站虚拟环境 pip install -r requirements.txt（qrcode / pypng）。
2. 双站 .env：BILLING_ENABLED_PROVIDERS 追加 wxpay。
3. 发布代码并重启双站；浏览器访问 /api/v1/billing/providers，data 出现 "wxpay" 即全通；排障可跑服务器侧 python scripts/wxpay_diag.py --live（只读诊断：路径/文案/双门禁链逐项核对）。

阶段 7 · 真机 1 元小额验收

1. 建 ≤1 元测试 SKU：PC 下单出二维码 → 微信扫码付款 → 页面 3 秒内自动「已支付」弹卡密。
2. 商户平台「交易中心 → 订单」该单成功；「通知查询」回调记录成功（无红色失败）= 验签通过铁证。
3. m 站再走一遍：微信内置浏览器出「相册识别」引导，外部浏览器出「打开微信」深链，均应可付。
4. 验收后下架测试 SKU 恢复原价；可选抽测：挂过期单扫码付款 → 后台应出 orphan 流水+企微告警（正常防线，人工原路退）。

报错速查（出现即对号）

报错 / 现象	原因与处置
商户号与AppID不匹配（下单报错）	阶段 3 绑定未做或未确认
NO_AUTH / 该产品未开通	阶段 3 未开通 Native 支付
SIGN_ERROR 签名错误	证书序列号与私钥不成对，或私钥粘贴不完整
回调验签失败 / 未知平台证书序列号	换证可自愈；持续报错=实际是公钥模式没配公钥，按 4.3 补填。微信会重试，不丢单
收到公钥模式通知，但未配置微信支付公钥	公钥模式商户：补 public_key_pem + 公钥 ID 保存即恢复
回调报文解密失败	APIv3 密钥与商户平台当前值不一致（重置过没同步）
notify_url 必须为 https 地址	回调地址没写 https:// 开头
回调单号不存在（unknown_order）	签名合法但单号查无：应答 200 停重试、绝不发权益。本商户号下的单 mchid 不符会在通道层先拒、到不了本分支；出现即多为报文单号被改/复用他系统单号，核对来源
孤儿款登记（orphaned）	已过期/取消单被付款：落 orphan 流水+企微告警、状态不翻转；按告警单号在商户平台原路退款
回调 400「支付通道 wxpay 未启用」	env 白名单未加 wxpay 或后台未启用/密钥不全 → 跑 wxpay_diag --live 看缺哪道闸
付款成功但页面不翻转	「通知查询」看微信是否发出：未发出查 notify_url 公网可达/443；发出但 4xx 看站点日志

日常运维与安全红线

• 商户 API 证书 5 年到期：新私钥+新序列号成对更新到本表单。
• 退款与对账均在商户平台「交易中心」：账单按流水交易号与后台对账；资金问题官方客服 95017。费率 0.6% 实扣，T+1 结算到绑定银行卡。
• 私钥 / APIv3 密钥 / 公钥 PEM 只存密码管理器与本表单：永不进群聊、工单、代码仓库；商户平台开启登录保护+操作短信验证。