Skip to content

商户开通与对接就绪 ​

更新时间:2026/10/15 12:07:28

本篇是完整上线指南的第四阶段:把商户开通到「可以发起收款」的状态。先明确运营模式(它决定流程走向),再按「创建商户 → 应用 → 对接密钥 → 就绪检查」走完。

商户日常操作(订单/退款/配置维护)见商户端使用入门;本篇只讲上线期的开通动作。

先定运营模式 ​

模式商户是谁典型用法本篇重点
平台多商户(SaaS 型)外部商户运营方代开通 + 商户自助维护,商户端能力边界重要全流程
单体自用(自有业务)自己的公司/业务线只开一个商户给自己的业务系统对接可跳过商户用户管理,聚焦对接密钥

创建商户 ​

菜单路径:商户管理 → 商户列表 → 新增(操作细节见商户管理)

生产开通要点:

  • 表单分「商户信息 + 管理员信息」两组,主体类型创建后不可修改;
  • 管理员密码留空时系统生成随机初始密码,结果页只展示一次。生产流程建议固定三步:复制密码 → 安全渠道转告商户 → 提醒首次登录立即改密;
  • 创建后系统自动完成四件事:商户号(M 开头)、管理员账号(绑商户超管角色)、默认应用(A 开头)、默认门店,无需手动补建;
  • 禁用商户的语义:全部账号无法登录、无法发起新支付,但在途订单回调照常完成。上线初期临时停某个商户用禁用,不要用删除(删除仅限无交易数据的测试商户)。

应用管理 ​

入口:商户工作台 → 支付配置 → 应用管理

应用是调用隔离单元(appId),生产要点(详解见应用配置):

  • 不传 appId 的请求回落默认应用。停用默认应用会导致不指定 appId 的下单全部失败,删除默认应用被系统禁止;
  • 第一个创建的应用自动成为默认,同商户至多一个默认;
  • 多业务线区分对账时才需要多应用;单业务单应用即可。

对接配置 ​

菜单路径:商户端 → 商户中心 → 业务配置 → 对接配置(运营代管:商户工作台 → 业务配置 → 对接配置)

业务系统调用的四件凭证(详解见对接配置与业务系统对接):

凭证生产发放动作
商户号 mchNo从商户资料复制给业务系统方
应用号 appId应用管理卡片查看(单应用可不传,回落默认)
商户公钥 / 私钥在线「生成密钥对」,私钥仅弹窗展示一次。生产建议重新生成一套(不复用沙箱期密钥),生成后立即交业务系统方妥善保管
平台公钥只读复制给业务系统方,用于验证平台响应与回调签名

密钥是商户级的(所有应用共用一套),轮换会连锁影响所有用旧密钥的调用方。密钥保管规范(禁止入库/写死、按环境隔离)见业务系统对接。

商户用户(平台多商户模式) ​

商户自助运营时的账号体系(详解见商户用户与用户管理):

  • 商户管理员角色固定(不可变更、管理员不可封禁);普通店员/财务账号由商户管理员在商户端自建;
  • 商户端角色由运营端预置授权(角色管理中终端选商户端)。上线前把「商户操作员」类角色准备好,商户才有可分配的角色;
  • 运营端可通过用户管理(商户端 Tab)介入处理:重置密码(全部会话立即下线)、封禁/解锁。

商户端自助边界 ​

提前说清「商户能自己做什么、什么必须找运营」,上线后可减少商户来回询问(能力矩阵见商户端通道商户):

商户可自助必须运营端处理
直连通道密钥维护(支付宝直连最全、微信直连)、分账接收方绑定商户创建/删除、商户禁用
对接配置密钥、域名校验文件(商户级)通道商户删除(商户端无删除入口)
应用/门店/码牌认领/系统终端服务商模式进件、通道商户全局视图处置
订单/退款/转账操作、回调推送排查异常订单处置(商户端只读)

就绪检查 ​

每个商户上线前逐项核对(通用清单见上线检查清单):

  • [ ] 管理员初始密码已安全转告,首次登录已改密
  • [ ] 默认应用与默认门店自动创建无误
  • [ ] 生产通道商户已建且密钥配置完成(支付能力开通)
  • [ ] 通道路由已生效(应用工作台,支付能力开通)
  • [ ] 对接密钥已按生产标准发放/重新生成,业务系统方已拿到四件凭证
  • [ ] 商户端「工作台」告警横条已清零(无未配通道商户/路由/凭证告警)
  • [ ] 小额真实支付一笔成功,订单/回调/推送链路核对

下一阶段:API 直连到此即可进入上线验收;要用统一收银台、聚合扫码或码牌,继续网关收款上线。