商户管理
商户管理是运营端开通与代管商户的入口。菜单路径：商户管理 → 商户列表。
新商户从零到能收款的主线（创建 → 通道商户 → 密钥 → 验证）见从部署到第一笔支付第四至八步；本文做商户管理域的完整参考。
商户列表
- 查询条件：商户名称、主体类型（小微 / 个体 / 企业）、状态（启用 / 禁用）
- 列表列：商户名称、商户简称、主体类型、状态、商户号、创建时间
- 操作列：只有一个「管理」按钮，进入该商户的商户工作台后，所有代管操作都在工作台内进行，列表页不直接提供编辑、启停与删除
新增商户
工具栏「新增」打开抽屉，表单分两组：
商户信息
| 字段 | 必填 | 说明 |
|---|---|---|
| 商户名称 | 是 | 商户全称 |
| 商户简称 | 是 | 列表与页面中展示的简称 |
| 主体类型 | 是 | 小微商户 / 个体工商户 / 企业 |
管理员信息（该商户的管理员账号，用于登录商户端）
| 字段 | 必填 | 说明 |
|---|---|---|
| 账号 | 是 | 6~20 位，仅字母、数字、_、-，商户终端内唯一 |
| 名称 | 是 | 管理员显示名称 |
| 密码 / 确认密码 | 否 | 留空时自动生成随机初始密码；填写则需两次一致 |
保存成功后系统自动完成四件事：生成商户号（M 开头）、创建商户管理员账号（绑定商户超管角色）、创建默认应用、创建默认门店。结果页展示账号与初始密码明文（只显示一次），请立即复制并转告商户。
商户工作台
从商户列表「管理」进入，是运营端代管单个商户全部配置的枢纽，按磁贴卡片分四组。商户在商户端看到的配置页与之镜像，数据同源。
| 分组 | 入口 | 功能 |
|---|---|---|
| 基础管理 | 商户资料 | 查看 / 编辑商户信息、启用禁用状态 |
| 商户用户 | 该商户的账号管理（新增、角色分配、重置密码、封禁） | |
| 门店管理 | 门店档案增删改查、默认门店 | |
| 系统终端 | 终端台账、与通道终端绑定 | |
| 支付配置 | 通道商户 | 在各支付产品上开通通道商户（创建入口只在这里） |
| 应用管理 | 商户的应用（appId）管理，见应用配置 | |
| 支付应用(微信) | 登记微信公众号 / 小程序等开放应用（JSAPI / 小程序支付需要） | |
| 支付应用(抖音) | 登记抖音开放应用 | |
| 业务配置 | 对接配置 | 代管该商户的 API 签名密钥（与商户端「对接配置」同数据） |
| 域名校验文件 | 上传微信域名校验文件（仅 MP_verify_*.txt，微信授权回调） | |
| 危险操作 | 删除商户 | 强确认（需输入商户名称），见下文删除规则 |
工作台的「通道商户」「支付应用(微信/抖音)」分别详见通道商户与支付应用；「应用管理」详见应用配置。其余子页的说明见下文各节；各通道的密钥配置模型见通道配置通用操作。
商户用户
工作台 → 基础管理 → 商户用户，管理该商户的登录账号（与平台用户的区别：账号属于商户、角色使用商户端角色）：
- 查询：姓名、账号、状态（正常 / 锁定 / 封禁）；列表含身份列：商户管理员显示金色标签，普通用户显示角色名；
- 新增：姓名 + 账号 + 密码（留空自动生成初始密码，结果页一次性展示）+ 角色（卡片单选，默认普通商户角色。创建时即绑定角色，避免新账号登录后菜单为空）；
- 操作：查看详情、编辑（仅姓名可改；邮箱只允许用户本人走绑定流程变更）、分配角色、重置密码、封禁 / 解锁，支持勾选后批量执行。
两条硬规则
商户管理员角色固定不可变更，且管理员不可封禁（封禁会导致商户失管，前后端双重拦截）。需要换管理员时先建好新账号再交接。
门店管理
工作台 → 基础管理 → 门店管理：
- 查询：门店名称、门店号、状态；列表展示默认门店标记与拼接后的完整地址；
- 表单字段：门店名称、状态、默认门店、联系电话、所在地区（省 / 市 / 区级联）、详细地址、经纬度（精度 7 位，供地图场景）、备注；
- 默认门店规则：与默认应用同构，不传门店号的交易回落默认门店；默认门店不可删除（先转移默认）；默认门店停用前会二次确认。
对接配置（API 凭证代管）
工作台 → 业务配置 → 对接配置，代管该商户的 API 对接密钥（与商户端「对接配置」同数据）：
| 项 | 说明 |
|---|---|
| 平台公钥 | 只读展示，提供给商户用于验证平台返回数据与回调的签名 |
| 商户公钥 | 商户持有私钥、公钥配置到平台用于验签；可用「生成密钥对」在线生成 |
| 通信密钥 | AES 对称密钥，用于接口报文加密传输；可在线生成 |
私钥只显示一次
在线「生成密钥对」时，私钥只在弹窗中展示一次，关闭后无法找回。生成后立即交给商户妥善保存。已有密钥重新生成需二次确认（会覆盖原密钥）。
微信域名验证
工作台 → 业务配置 → 微信域名验证，托管该商户侧的微信校验文件：
- 「上传验证文件」选择微信下载的
MP_verify_*.txt（仅此格式），系统读取内容托管； - 列表可按文件名、验证码检索；编辑只能改备注，文件内容不可改；
- 平台级域名的校验文件（支持
.txt/.html）在支付应用的「域名校验」页维护，两处归属不同。
商户状态与删除
启用 / 禁用：在商户工作台 → 商户资料中修改。禁用的影响：
- 该商户全部账号无法登录商户端；
- 该商户无法发起新的支付（交易上下文校验不通过）；
- 在途订单不受影响，通道回调仍会正常完成已有订单的状态更新；
- 各类商户下拉选择器中将不再出现该商户。
删除商户：仅商户工作台 → 危险操作 → 删除商户（需输入商户名称确认）。系统会拒绝删除已有交易、订单、退款记录或仍有用户的商户；删除为逻辑删除并级联清理子数据，请仅在测试数据清理等场景使用。
WARNING
商户号、商户简称等信息修改不影响交易；但主体类型创建后不可修改，请创建时确认准确。