> ## Documentation Index
> Fetch the complete documentation index at: https://developers.uqpay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# POS 设备

> 商户后台「支付 > 终端 > POS 设备」页，查看名下所有 POS 设备的在线/离线状态、门店、硬件与最近交易，并注册新设备、按状态/门店/类型筛选、导出设备清单。

## 这是什么

这是商户后台「**支付**」模块「**终端**」下的 **POS 设备** 页面（左侧导航「终端」→ 顶部「POS 设备」标签）。商户在这里查看名下所有 POS 收款设备的在线/离线状态、所属门店、硬件信息（序列号、固件版本、IP 地址）与最近交易，并可注册新设备、按状态/门店/类型筛选、导出设备清单。想看某台刷卡机在不在线、绑在哪个门店、最近有没有交易，或新增一台 POS 机时，都从这里操作。

## 操作步骤

进入并查看设备列表：

1. 左侧导航点击「**终端**」。
2. 顶部选择「**POS 设备**」标签。
3. 列表默认展示名下所有设备；顶部统计条显示「总计 / 在线 / 离线」台数。

筛选与搜索：

1. 「**状态**」筛选：勾选在线（Online）/ 离线（Offline），可多选。
2. 「**门店**」筛选：按门店勾选，可多选。
3. 「**类型**」筛选：按设备类型勾选，可多选。
4. 「**搜索**」：按设备 ID、标签或序列号搜索。
5. 已生效的筛选会在「**筛选条件**」区以标签显示，点标签上的「×」移除单项，或点「**全部清除**」清空。

查看单台设备详情：点击某一行（或该行末尾「**⋯**」菜单 →「**查看详情**」），右侧滑出「**设备详情**」面板，含设备概览、硬件信息、最近交易与活动日志。

注册新设备：

1. 点右上角「**注册设备**」，弹出「注册设备」窗口。
2. 填「**序列号**」（必填，序列号位于设备背面）。
3. 填「**标签**」（必填，便于识别此设备的友好名称，如「前台」「收银 1」）。
4. 选「**设备类型**」（必填）。
5. 选「**分配至门店**」（必填，把设备归到某个门店）。
6. 点「**注册**」提交；缺必填项会提示「请填写所有必填字段」，成功后提示「设备已成功注册」。点「取消」放弃。

导出：点工具栏「**导出**」下载设备清单 CSV；勾选若干行后，蓝色批量条上点「**导出选中项**」只导出所选设备。

## 字段与状态含义

**列表列：**

| 列     | 含义（商户视角）           | 备注      |
| ----- | ------------------ | ------- |
| 设备 ID | 设备唯一编号             | 行内有复制按钮 |
| 标签    | 注册时填的设备友好名称（如「前台」） |         |
| 类型    | 设备型号/类型            |         |
| 状态    | 设备当前在线状态，见下        |         |
| 门店    | 设备所属门店             |         |
| 最后活跃  | 设备最近一次活动的时间        |         |

**设备状态：**

| 状态 | 含义         |
| -- | ---------- |
| 在线 | 设备已连接、正常可用 |
| 离线 | 设备当前未连接    |

**设备详情面板：**

* **设备概览**：设备 ID、状态（在线/离线）、标签、类型、最后活跃、门店。
* **硬件信息**：序列号、固件版本（旁边有「最新」或「有可用更新」徽标）、IP 地址。序列号、IP 均可复制。
* **最近交易**：该设备最近的交易记录，每条显示支付方式、时间、金额及币种、交易状态；无记录时显示「暂无最近交易」。
* **活动日志**：设备的连接与注册事件时间线。在线设备顶部显示「最后心跳」及时间；离线设备显示「已断开」及时间；无更多日志时显示「设备已注册 / 暂无活动日志」。

**固件版本徽标：**

| 徽标    | 含义          |
| ----- | ----------- |
| 最新    | 设备固件已是最新版本  |
| 有可用更新 | 设备固件有新版本可更新 |

## 边界与常见处理

* **列表显示「暂无设备」**：账户下还没有任何设备，提示「一旦开始活动，设备将显示在此处。」；点右上角「注册设备」添加。
* **筛选后「没有设备符合您的筛选条件」**：当前状态/门店/类型/搜索没有匹配项，提示「请尝试调整筛选条件。」，点「清除筛选」或「全部清除」后再看。
* **注册时点「注册」没反应 / 报错「请填写所有必填字段」**：序列号、标签、设备类型、分配至门店四项均为必填，任一缺失都会拦下并高亮。
* **注册失败提示「注册设备失败」**：提交被服务端拒绝，核对序列号是否正确、是否已被注册，稍后重试或联系客服。
* **设备显示「离线」**：设备当前未与系统连接，检查设备电源与网络；「最后活跃」列可看它上次在线的时间。
* **固件显示「有可用更新」**：表示有新固件版本；该页仅展示固件状态，如需升级请按设备指引或联系客服协助。
* **设备 ID / 序列号 / IP 想复制**：列表和详情面板对应字段旁都有复制按钮。

## 常见问法（Q→A）

* **Q：POS 设备在哪里看？/ 怎么查我所有的刷卡机？** A：左侧「终端」→ 顶部「POS 设备」标签，列表即名下全部设备。
* **Q：怎么注册/添加一台新 POS 机？** A：POS 设备页右上角「注册设备」，填序列号、标签，选设备类型和分配门店，点「注册」。
* **Q：注册设备要填什么？** A：序列号（设备背面）、标签（友好名称）、设备类型、分配至门店，四项都必填。
* **Q：设备状态有哪几种？在线和离线什么意思？** A：在线（设备已连接、正常可用）和离线（当前未连接）两种。
* **Q：设备显示离线怎么办？** A：检查设备电源和网络连接；「最后活跃」列显示它上次在线的时间。
* **Q：怎么看某台设备的序列号 / IP / 固件版本？** A：点该设备行进入「设备详情」，在「硬件信息」区查看序列号、固件版本、IP 地址。
* **Q：固件版本旁边写「有可用更新」是什么意思？** A：表示该设备有新固件可更新；此页只展示状态，升级请按设备指引或联系客服。
* **Q：怎么看某台设备最近的交易？** A：点设备进入详情面板，「最近交易」区列出该设备近期交易的支付方式、时间、金额和状态。
* **Q：怎么按门店筛选设备？** A：用顶部「门店」筛选勾选一个或多个门店。
* **Q：怎么导出设备清单？** A：工具栏点「导出」下载全部（或按当前筛选）的设备 CSV；也可勾选若干台后点「导出选中项」只导所选。
* **Q：设备 ID 或序列号怎么复制？** A：列表和详情面板里对应字段旁都有复制按钮，点一下即可复制。
* **Q：统计条上的总计/在线/离线是什么？** A：分别是名下设备总台数、当前在线台数、当前离线台数。