Skip to content

应用管理 ​

更新时间:2026/10/14 15:49:12

应用(appId)是商户下的调用与配置隔离单元:unipay 接口按应用区分来源,通道路由、网关支付、收银台等配置都挂在应用维度。菜单路径:商户中心 → 支付配置 → 应用管理。

应用的配置模型与管理端应用配置完全同源(运营端从商户工作台代管同一份数据),本文按商户端自助视角说明。

应用列表 ​

应用列表是卡片网格(非表格):每张卡片展示应用名称、appId、启用状态,默认应用置顶并带「默认」标签;点卡片进入该应用的应用工作台。

新增 / 编辑只有三个字段:应用名称、状态、默认应用开关(仅编辑态可改)。appId 由系统自动生成(A 开头),创建后不可修改。

默认应用规则 ​

  • 商户的第一个应用创建时自动设为默认;至多一个默认应用;
  • unipay 请求不传 appId 时回落默认应用,显式传 appId 则按传入值路由;
  • 列表顶部会提示「有应用但无默认应用」的警告——此时不传 appId 的下单会失败,设一个默认即可。
场景后果
停用默认应用不指定 appId 的下单被阻断(页面会二次确认提醒)
删除默认应用被禁止,先转移默认再删除
删除应用危险操作,需手动输入应用名确认

应用工作台 ​

从应用卡片进入,页签标题为「{应用名} · 应用配置」,分两组磁贴:

支付配置(每张卡独立权限控制):

卡片功能详见
通道路由指定本应用各支付方式走哪个通道商户应用支付配置
网关支付配置码牌 / 聚合支付在各客户端环境下的路由深度应用支付配置
收银台配置收银台页面在各环境下的支付方式展示应用支付配置
异步通知配置业务事件回调地址与订阅事件建设中,见下节
易支付配置兼容易支付 V1/V2 协议接入易支付插件

应用管理:编辑基本信息、设为 / 取消默认应用(二次确认)、删除应用(红色卡片,强确认)。

异步通知配置(建设中) ​

当前版本该界面建设中,工作台卡片带角标且不可点击。开放后将支持配置回调地址(HTTP)或 MQ 订阅(按应用隔离的 Topic)并勾选订阅事件。回调链路的排查现可先用商户回调推送页。

相关链接 ​