Skip to content

设备管理 ​

更新时间:2026/11/10 10:51:10

设备管理是运营端的一级分区,统一管理三类收款载体:码牌、虚拟设备(收款播报)与商户终端。本文只讲运营端后台的台账操作;通道侧的终端报备记录在通道商户详情页维护,码牌与终端参与收款的业务语义见支付码牌与终端。

三类设备的数据与商户端「设备管理」同源,商户自助操作见支付设备管理。

分区概览 ​

功能菜单路径用途
码牌管理设备管理 → 码牌管理平台批量制牌、绑定商户、启停与二维码查看
虚拟设备设备管理 → 虚拟设备收款播报 APP 设备台账:生成、绑定商户、激活二维码、试播与试打
商户终端设备管理 → 商户终端全平台商户终端只读总览,查看各自关联的通道终端

制牌与归属

码牌和虚拟设备都由平台侧生成,生成后进入平台库存,再绑定给商户;商户端没有创建入口。

码牌管理 ​

菜单路径:设备管理 → 码牌管理。列表是跨商户的全局视角,码牌由平台批量制作后绑定给商户。

查询与列表 ​

  • 查询条件:商户编号、门店号、批次号、码牌编码、码牌名称、码牌类型(H5 / 小程序)、金额类型(自定义金额 / 固定金额)、状态(启用 / 停用);
  • 列表列:码牌编码、码牌名称、码牌类型、批次号、金额、状态、是否分账、商户、创建时间;
  • 未绑定商户的码牌,商户列显示「未绑定」;
  • 点码牌编码打开「码牌二维码」弹窗,展示二维码与扫码地址,可「复制链接」交给制作方印制物料。

批量生成 ​

工具栏「批量生成」打开生成弹窗:

字段说明
批次号默认自动生成(Q 开头的时间串),可手改,也可点「生成」重新生成;批次号作为码牌编码前缀,已存在会提示「批次号已存在」
创建数量1 ~ 999 张
码牌名称可选,同批码牌共用
码牌类型H5 / 小程序,决定扫码进入的落地页形态,创建后不可改
金额类型自定义金额 / 固定金额;选固定金额时须填固定金额
状态启用 / 停用,默认启用

生成的是空白码牌,归属为平台库存。编码按「批次号 + 三位序号」生成(001 起),同批次内连续。

绑定与解绑 ​

  • 勾选码牌后「批量操作」→「绑定商户」:选商户,可一并指定应用与门店。应用留空时支付走商户默认应用;门店留空则为商户通用码牌;
  • 已绑定的码牌再次绑定会覆盖原归属,并清空原应用、门店与分账设置,弹窗顶部会给出覆盖提示;
  • 「解绑商户」后码牌回到空白库存,保留编码、批次与金额配置,清空商户、应用与门店。混合勾选时未绑定的码牌会被跳过;全部未绑定时会提示无需解绑。

编辑、启停与删除 ​

  • 编辑:修改码牌名称、金额类型、固定金额、是否分账与备注;商户与码牌类型只读展示;
  • 是否分账:开启后扫码支付会向下单链路透传分账标识;保存前会预检当前路由的支付产品,不支持分账的扫码场景以预警形式列出,只提示、不阻断保存,对应支付会降级为普通收款;
  • 启用 / 停用:行内操作,均需二次确认;停用后扫码无法支付;
  • 删除:仅停用状态可删,启用中的码牌须先停用,删除前二次确认。

导出 ​

工具栏「导出」生成码牌清单 xlsx。勾选行优先,只导勾选的数据;未勾选时按当前查询条件全量导出。导出前会确认导出范围与条数。

虚拟设备(收款播报) ​

虚拟设备是安装了「收款播报」APP 的安卓终端,收款成功后语音播报,连接小票打印机时同时出票。菜单路径:设备管理 → 虚拟设备。

