应用管理
应用(appId)是商户下的调用与配置隔离单元:unipay 接口按应用区分来源,通道路由、网关支付、收银台等配置都挂在应用维度。菜单路径:商户中心 → 支付配置 → 应用管理。
应用的配置模型与管理端应用配置完全同源(运营端从商户工作台代管同一份数据),本文按商户端自助视角说明。
应用列表
应用列表是卡片网格(非表格):每张卡片展示应用名称、appId、启用状态,默认应用置顶并带「默认」标签;点卡片进入该应用的应用工作台。
新增 / 编辑只有三个字段:应用名称、状态、默认应用开关(仅编辑态可改)。appId 由系统自动生成(A 开头),创建后不可修改。
默认应用规则
- 商户的第一个应用创建时自动设为默认;至多一个默认应用;
- unipay 请求不传 appId 时回落默认应用,显式传 appId 则按传入值路由;
- 列表顶部会提示「有应用但无默认应用」的警告——此时不传 appId 的下单会失败,设一个默认即可。
| 场景 | 后果 |
|---|---|
| 停用默认应用 | 不指定 appId 的下单被阻断(页面会二次确认提醒) |
| 删除默认应用 | 被禁止,先转移默认再删除 |
| 删除应用 | 危险操作,需手动输入应用名确认 |
应用工作台
从应用卡片进入,页签标题为「{应用名} · 应用配置」,分两组磁贴:
支付配置(每张卡独立权限控制):
| 卡片 | 功能 | 详见 |
|---|---|---|
| 通道路由 | 指定本应用各支付方式走哪个通道商户 | 应用支付配置 |
| 网关支付配置 | 码牌 / 聚合支付在各客户端环境下的路由深度 | 应用支付配置 |
| 收银台配置 | 收银台页面在各环境下的支付方式展示 | 应用支付配置 |
| 异步通知配置 | 业务事件回调地址与订阅事件 | 建设中,见下节 |
| 易支付配置 | 兼容易支付 V1/V2 协议接入 | 易支付插件 |
应用管理:编辑基本信息、设为 / 取消默认应用(二次确认)、删除应用(红色卡片,强确认)。
异步通知配置(建设中)
当前版本该界面建设中,工作台卡片带角标且不可点击。开放后将支持配置回调地址(HTTP)或 MQ 订阅(按应用隔离的 Topic)并勾选订阅事件。回调链路的排查现可先用商户回调推送页。