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

# 卡片台账

> 商户后台「卡片台账」页，按卡逐条查看余额变动记录（起始余额→金额→结束余额），可按类型/状态/参考ID/卡号/日期筛选并导出。

## 这是什么

这是商户后台发卡模块的 **卡片台账** 页面（页面在「卡片」模块下，通常从某张卡的「**⋯**」菜单 →「**查看卡片台账**」进入，也可直接访问 `/issuing/card-ledger`）。台账逐条记录卡片的**余额变动**：每条都有起始余额、本次金额、结束余额，用来做卡片层面的对账和流水核查。想核对某张卡钱怎么变的、某笔扣款/退款有没有到账、或按参考号/卡号查一条记录时，就用这一页。

## 操作步骤

进入卡片台账：

1. 在「卡片」页某张卡的「**⋯**」菜单选「**查看卡片台账**」进入该卡台账；或直接访问台账页看全部条目。
2. 从某张卡进入时，顶部会显示「**路由卡**」筛选标签，表示当前只看这张卡。

筛选与查找：

1. 用「**类型**」筛选按交易类型过滤（单选）。
2. 用「**状态**」筛选按交易状态过滤（已批准 / 已拒绝）。
3. 用「**参考 ID**」搜索框按参考号查（支持历史记忆）。
4. 用「**卡号**」搜索框按卡号查（自动忽略非数字字符）。
5. 用「**日期范围**」按时间段过滤。
6. 已生效的筛选会显示为「筛选条件」标签，点「**全部清除**」重置。

导出：

1. 点工具栏「**导出**」通过报表弹窗生成台账报表。
2. 或勾选若干行后，在选中栏点「**导出选中项**」导出所选条目为 CSV。

## 字段与状态含义

**列表列**：

| 列     | 含义（商户视角）                               |
| ----- | -------------------------------------- |
| 参考 ID | 台账条目参考号（行内可复制），下方显示创建时间                |
| 卡片    | 卡号，下方显示卡片名称（若有）                        |
| 类型    | 交易类型（见下），徽标按方向着色                       |
| 起始余额  | 本次变动前的卡片余额 + 币种                        |
| 金额    | 本次变动金额，入账为绿色带「+」、出账为红色；若账单币种不同会另显示账单金额 |
| 结束余额  | 本次变动后的卡片余额 + 币种                        |
| 状态    | 交易状态（见下），下方显示备注（若有）                    |

**交易状态**（筛选可选值）：

| 状态  | 含义     |
| --- | ------ |
| 已批准 | 该笔交易通过 |
| 已拒绝 | 该笔交易被拒 |

**交易类型**（类型筛选选项；徽标颜色按资金方向：入账绿 / 出账橙 / 中性灰）：

| 类型    | 方向 |
| ----- | -- |
| 入金    | 入账 |
| 转入    | 入账 |
| 转出    | 出账 |
| 授权    | 出账 |
| 冲正    | 入账 |
| 卡退款   | 入账 |
| 资金归集  | 入账 |
| 卡充值   | 出账 |
| 卡提现   | 入账 |
| 手续费   | 出账 |
| 退款    | 入账 |
| 调整    | 中性 |
| 结算借记  | 出账 |
| 结算贷记  | 入账 |
| 结算冲正  | 中性 |
| 拒付借记  | 出账 |
| 拒付贷记  | 入账 |
| 资金转入  | 中性 |
| 资金转出  | 中性 |
| 手续费退款 | 中性 |
| 手续费扣除 | 中性 |
| 保证金支付 | 中性 |
| 保证金退款 | 中性 |
| 其他    | 中性 |

> 台账类型词表比总览页更细，同一类型二者中文可能不同（如总览显示「充值」、台账显示「入金」），以各页实际显示为准。

## 边界与常见处理

* **列表显示「暂无台账条目」**：该卡还没有余额变动，提示「卡片余额变化将显示在此处」。
* **筛选后「没有条目符合您的筛选条件」**：当前筛选无匹配，提示「请尝试调整筛选条件」，清空筛选再看。
* **顶部有「路由卡」标签**：说明是从某张卡进入、只看这张卡；清除筛选可看更大范围（若权限允许）。
* **金额下方多出一行括号金额**：账单币种与交易币种不同，括号内为账单币种金额。
* **加载/刷新提示**：首次加载显示「正在加载台账条目…」，后台刷新时底部显示「正在刷新台账条目…」。
* **卡号搜不到**：卡号搜索会自动去掉非数字字符，按纯数字卡号匹配；输入带空格/掩码也可。
* **列表报红色错误文字**：数据加载失败，错误信息直接显示在表格区域，可稍后重试。

## 常见问法（Q→A）

* **Q：卡片台账在哪看？/ 怎么查一张卡的流水？** A：在「卡片」页某张卡的「⋯」菜单选「查看卡片台账」，即进入该卡台账。
* **Q：台账和卡片交易有什么区别？** A：台账是卡片**余额变动**的逐条记录（有起始/结束余额，便于对账）；卡片交易更偏授权/结算明细。
* **Q：起始余额、金额、结束余额怎么理解？** A：结束余额 = 起始余额 ± 本次金额；一行就是一次余额变动的前后快照。
* **Q：怎么按参考号或卡号查台账？** A：用顶部「参考 ID」或「卡号」搜索框输入查询。
* **Q：台账状态「已批准」「已拒绝」是什么意思？** A：已批准=该笔交易通过；已拒绝=该笔被拒。
* **Q：怎么导出卡片台账？** A：工具栏「导出」用报表弹窗生成台账报表，或勾选行后「导出选中项」导 CSV。
* **Q：为什么金额有两个数字（带括号）？** A：交易币种和账单币种不同，括号里是账单币种的金额。
* **Q：类型里「入金」「卡充值」这些是什么？** A：都是余额变动的交易类型，入账（绿）如入金/转入/退款，出账（橙）如授权/卡充值/手续费。
* **Q：我只想看某一张卡的台账怎么办？** A：从那张卡的「⋯」→「查看卡片台账」进入，顶部会带「路由卡」标签只显示这张卡。