查询与列表 ​

  • 查询条件:设备号、批次号、商户编号、门店号、状态(启用 / 停用);
  • 列表列:设备号、设备名称、批次号、归属、激活、运行状态、启用、最后在线;
  • 归属:已绑定商户显示商户名称与商户编号,未绑定显示「平台库存」;
  • 激活:显示「已激活」或「未激活」;未激活的设备无法试播与试打;
  • 运行状态:已激活设备显示「在线」或「离线」,未激活显示「-」;在线状态由 APP 心跳维持,「最后在线」按心跳节流落库,不是实时值;
  • 启用:列表内开关直接切换,停用后设备无法激活与接收指令。

生成虚拟设备 ​

工具栏「生成虚拟设备」打开生成抽屉:

  • 数量:1 ~ 5000 台;
  • 批次号:默认自动生成(B 开头的时间串),可改为自定义批次号,也可点「重新生成」;
  • 生成并入库:提交前二次确认,生成与入库一次完成,设备直接进入平台库存、未绑定商户;
  • 设备号规则:VD + 日期(yyMMdd)+ 6 位随机段(数字 2 到 9 与大写字母,去掉 I 和 O),如 VD261022K7M2Q4;
  • 生成成功后抽屉关闭,列表自动按本批批次号筛选,便于立即核对与导出。

激活二维码 ​

行内「更多」→「激活二维码」:

  • 二维码内容为激活协议串 daxpay:activate:{设备号},用虚拟设备 APP 扫码即完成设备绑定;服务器地址由 APP 安装包内置,二维码只携带设备号;
  • 无法扫码时可「复制编号」或「复制内容」手动填入;「下载 PNG」可保存二维码用于打印张贴;
  • 未绑定商户的设备扫码激活会失败,须先绑定商户;
  • 已停用的设备激活会失败,须先启用;
  • 已激活设备重新扫码会轮换设备密钥,并把当前在线设备踢下线,适用于换机与重置凭据场景,操作前会给出警告。

绑定与解绑商户 ​

  • 单台绑定:行内「更多」→「绑定商户」,选择商户编号,可一并指定应用与门店。应用留空使用商户默认应用,门店留空为商户通用设备;
  • 批量绑定:勾选未绑定设备后「批量操作」→「批量绑定商户」,一次绑定到同一商户;
  • 调整已绑定设备:单台已绑定设备的入口变为「调整应用/门店」,商户锁定,只能改应用与门店;更换商户须先解绑;
  • 批量绑定限制:勾选中只要包含已绑定商户的设备,整批会被拦截并提示先解绑;调整已绑定设备请单台操作;
  • 解绑:单台「解绑商户」或批量「批量解绑商户」,都会清空设备凭证,设备端需重新激活;两个入口均有二次确认。

试播与试打 ​

行内「更多」→「试播」或「试打」,仅对已激活设备可用:

  • 试播:填写金额(元)与收款方式,弹窗内的「预计播报」按设备端同一套词元规则实时显示文案;点「下发试播」向设备真实下发播报指令;
  • 试打:填写金额与收款方式,选择输出模式(播报 + 打印 / 仅打印)、商户单号(可选,票面变量)与打印版式(内置标准小票,58 / 80mm 双纸宽),点「下发打印」向设备下发打印指令。

编辑、启停与删除 ​

  • 编辑:修改设备名称与启用状态;设备号只读,归属走绑定、解绑操作;
  • 删除:仅未激活且未绑定的设备可删;已绑定或已激活的设备须先解绑(解绑会清空凭证回到可删状态);删除后设备号不可恢复。

导出 ​

工具栏「导出」生成虚拟设备清单 xlsx,内容为台账信息,不含任何设备凭证字段。勾选行优先,未勾选时按当前查询条件全量导出,导出前确认范围与条数。

接入参数与凭据版本 ​

  • 设备激活时由平台下发 MQTT 接入参数(MQTT 接入地址、接入账号、接入密码)与凭据版本;
  • 平台配置「MQTT 接入」修改后,已激活设备不会自动切换,需重新扫码激活才会取到新值;
  • 接入账号或密码变化时凭据版本随之变化,在线设备心跳会收到需要重新激活的标记,按 APP 提示重新激活即可;
  • 更换指向其他服务器环境的 APP 安装包,APP 也会要求重新激活,属预期行为。

配置方法与换环境后的重新激活说明见支付平台配置与收款播报(虚拟设备):部署与使用。

