商户开通与对接就绪
本篇是完整上线指南的第四阶段:把商户开通到「可以发起收款」的状态。先明确运营模式(它决定流程走向),再按「创建商户 → 应用 → 对接密钥 → 就绪检查」走完。
商户日常操作(订单/退款/配置维护)见商户端使用入门;本篇只讲上线期的开通动作。
先定运营模式
| 模式 | 商户是谁 | 典型用法 | 本篇重点 |
|---|---|---|---|
| 平台多商户(SaaS 型) | 外部商户 | 运营方代开通 + 商户自助维护,商户端能力边界重要 | 全流程 |
| 单体自用(自有业务) | 自己的公司/业务线 | 只开一个商户给自己的业务系统对接 | 可跳过商户用户管理,聚焦对接密钥 |
创建商户
菜单路径:商户管理 → 商户列表 → 新增(操作细节见商户管理)
生产开通要点:
- 表单分「商户信息 + 管理员信息」两组,主体类型创建后不可修改;
- 管理员密码留空时系统生成随机初始密码,结果页只展示一次。生产流程建议固定三步:复制密码 → 安全渠道转告商户 → 提醒首次登录立即改密;
- 创建后系统自动完成四件事:商户号(M 开头)、管理员账号(绑商户超管角色)、默认应用(A 开头)、默认门店,无需手动补建;
- 禁用商户的语义:全部账号无法登录、无法发起新支付,但在途订单回调照常完成。上线初期临时停某个商户用禁用,不要用删除(删除仅限无交易数据的测试商户)。
应用管理
入口:商户工作台 → 支付配置 → 应用管理
应用是调用隔离单元(appId),生产要点(详解见应用配置):
- 不传 appId 的请求回落默认应用。停用默认应用会导致不指定 appId 的下单全部失败,删除默认应用被系统禁止;
- 第一个创建的应用自动成为默认,同商户至多一个默认;
- 多业务线区分对账时才需要多应用;单业务单应用即可。
对接配置
菜单路径:商户端 → 商户中心 → 业务配置 → 对接配置(运营代管:商户工作台 → 业务配置 → 对接配置)
| 凭证 | 生产发放动作 |
|---|---|
商户号 mchNo | 从商户资料复制给业务系统方 |
应用号 appId | 应用管理卡片查看(单应用可不传,回落默认) |
| 商户公钥 / 私钥 | 在线「生成密钥对」,私钥仅弹窗展示一次。生产建议重新生成一套(不复用沙箱期密钥),生成后立即交业务系统方妥善保管 |
| 平台公钥 | 只读复制给业务系统方,用于验证平台响应与回调签名 |
密钥是商户级的(所有应用共用一套),轮换会连锁影响所有用旧密钥的调用方。密钥保管规范(禁止入库/写死、按环境隔离)见业务系统对接。
商户用户(平台多商户模式)
- 商户管理员角色固定(不可变更、管理员不可封禁);普通店员/财务账号由商户管理员在商户端自建;
- 商户端角色由运营端预置授权(角色管理中终端选商户端)。上线前把「商户操作员」类角色准备好,商户才有可分配的角色;
- 运营端可通过用户管理(商户端 Tab)介入处理:重置密码(全部会话立即下线)、封禁/解锁。
商户端自助边界
提前说清「商户能自己做什么、什么必须找运营」,上线后可减少商户来回询问(能力矩阵见商户端通道商户):
| 商户可自助 | 必须运营端处理 |
|---|---|
| 直连通道密钥维护(支付宝直连最全、微信直连)、分账接收方绑定 | 商户创建/删除、商户禁用 |
| 对接配置密钥、域名校验文件(商户级) | 通道商户删除(商户端无删除入口) |
| 应用/门店/码牌认领/系统终端 | 服务商模式进件、通道商户全局视图处置 |
| 订单/退款/转账操作、回调推送排查 | 异常订单处置(商户端只读) |
就绪检查
每个商户上线前逐项核对(通用清单见上线检查清单):