> ## 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.

# 总览（发卡总览）

> 商户后台「卡片 > 总览」页，一屏看各币种余额、卡片表现（签发数/拒付率/验证率/冲正率）和近期余额活动，并提供签发卡片、持卡人、活动、报表等快捷入口。

## 这是什么

这是商户后台「**卡片**」模块下的 **总览** 页面（左侧导航「卡片」→ 顶部标签「总览」，页面副标题「余额、卡片表现与近期活动」）。它是发卡业务的仪表盘首页，一屏汇总三块信息：各币种**账户余额**、**卡片表现**（签发数、拒付率、验证率、冲正率），以及最近的**余额活动**。想快速看整体卡片状况、余额够不够、拒付高不高，或从这里跳去签发卡片/看持卡人/看交易/导报表时，就用这一页。

## 操作步骤

进入总览：

1. 左侧导航点击「**卡片**」。
2. 顶部选择「**总览**」标签（同级还有：卡片、持卡人、交易、Low balance）。

看余额并充值：

1. 页面顶部是各币种**余额卡**，每张显示该币种的总额、可用、保证金，以及约合美元金额。
2. 点标题栏右侧「**充值**」可发起充值（从银行账户向发卡账户划转资金）。
3. 点某张余额卡可跳到该币种的交易列表。

看卡片表现：

1. 在「**卡片表现**」面板左侧圆环看当前**签发数 / 上限**与健康标签。
2. 中间「**按卡项目**」可切换「全部项目」或某个具体卡项目，右侧随之显示该项目的**拒付率 / 验证率 / 冲正率**及请求数、拒绝、冲正数。
3. 点右上角「**报表**」跳转报表页。

看近期活动 / 用快捷操作：

1. 「**余额活动**」表格显示最近的余额变动（预览），点「**查看全部**」进入完整交易列表。
2. 右侧「**快捷操作**」提供签发卡片、持卡人、活动、报表四个入口。

## 字段与状态含义

**余额卡字段**（每个币种一张卡）：

| 字段      | 含义（商户视角）                    |
| ------- | --------------------------- |
| {币种} 余额 | 该币种总额（可用 + 保证金），下方另显示约合美元金额 |
| 可用      | 当前可用余额                      |
| 保证金     | 冻结为保证金的余额                   |

> 余额卡按账户已开通的币种展示（默认顺序 SGD、USD、XUSD、HKD）；新账户或暂无数据时显示 SGD / USD 零额。

**卡片表现面板**：

| 指标            | 含义                           |
| ------------- | ---------------------------- |
| 签发数 / 上限      | 圆环中心显示已签发卡数，下方「共 N 张卡」为该项目上限 |
| 拒付率           | 授权被拒绝的比例                     |
| 验证率           | 验证（如 3DS/校验）比例               |
| 冲正率           | 交易冲正的比例                      |
| 请求数 / 拒绝 / 冲正 | 该项目的请求总数、被拒数、冲正数             |

**健康标签**（按拒付率自动判定）：

| 标签   | 触发条件      |
| ---- | --------- |
| 健康   | 拒付率 ≤ 20% |
| 关注   | 拒付率 > 20% |
| 拒绝偏高 | 拒付率 > 50% |

**余额活动表格列**（仅显示以下 5 列）：

| 列   | 含义                       |
| --- | ------------------------ |
| 参考号 | 交易参考号，行内可复制              |
| 类型  | 交易类型（见下）                 |
| 金额  | 交易金额，入账为绿色带「+」、出账为红色带「−」 |
| 时间  | 完成时间（无则显示创建时间）           |
| 状态  | 交易状态（见下）                 |

**交易状态**：

| 状态  | 含义    |
| --- | ----- |
| 已完成 | 交易已完成 |
| 处理中 | 交易处理中 |
| 失败  | 交易失败  |

**交易类型**：

| 类型   | 含义       |
| ---- | -------- |
| 充值   | 账户充值入账   |
| 转入   | 资金转入     |
| 转出   | 资金转出     |
| 授权   | 卡片授权（消费） |
| 撤销   | 授权撤销     |
| 卡片退款 | 卡片退款     |
| 卡片充值 | 给卡充值     |
| 卡片提现 | 卡片提现     |
| 手续费  | 手续费      |
| 退款   | 退款       |

> 本页交易类型文案与「卡片台账」页略有差异（台账页用另一套更细的类型词表），以各页实际显示为准。

**快捷操作**（右侧卡片）：

| 入口   | 说明        | 去向   |
| ---- | --------- | ---- |
| 签发卡片 | 创建虚拟卡或实体卡 | 创建卡片 |
| 持卡人  | 查看与管理持卡人  | 持卡人页 |
| 活动   | 浏览财务交易    | 交易页  |
| 报表   | 导出交易与台账   | 报表页  |

## 边界与常见处理

* **余额卡显示 0 或只有 SGD/USD**：新账户尚未开通币种或暂无数据时，会显示 SGD / USD 的零额占位，不代表出错。
* **余额活动显示「暂无余额活动」**：还没有余额变动，提示「卡片余额的变动将显示在这里」，有交易后自动出现。
* **卡片表现显示健康标签「拒绝偏高」**：说明所选项目拒付率超过 50%，属静态提示；具体为何拒付需结合交易/台账排查，不在本页答疑范围。
* **看不到「充值」按钮**：充值入口可能被账户配置隐藏，或当前为持卡人角色（持卡人角色只能访问卡片与卡片交易）。
* **只想看某个卡项目的数据**：在「按卡项目」里点选该项目，右侧指标即切换为该项目。

## 常见问法（Q→A）

* **Q：发卡总览在哪里看？/ 卡片首页在哪？** A：左侧「卡片」→ 顶部「总览」标签。
* **Q：怎么看我各币种的卡余额？** A：总览页顶部的余额卡，每个币种一张，显示总额、可用、保证金及约合美元。
* **Q：可用和保证金有什么区别？** A：可用=当前能用的余额；保证金=被冻结为保证金的部分；余额卡顶部总额是两者之和。
* **Q：怎么给发卡账户充值？** A：总览页标题栏右侧点「充值」，从银行账户向发卡账户划转。
* **Q：拒付率/验证率/冲正率在哪看？** A：总览页「卡片表现」面板，可按「全部项目」或某个卡项目查看。
* **Q：健康标签「关注」「拒绝偏高」是什么意思？** A：按拒付率判定——≤20% 健康，>20% 关注，>50% 拒绝偏高。
* **Q：总览的余额活动和交易页有什么区别？** A：总览只显示最近几条预览，点「查看全部」进入可搜索/筛选的完整交易列表。
* **Q：快捷操作能干什么？** A：一键去签发卡片、看持卡人、看财务活动、导报表。
* **Q：为什么我看不到充值按钮/总览页？** A：可能是账户隐藏了该入口，或你是持卡人角色（只能访问卡片和卡片交易）。
