HANDBOOK 01 · ONBOARDING

商户开通配置手册

新接一家商户,从签约到他能登录商家端正常卖货收钱:哪些事、谁来做、在哪做、做完怎么验证。三种操作角色在文中以标签标出。

中台 · 平台运营 微信后台 · 商家主体 支付平台 · 商户号 商家 · 商家端
配套材料:商家日常功能怎么用见 商家端功能使用说明;资质办理细节与首发提审细节由平台内部文档承接。本页面可打印分发。

〇、全景流程(按顺序走)

整个过程分六步。前四步是「把地基打好」,第五步商家自己能把店开起来,第六步才提审上线。

第 1 步 商家办资质(商家自己做,平台催办)
   └─ 小程序注册认证 · 类目资质 · 特约商户进件 · 分账签约
第 2 步 中台开通租户(中台,一次性)
   └─ 开通向导 6 步:小程序 → 数据来源 → 支付商户 → 技术服务费 → 域名存储 → 主账号
第 3 步 微信后台配置(微信后台,商家配合)
   └─ 服务器域名 · 上传密钥 · 隐私指引 · 消息推送 · 订阅消息模板
第 4 步 支付平台配置(支付平台,每个商户号一遍)
   └─ 小程序订单详情 path
第 5 步 商家端开店(商家自己做)
   └─ 登录改密 → 店铺/门店/营业时间 → 商品上架 → 装修 → 试下单
第 6 步 提审发布(中台出包 + 微信后台提审)
开通完成的判断标准:商家用主账号登录商家端 → 上架商品 → 手机上打开已发版的小程序 → 真实下单一笔支付成功 → 商家端能看到这笔订单。 路由配好了不等于链路通了,每一项都要实测。

一、第 1 步:商家自己要办的资质

商家 · 微信侧 平台不能代办(微信不允许平台代商家提交审核,主体与类目资质都在商家侧)。销售签约时就把这张清单发给商家。

#事项在哪办说明
1营业执照 + 法人信息商家自备后续一切认证的基础
2小程序注册 + 认证微信公众平台主体 = 商家自己;拿到 AppID + AppSecret
3类目资质小程序后台 → 类目设置食品类需食品经营许可证;教育类需相应许可。没有类目,支付与发布都过不了审
4特约商户进件平台协助(服务商通道)商户资料交给平台,走微信支付特约商户进件,拿到 特约商户号(sub_mchid)
5分账协议签约进件通过后在微信支付后台签「分账」协议——不签,技术服务费分不出来
6结算账户进件时填钱直达商家自己的特约商户号,平台不经手资金
耗时提醒:进件 + 分账签约是最长路径(数个工作日),签约时同步催办第 2、3 项,别串行等。

二、第 2 步:中台开通租户

中台 中台后台 → 租户 → 开通向导,共 6 步:

步骤填什么说明
① 小程序商家的 AppID + AppSecretAppSecret 回显只有掩码;填错 = 商家扫码登录不了,先验证再往下走
② 数据来源自营 或 对接供应链选「对接」的商家走平台供应链选品;选「自营」自己传商品
③ 支付商户特约商户号 + 商户证书第 1 步第 4 项的产物;证书密文落库,只有超管可见
④ 技术服务费收 / 不收 + 比例分账基数 = 实付 × 该店比例;列表列头显示「服务费」
⑤ 域名与存储子域名 + 存储开关默认走平台域名的五个子站
⑥ 主账号商家登录账号(手机号 + 初始口令)初始口令当面/私下交付,要求首次登录立即修改

验收:商家手机扫码登录商家端成功。登录不了,八成是第 ① 步 AppSecret 填错。

三、第 3 步:微信后台配置

微信后台 商家登录自己的小程序后台(mp.weixin.qq.com)逐项完成。每项都给出「在哪点、填什么、怎么验证」。

3.1 服务器域名必配

  • 位置:开发管理 → 开发设置 → 服务器域名。
  • request / uploadFile / downloadFile 三类都填:https://api.cz.kunyueshengtai.cn
  • 若启用独立 CDN 域名,CDN 域名同时要进 downloadFile 白名单,否则图片在真机上裂。

3.2 代码上传密钥必配

  • 位置:开发管理 → 开发设置 → 生成「小程序代码上传密钥」,下载后交给平台。
  • 同页把平台服务器 IP 加入白名单(不加,平台代上传会被拒)。
  • 平台拿到后录入 中台 → 租户详情 → 小程序卡片。
  • 验证:中台代上传体验版成功。

3.3 用户隐私保护指引必配

  • 位置:设置 → 服务内容声明 → 用户隐私保护指引。
  • 按代码实际用法必须勾选:位置信息、选中的照片或视频信息、摄像头、相册(仅写入);地址簿建议一并说明用途。
  • 不勾的后果:隐私相关能力在真机上直接失败(拍照 / 相册 / 位置全灭),提审也过不了。

3.4 消息推送强烈建议