商户终端 ​

商户终端是平台侧的逻辑终端档案(收银机、扫码盒等),终端编码由平台生成,是通道侧终端报备时的关联锚点。菜单路径:设备管理 → 商户终端。

只读总览 ​

本页是跨商户的只读总览,不提供创建、编辑与删除:

  • 查询条件:商户、终端编码、终端名称、门店号、启用(启用 / 停用);
  • 列表列:商户、终端名称、终端编码、门店、启用、关联通道、创建时间;
  • 关联通道:展示摘要「N 条 · 已报备 X · 异常 Y」,异常数大于 0 时标红;没有关联时显示「未绑定」;
  • 启用:仅展示启用或停用标签,不在本页切换。

商户内维护 ​

商户终端档案的创建与维护在商户工作台:商户管理 → 商户列表 → 管理 → 商户工作台 → 收银与设备 → 商户终端。该页锁定当前商户,支持:

  • 创建:填终端名称、启用状态、门店(可选)与备注;终端编码由平台生成;
  • 编辑:修改终端名称、启用状态、门店与备注;终端编码只读;
  • 删除:二次确认;门店默认终端不可直接删除,需先取消默认或转交其他终端;
  • 列表列:终端编码、终端名称、门店(默认终端带「默认」标记)、启用、备注、创建时间。

关联通道终端 ​

行内「关联终端」打开只读抽屉,查看该商户终端在各通道侧的报备情况:

  • 抽屉标题为「关联通道终端 · 终端名称或终端编码」;
  • 列表列:通道、通道商户号、报送类型、通道侧终端号、报备状态、错误信息、创建时间;
  • 报送类型:微信渠道报送、支付宝渠道报送、银联渠道报送、标准上报;
  • 报备状态:未报送、已报送、错误、已注销、初始化;
  • 抽屉顶部提示关联关系由通道终端报备时建立(报备即绑定),此处仅供查看;需要调整请前往通道商户详情页的「终端台账」操作;
  • 没有关联通道终端时显示「暂无绑定」。

门店默认终端 ​

门店默认终端不在本页设置,入口在商户工作台:商户管理 → 商户列表 → 管理 → 商户工作台 → 基础管理 → 门店管理 → 门店卡片 → 门店工作台 → 默认设置。候选为本店已绑定且启用的商户终端,同门店只保留一个默认终端;未传终端号收银时回落本店默认终端。详见商户管理。

与通道终端的关系 ​

  • 商户终端是平台侧台账,用于本系统的终端语义(收银机、扫码盒等逻辑终端);
  • 通道终端是通道侧登记或报备的终端记录,挂在具体通道商户下;
  • 两者在「通道商户详情 → 终端台账」建立关联,一条通道终端只归属一个商户终端;报备即绑定,关联由报备动作建立;
  • 「设备管理 → 商户终端」总览只做只读查询,通道终端的建档、关联调整与注销都在通道商户详情页完成,详见通道商户。

常见问题 ​

虚拟设备扫码激活失败,先查什么 ​

按顺序检查:设备是否已绑定商户、是否处于启用状态、平台配置的「MQTT 接入」是否填齐 MQTT 接入地址、接入账号与接入密码。未绑定商户与已停用的设备都会激活失败,接入参数缺失也会被平台拒绝。配置方法见支付平台配置。

修改 MQTT 接入后为什么要重新激活 ​

已激活设备使用的接入参数是激活时下发的;修改平台配置「MQTT 接入」后,已激活设备不会自动切换,需要重新扫码激活一次。接入账号或密码变化会使凭据版本变化,在线设备心跳会收到重新激活标记,按 APP 提示操作即可。

解绑或换绑后,播报 APP 为什么失效 ​

解绑会清空设备凭证并踢下线,设备回到未激活状态,旧 APP 下一次心跳即失效。若只是更换归属商户,须先解绑再绑定,然后让设备重新扫码激活。

删除商户终端会同步注销通道终端吗 ​

不会。删除商户终端只移除平台侧终端档案与关联关系,不向通道发起注销。通道侧终端记录仍在,需到通道商户详情页的「终端台账」注销,注销后该终端号才不可用于收款。