总览与责任边界
果酱JAM 是微信开放平台认证的第三方服务商。接入后，你的工作室拥有一款挂在自己主体名下的小程序，课程、舞会、次卡、支付、会员等经营能力由平台统一提供，你只需完成微信侧的必要配置。
接入周期：按你现在的情况
“接入完成”和“正式版上线”是两个阶段。已有小程序、微信前置齐全且无需迁移历史数据时，平台接入和体验版切换可以很快完成；需要替换正式版时，仍要经过真机验收和微信审核。
| 你的情况 | 预计接入周期 | 说明 |
|---|---|---|
| 原小程序已正常运行 | 最快约 1 小时 | 适用于认证、备案、类目等前置已完成，不迁移旧数据，且管理员可即时扫码配合；可完成授权并生成体验版。正式版替换仍需验收和微信审核。 |
| 已有小程序，但需要迁移或重新配置 | 通常约 1–3 个工作日 | 适用于需要迁移会员、次卡、余额、订单或课程，重新配置微信支付，或处理原开发方交接的情况；实际时间按数据量和联调结果确定。 |
| 还没有小程序 | 按微信官方进度 | 需要先注册、认证、设置类目并完成工信部备案；平台配置可以并行准备，正式上线时间以微信审核结果为准。 |
整体流程（4 步）
小程序认证与备案
注册小程序，完成主体认证、基础信息、类目与工信部备案。没有小程序也没关系，平台协助你从注册开始。
授权接入果酱平台
小程序管理员用微信扫描平台提供的授权码并确认即可。
微信支付配置
开通商户号、集齐 7 项参数，录入后台并自检，用 0.01 元真机验收。
上架发布
平台代提交审核，审核通过自动发布正式版，学员即可扫码使用。
谁负责什么
边界很清晰：与你主体强绑定的微信侧事务归工作室，通用业务与平台链路归果酱JAM。
| 工作室负责（你） | 果酱JAM 负责（平台） |
|---|---|
| 小程序主体、名称、头像、类目、认证、备案 | 第三方平台授权链路与 token 的接收 / 刷新 / 排障 |
| 管理员扫码、授权确认、提审发布确认 | 工作室建档、studio_apps 绑定、授权状态同步 |
| 服务器域名、隐私协议等微信侧合规配置（平台给你标准值） | 小程序统一代码底座、代上传 / 代提审 / 代发布 |
| 支付主体、商户号、支付参数 | 登录、订单、支付、签到、会员、用户中心等通用能力 |
小程序认证与备案
这一步由工作室自己的主体完成，平台无法代替（微信 & 工信部按主体走）。目标：你有一个已注册、已认证、已备案、可正常提审的小程序。
注册小程序并认证
在 mp.weixin.qq.com 用工作室主体注册小程序，完成微信认证，拿到 AppID（后面处处要用）。
设置类目与基础信息
补全名称、头像、简介，选择与舞蹈培训 / 文体服务相符的服务类目。
完成工信部小程序备案
在小程序后台「设置 → 基本设置 → 备案」按指引提交主体与负责人信息，通过工信部备案。未备案的小程序无法发布正式版。
授权接入果酱平台
授权只需要小程序管理员完成一次微信扫码确认。
管理员扫码确认授权
由小程序管理员本人使用微信扫描平台提供的授权码，确认授权给「果酱JAM」；看到授权成功提示即完成。
微信支付配置
让小程序能真实收款（课程报名、商品、舞会票等）。本质是把下面 7 项参数交给平台：只有第 ① 项来自小程序，第 ③ 项留空，其余 ④⑤⑥⑦ 都来自你自己的微信支付商户号。
你要准备的 7 项参数
| # | 参数 | 通俗解释 | 从哪里拿 |
|---|---|---|---|
| ① | 支付 AppID | 你的小程序 ID | 微信公众平台 → 小程序后台 |
| ② | 商户号 MchID | 微信支付账户号（10 位数字） | 商户平台首页 |
| ③ | 支付回调地址 | 付款成功后微信通知平台的网址 | 留空即可，平台自动用默认 |
| ④ | 商户私钥 PEM | 给请求签名的「数字签名笔」 | 申请商户 API 证书时生成 |
| ⑤ | 证书序列号 | 那把「笔」的编号 | 商户平台 → API 安全 |
| ⑥ | APIv3 密钥 | 32 位密码，解密回调用 | 自己在商户平台设置 |
| ⑦ | 微信支付平台公钥 PEM | 验证「回调确实来自微信」 | 商户平台 → API 安全 |
微信侧：开通商户号并拿到参数
开通商户号（拿到 ②）
在 pay.weixin.qq.com 注册商户平台，提交主体资质与银行账户完成签约（审核约 1–3 个工作日）。首页可见 10 位商户号 MchID。
关联小程序与商户号（① 与 ② 配对）
商户平台 →「产品中心 → AppID 账号管理」添加你的小程序 AppID 并发起关联，再到小程序后台确认。否则下单报
APPID_MCHID_NOT_MATCH。确认已开通 JSAPI / 小程序支付
商户平台「产品中心」确认小程序支付为「已开通」，否则报
NOAUTH。设置 APIv3 密钥（拿到 ⑥）
「账户中心 → API 安全 → APIv3 密钥」自定义一串 32 位字符。设置后微信不再显示原文，务必自己抄下来。
申请商户 API 证书（拿到 ④ 私钥 + ⑤ 序列号）
「API 安全 → 申请 API 证书」，用微信证书工具生成
apiclient_key.pem（其内 BEGIN/END 之间的全部内容即私钥 ④），页面显示的证书序列号即 ⑤。获取微信支付平台公钥（拿到 ⑦）
「API 安全 → 微信支付公钥」下载 PEM 文件。较早开户的商户此处可能叫「平台证书」，若只有平台证书没有公钥，告知平台对接人按你的模式适配。
平台侧：录入后台并自检
你可以自己录（若有后台管理员权限），也可把参数安全地交给平台对接人代录，二选一。进入你的工作室 → 支付配置页：
| 后台字段 | 填入 |
|---|---|
| 支付 AppID | ① 小程序 AppID |
| 商户号 MchID | ② |
| 支付回调地址 | 留空（平台默认 …/wx/payment/notify-v3） |
| 商户私钥 PEM | ④（连 BEGIN/END 两行整段粘贴） |
| 商户证书序列号 | ⑤ |
| API v3 Key | ⑥（32 位） |
| 微信支付平台公钥 PEM | ⑦（连 BEGIN/END 两行整段粘贴） |
保存后依次点 「支付配置自检」（应显示 7 项全部已填）与 「回调地址检查」（返回 404/405 也算可达）。两项都过即完成。
常见报错对照
| 错误码 | 原因 | 怎么修 |
|---|---|---|
APPID_MCHID_NOT_MATCH | AppID 没和商户号关联 | 回到「关联小程序与商户号」步骤 |
SIGN_ERROR | 私钥与序列号不是同一套 / 私钥粘错 | 核对 ④⑤ 来自同一次证书申请，私钥整段重粘 |
NOAUTH | 未开通小程序支付，或账户未验证 / 被限收款 | 确认 JSAPI 已开通；处理商户平台首页红色提示 |
MCH_NOT_EXISTS | 商户号填错 | 核对 ② |
解析私钥失败 / PEM | 私钥格式不对 | 重开 apiclient_key.pem，连 BEGIN/END 整段粘贴 |
上架发布
代码由平台统一维护，你无需开发。发布走「平台代提审、审核通过自动发布正式版」。
一键发布出体验版
后台工作室详情页「代码发布」卡 →「一键发布」，平台把最新统一代码包提交到你的小程序，生成体验版二维码供你先验收。
代配隐私指引
提审前点「代配隐私指引」，把用户信息处理说明配置到位。
提交审核
点「📝 提交审核」，平台代你向微信提交审核。
审核通过自动发布
微信审核通过后，平台自动发布正式版，无需你再操作。学员即可搜索 / 扫码使用你的小程序。
工作室验收清单
工作室负责人只需确认以下事项：
- 小程序认证、类目和工信部备案已完成
- 小程序管理员已扫码，并看到授权成功提示
- 如启用微信支付，商户号已关联 AppID，并已安全完成支付资料配置
- 已扫描体验版二维码，确认登录、报名和付款等首期流程正常
- 体验无误，已明确回复平台“确认上线”