作用:用户上传的图片(评价晒图、售后凭证、装修素材)由微信做内容安全检测,判定结果通过「消息推送」回调回来。

  • 位置:开发管理 → 开发设置 → 消息推送 → 启用,填:
    • URL:https://api.cz.kunyueshengtai.cn/api/mall/v1/wx/msg-push/<该租户的AppID>
    • Token:自定(3–32 位)
    • EncodingAESKey:43 位;消息加解密方式选 安全模式
  • 然后把同一组 Token / AESKey 录进 中台 → 租户详情 → 「消息推送」按钮(回显只有掩码,录错只能重录)。
  • 不配的后果:不影响上线,但这几类图片等于没有内容审核,一旦被举报是平台责任。提审前建议配好。
  • 验证:微信后台点「提交」时该 URL 会收到 GET 校验并返回成功;中台该租户显示「消息推送 · 已配」。

3.5 订阅消息模板

  • 位置:功能 → 订阅消息 → 按业务申请模板(支付成功 / 发货 / 退款等),通过后拿到模板 ID。
  • 模板 ID 交给商家填进 商家端 → 设置 → 消息通知。
  • 不配的后果:不影响上线,但一条通知都发不出去(契约是「模板 ID 空 = 零请求」,不会报错,所以容易被忽略)。
  • 验证:真实下单后买家微信收到服务通知。

3.6 体验成员与提审发布

  • 位置:成员管理 → 添加 1–2 名体验成员;用体验版走完「下单 → 支付 → 售后」全链路,再提交审核。
  • 分工:平台负责出包上传,商家负责在版本管理里点提审与发布。

四、第 4 步:支付平台配置

4.1 小程序订单详情 path每个商户号各配一遍

支付平台 位置:微信支付商户平台(该商户的特约商户号)→ 订单管理 → 「小程序商品订单详情 path」。

填这一条(所有商户内容都一样,但每个商户号里都要各录一次):

pages/order/detail/index?orderNo=${商品订单号}
  • 开头不带 /;${商品订单号} 占位符原样保留,微信会把支付下单时的 out_trade_no(即本系统的订单号)替换进去。
  • 为什么所有商户能共用一条:跳转落到哪个小程序由该商户号绑定的 AppID 决定,天然隔离,不会串单。
  • 前提:该租户小程序已发版,否则跳转落空。
  • 验证:真实支付一笔 → 微信支付凭证 / 订单中心 → 点「订单详情」能落进小程序订单页。

4.2 支付密钥确认

APIv3 密钥、商户证书序列号已在第 2 步第 ③ 步录入中台,商家不需要自己操作。中台 → 平台收款页有就绪状态显示,未就绪先在那里补齐(密钥留空 = 不修改,不会清掉旧值)。

五、第 5 步:商家端开店

商家 详细操作见 商家端功能使用说明,这里只列开通验收的最小集:

  1. 首次登录并立即改口令——初始口令只在开通时交付一次。
  2. 店铺设置(店名 / Logo / 联系方式)与门店管理(地址、电话);营业时间按门店设置——自提与核销都依赖门店,至少建一家。
  3. 商品上架:自营商家传商品图与规格价;供应链商家去「选品中心」选品上架。
  4. 首页装修:选模板改图文,应用即发布,不用另点发布。
  5. 手机试单:打开小程序能看到装修后的首页、能下单、能支付。
  6. 商家端核对:订单列表里能看到这笔订单。

六、平台级一次性配置

以下只做一次,不要在新商户开通时重复做:

事项位置说明
快递100 行业凭据中台 → 配置 → 快递查询平台代垫账号时按行业录入;商家也可自配自己的账号,商家自配优先
AI 大模型 Key服务器环境配置由平台配置,商家不接触密钥
AI 点数套餐 / 价格中台 → AI → 点数配置套餐定价与赠送规则
平台收款 / 服务商凭据中台 → 平台收款服务商凭据加密落库,仅超管可见
存储与 CDN中台 → 存储接 CDN 时白名单见 3.1

关于快递100 的分工

快递100 按单计费,所以支持商家各自注册自己的账号(各自实名、各自对账):商家端 → 设置 → 快递查询,录入顾客编号 + 授权密钥即可。商家没配的行业落到中台的行业级凭据;两级都没有时,买家端只显示单号、查不到「货到哪了」——这是降级,不是报错。

七、新商户开通验收清单

#项谁验通过标准
1中台开通向导 6 步完成平台租户列表显示已开通,主账号存在
2商家端登录商家扫码登录成功,首次改密
3服务器域名平台三类域名白名单含 api 域
4上传密钥 + IP 白名单平台中台代传体验版成功
5隐私指引四项商家真机拍照 / 相册 / 位置可用
6消息推送平台中台显示已配;UGC 图有审核结果
7订阅消息模板商家商家端已录模板 ID;真实下单收到通知
8订单详情 path平台支付凭证 → 订单详情能落进小程序
9商品上架 + 装修商家小程序首页有货有装修
10真实支付单双方商家端见单;服务费分账账目出现记录
11售后链路商家申请退款 → 审核通过 → 钱退回
全绿才叫「开通完成」。任何一项红着放行,都是把问题转嫁给商家客服。

下一步 → 商家端功能使用说明: 把这份手册连同主账号一起交给商家,他们照着就能把店开起来。