简体中文
收款精灵:安装与登录
本页覆盖装到收银电脑之前的服务端准备、安装升级、登录与门店终端。
服务端准备
收款精灵直连 DaxPay 后端,不经过收银系统网关。部署侧与商户侧需要确认四项:
后端包含精灵模块
daxpay-payment-elf 是 DaxPay 标准构建的一部分,主应用启动模块已依赖该模块,随主应用一起编译部署,不需要单独启动服务。如果后端做过裁剪,确认该模块仍在依赖中,并且 /elf/** 端点可以访问。
网关放行 /elf
使用运维面板部署时,在「网关管理 → 对外接口」确认「桌面收款终端」(/elf)规则已开启,该规则默认开启。规则会整段放行 /elf/,请求仍受商户登录态与 merchant 身份域保护。
登录链路复用「小程序 / APP API」规则中的 /token、/nonce、/captcha 接口,该规则同样默认开启。如果关闭了这条规则又没有绑定移动端 API 域名,登录接口会返回 404。完整说明见网关管理 - 对外接口。
创建收银员账号
商户管理员在商户端「商户中心 → 基础管理 → 商户用户」创建账号,角色选「商户收银员」。该角色授予交易订单查看、交易订单管理与退款权限,覆盖收款、查单和退款操作。账号创建见商户用户。
收款精灵使用商户身份域登录,只能使用商户端账号。
准备门店、应用与终端
在商户端准备好要使用的门店与支付应用,收款精灵登录后只列出启用项。需要区分不同收银机时,可先在「设备管理 → 商户终端」建立终端台账,并在门店管理中设置默认终端,见支付设备管理 - 商户终端与商户资料与门店 - 门店管理。
安装与升级
选择安装包
| 安装包 | 文件名 | 说明 |
|---|---|---|
| 标准版 | DaxPayOpenElf-Setup-<版本>.exe | 约 59MB,自带 .NET 10,装完即用 |
| 轻量版 | DaxPayOpenElf-Setup-<版本>-fdd.exe | 约 12MB,需预装 .NET 10 Desktop Runtime |
安装包按部署的平台地址打包,经私有下载链接交付。私有链接使用固定文件名时,分别为 DaxPayOpenElf-Setup.exe 与 DaxPayOpenElf-Setup-fdd.exe。
安装步骤
- 双击安装包,按向导选择安装目录、开始菜单与桌面快捷方式。默认安装到
{autopf}\DaxPayOpenElf,程序为DaxPayOpenElf.exe; - 安装包未做代码签名时,Windows 可能提示「已保护你的电脑」,点「更多信息 → 仍要运行」继续;
- 同一安装包重复运行即覆盖升级。安装器与旧版收款精灵(
DaxPosElf)、另一套收款精灵(DaxPayElf)的安装标识不同,可在同一台电脑上并存;旧版数据目录不会被读取、迁移或删除; - 数据目录为
%APPDATA%\DaxPayOpenElf\,包含config.json、logs、trades.db、credential.bin与print-dump。卸载不会删除该目录。
配置服务端地址
登录窗口不显示服务端地址,地址由部署方在安装时预置。读取优先级从高到低:
elf.defaults.json,放在 exe 同目录;config.json的gateway.baseUrl,文件位于数据目录;- 安装包构建时烧入的默认地址。
换地址时在 exe 同目录放一个 elf.defaults.json:
json
{ "gateway": { "baseUrl": "https://pay.example.com" } }保存后重启程序生效。安装在 Program Files 目录时,写入该文件需要管理员权限。
界面语言
收款精灵界面支持 10 种语言:简体中文、繁体中文(台湾 / 香港)、英语、日语、韩语、印尼语、马来语、泰语、越南语。
- 登录页右上角的地球按钮可在登录前切换界面语言,也可选「跟随系统」;
- 登录后在设置窗「通用 → 界面语言」中切换,选择即生效,无需重启程序;
- 语音播报与小票打印固定中文:语音使用中文 TTS 与预录词元,小票受热敏打印机 GBK 字库限制,其他语言字符无法打印;
- 金额、日期与货币符号不随界面语言变化,保证对账口径一致。
登录与安全
账号由商户管理员在商户端创建,并分配「商户收银员」角色。登录流程:
- 密码经 RSA 公钥加密后传输,并带 nonce 防重放;连续登录失败会要求输入图形验证码;
- 开启 TOTP 两步验证的账号,还需要输入动态口令;
- 首次登录或密码过期时,会要求先修改密码,改密后进入主流程;
- 登录凭证只保存在内存中;勾选「记住密码」时,账号密码经 Windows DPAPI(当前用户)加密后保存在本机,下次登录自动回显;
- 登录态失效时会清除 token 并弹出登录窗,重新登录后继续使用。
门店与终端
登录成功后,收款精灵自动拉取当前商户的启用门店、应用与终端:
- 只有一个门店时自动选中;多个门店时弹窗选择。取消选择不阻塞登录,但收款入口保持禁用;
- 未选择门店时禁止收款,避免订单归属错位;
- 门店跟这台电脑走,不跟账号。收银窗顶部显示「门店 · 账号」,点「切换门店」可更换;同一台电脑上同商户的其他账号登录会沿用该门店;
- 支付应用由门店带出,收银员不需要选择应用;
- 收银终端在「收银设置 → 账号」的收银门店卡片中选择,可选「跟随门店默认」或当前门店的某个终端。选择只保存在本机,换电脑、重装或清理配置后需重新选择。
常见问题
服务端地址填错或需要换地址
关闭程序,在 exe 同目录新建或修改 elf.defaults.json,写入正确的 gateway.baseUrl,重启生效。该文件优先级最高,会覆盖 config.json 中的地址;安装在 Program Files 下时用管理员权限保存。
登录接口返回 404
检查网关「对外接口」中的「小程序 / APP API」规则是否开启,或是否已绑定移动端 API 域名。该规则关闭且未绑定域名时,登录接口会返回 404。
账号无法登录
确认账号是商户端创建的「商户收银员」,且门店、应用处于启用状态。收款精灵不接受运营端账号。多店登录时取消门店选择,收款入口会保持禁用,点「切换门店」重新选择即可。