主题
收款播报 APP：工具概览
收款播报 APP 是常驻柜台的安卓应用：支付成功后由平台经 MQTT WSS 推送收款消息，手机解密后播报金额与渠道，并按配置自动打印小票。不改造收银软件、不额外接音箱与打印机驱动，一台常开的手机即可补齐播报与打印。
当前版本 v0.2.1，支持 Android 8.0 及以上（不提供 iOS 版本）。
文档编写中
本页为工具概览；安装与扫码激活、MQTT 接入配置、播报与小票设置、设备管理与排障等完整章节仍在编写。其中「MQTT 接入配置」依赖面板侧能力确认后补充。当前请以交付包内说明与技术支持为准。
适用场景
| 场景 | 说明 |
|---|---|
| 台牌静态码 | 没有收银系统，手机放在柜台，顾客扫码到账即时播报 |
| 小摊与夜市 | 一台手机加一台蓝牙小票机，播报与小票一起解决 |
| 已有收银系统 | 不改造收银软件，补一台播报与打印终端 |
| 多门店 | 运营端统一管理设备、激活码与在线状态，换机解绑可追溯 |
收款播报只做到账播报与小票打印，不发起收款。
收款链路
- 支付成功 — 微信、支付宝等通道收款成功，交易在 DaxPay 支付平台完成；
- 平台推送 — 平台通过 MQTT WSS 将收款消息推送到对应设备主题；
- 播报与打印 — 手机解密消息后播报金额与渠道，按配置自动打印小票；
- 回执与心跳 — 播后回执、定时心跳，设备状态与平台校准。
核心能力
| 能力 | 说明 |
|---|---|
| 到账语音播报 | 播报金额与渠道，音量与播报开关可调 |
| 小票自动打印 | 支付成功按配置出票，样式在平台设置后各设备共用 |
| 扫码激活 | 设备编号 + 商户激活码双因子，激活即轮换密钥 |
| 设备管理 | 运营端管理设备、激活码与在线状态，换机解绑可追溯 |
| 收款流水 | 手机端查看收款记录，与平台订单对应 |
| 加密通道 | 消息 AES-256-GCM 加密，HMAC-SHA256 验签 |
| 夜间免打扰 | 跨零点免打扰时段内只记账与打印、不播语音 |
| 打印机断连保护 | 断连自动熔断，小票进入待打队列不丢失，恢复后自动续打，也可从平台补打 |
设备与打印兼容
| 项 | 要求 |
|---|---|
| 运行环境 | Android 8.0 及以上；一台常开的手机或平板，建议插电并加入电池优化白名单 |
| 打印机 | 经典蓝牙 SPP / USB / 网络 ESC/POS 热敏小票机，58mm 与 80mm 纸宽；网络打印默认端口 9100 |
| 不支持 | 仅 BLE 的打印机机型；iOS 设备 |
| 离线行为 | 播报依赖平台推送，当前版本不承诺离线补播；打印有本地待打队列 |
使用前提
- 平台侧完成设备与激活码准备，运营端可查看设备在线状态；
- 平台具备 MQTT 接入配置（面板侧接入方式待补充文档）；
- 手机保持联网、允许通知、关闭电池优化并允许开机自启。
获取与版本
收款播报 APP 商业版 App 扩展版起含源码交付，不单独销售；安装包随交付包提供，具体交付范围以商业版合同为准。