简体中文
收款精灵:概览与链路
收款精灵是运行在 Windows 收银电脑上的旁挂式收款助手。它不改造收银软件:扫码盒读取顾客付款码完成被扫收款,OCR 识别收银软件屏幕上的金额并带入收款,收款成功后语音播报、按需打印小票。适合有固定收银电脑的线下门店,支持多门店、多终端。
定位与工作方式
收银电脑上同时运行原有收银软件和收款精灵。收款精灵负责三件事:
- 通过扫码盒读取顾客出示的付款码,或识别收银软件显示的应收金额;
- 调用 DaxPay 商户收银接口发起被扫收款,并等待支付结果;
- 收款成功后语音播报金额、按需打印小票,同时把交易流水记入本机账本。
收款精灵只负责「收钱」这一步。支付结果的真相源始终是平台,本机账本只做镜像和历史查看。
核心能力
| 能力 | 说明 |
|---|---|
| 被扫收款 | 扫码盒支持 HID 键盘仿真与 HID POS(0x8C)两条通道,后台读取付款码后直接进入收银台;收银台另提供计算器式面板,可手工输入金额 |
| OCR 金额识别 | 框选收银软件的金额显示区,由本地模型识别,金额稳定后显示到悬浮条;识别失败时静默降级为手工输入,不猜金额 |
| 语音播报 | 收款成功播报金额;系统中文语音包不可用时自动降级为内置 WAV 词表拼接 |
| 小票打印 | 58 / 80mm ESC/POS 热敏小票机,支持 USB 免驱直发、网口 RAW TCP(默认 9100)与文件转储;1 至 4 联,二维码与条形码按位图渲染 |
| 退款 / 查单 | 在交易记录中对收款行发起全额或部分退款,主动向平台查单同步状态;未支付订单到期由平台自动关单 |
| 多门店 / 多终端 | 登录后拉取启用门店、应用与终端;单店自动选中,多店弹窗选择,门店跟机器走;终端号可在本机配置 |
| 重打上一笔 | 全局热键重打今日最近一笔成功收款的小票,重启后仍可补打 |
| 本机账本 | 本地保存收款、退款流水,断网也能查看历史;平台为交易真相源 |
| 悬浮金额条与托盘 | 悬浮条可拖动、调整大小与透明度并记忆位置;托盘常驻,支持开机自启、检查更新与快捷入口 |
本版只做被扫收款,不包含主扫(商家出示收款码、顾客扫码付款);小票版式使用本机内置模板,不支持服务端模板管理。
运行环境
| 项 | 要求 |
|---|---|
| 操作系统 | Windows 10 1607 及以上(64 位)或 Windows 11 |
| 运行时 | 标准版自带 .NET 10;轻量版需预装 .NET 10 Desktop Runtime |
| 扫码盒 | HID 键盘仿真或 HID POS(0x8C),USB 接口 |
| 打印机 | 58 / 80mm ESC/POS 热敏小票机,USB 或网口(RAW 9100) |
| 服务端 | DaxPay 4.0.0-beta10 及以上,含 daxpay-payment-elf 模块 |
| 账号 | 商户端创建的收银员账号,角色为「商户收银员」(merchant_cashier) |
桌面程序当前版本为 0.1.x,使用独立版本线,不跟随平台 4.0 的版本号。
账号与安全
- 使用商户身份域登录,只能使用商户端账号,不能使用运营端账号;
- 密码经 RSA 公钥加密后传输,并带 nonce 防重放;连续登录失败会要求图形验证码;
- 支持 TOTP 两步验证,开启后登录需输入动态口令;
- 登录凭证只保存在内存中;勾选「记住密码」时,账号密码经 Windows DPAPI(当前用户)加密后存本机;
- 本机凭据文件为数据目录下的
credential.bin,token 不落盘。
获取方式
收款精灵与收款播报 APP 均按 DaxPay 生态扩展包档位交付,以源码形式提供(含源码授权)。获取方式与授权条款以官网定价页为准。
继续阅读
- 设计架构:组件链路、金额与支付两条链路、本机账本与平台的关系;
- 安装与登录:服务端准备、安装升级、服务端地址、账号与门店;
- 收款、播报与账务:OCR、被扫收款、桌面形态、小票与退款查单;
- 网关管理 - 对外接口:
/elf与登录接口组的放行规则。