> ## 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 筛选，导出退款对账数据，并点开单条退款查看完整详情。想查某笔退款到了哪一步、退款是否成功、导出退款明细时，都从这里进。

> **发起退款不在本页操作。** 退款要从对应的那笔支付发起（在「全部支付」标签找到该支付并打开发起退款）；发起后，退款记录会出现在本页供你追踪。详见下方「常见问法」。

## 操作步骤

进入退款列表：

1. 进入「**支付**」模块，左侧点「**交易**」。
2. 顶部选择「**退款**」标签（同级还有「全部支付」）。
3. 列表默认展示最近 3 个月的退款；用工具栏筛选缩小范围。

筛选与搜索：

1. **日期**：用日期范围选择器选时间段，或选「全部时间」。
2. 「**状态**」：勾选一个或多个退款状态（成功 / 已发起 / 处理中 / 失败），可多选。
3. 「**币种**」：勾选一个或多个币种筛选。
4. **金额范围**：填最小 / 最大金额筛选。
5. 「**搜索**」：按退款 ID 或支付 ID 搜索（提示「按退款 ID、支付 ID 搜索…」）。
6. 已生效的筛选会在「**筛选条件**」区以标签显示，点标签上的「×」移除单项，或点「**全部清除**」清空。

查看单条退款详情：

1. 点击某一行（或该行「**⋯**」菜单 →「**查看详情**」）。
2. 右侧滑出「**退款详情**」面板，展示金额、状态、双方 ID、支付明细、支付方式、时间线等。

查看趋势图：点统计条右侧「**显示图表**」，可切换「金额 / 数量」与柱状 / 折线；查看「金额」图需先只选一个币种（否则提示「选择单个币种查看金额」）。

导出：

* 工具栏「**导出**」打开「导出报告」弹窗，生成退款报告（报告异步生成，就绪后到「报告」页面下载）。
* 勾选若干行后，顶部选择条出现「**导出选中项**」，把选中的退款导出为文件（一次最多选 100 条）。

## 字段与状态含义

**列表列：**

| 列     | 含义（商户视角）     | 备注    |
| ----- | ------------ | ----- |
| 退款 ID | 该条退款的编号      | 行内可复制 |
| 支付 ID | 该退款对应的原始支付编号 |       |
| 金额    | 退款金额及币种      |       |
| 状态    | 退款当前状态，见下    |       |
| 原因    | 退款原因         |       |
| 日期    | 退款创建时间       |       |

**退款状态：**

| 状态  | 含义         |
| --- | ---------- |
| 已发起 | 退款已发起、等待处理 |
| 处理中 | 退款处理中      |
| 待处理 | 退款待处理      |
| 成功  | 退款成功       |
| 失败  | 退款失败       |

> 列表顶部工具栏的「状态」筛选可选：成功、已发起、处理中、失败。

**统计条**：列表上方有四个计数——**Total（总数）**、**Succeeded（成功）**、**Pending（待处理）**、**Failed（失败）**，随当前筛选条件实时统计。

**退款详情面板字段**：

* **交易概览**：退款金额、状态、退款 ID、支付 ID、商户订单 ID、类型、账户、账户 ID、原因、描述、来源。
* **支付明细**：退款金额、处理费、净额、净额结算时间。
* **支付方式**：方式、产品、卡号、卡片类型、国家。
* **详情**：创建时间、完成时间、最后更新。
* **时间线**：该退款的处理节点记录（无数据时显示「暂无时间线数据」）。

**退款类型（详情面板「类型」）：**

| 类型 | 含义   |
| -- | ---- |
| 退款 | 常规退款 |
| 冲正 | 冲正   |
| 取消 | 取消   |

## 边界与常见处理

* **列表显示「暂无退款」**：账户下还没有任何退款记录，提示「一旦开始活动，退款将显示在此处。」
* **筛选后「没有退款符合您的筛选条件」**：当前筛选没有匹配项，提示「请尝试调整筛选条件。」，点「清除筛选」或「全部清除」再看。
* **图表「金额」选项点不了 / 变灰**：查看金额趋势需要只选一个币种；选了多个或没选币种时只能看「数量」图，提示「选择单个币种查看金额」。
* **一次只能选 100 条导出**：批量选择上限为 100 条；超出会有提示，请分批导出或先用筛选缩小范围。
* **想发起退款却找不到入口**：退款不在本页发起，要去「全部支付」标签打开对应支付发起（见下）。
* **单条退款卡在「处理中 / 已发起」**：这属于该笔退款的实时进度，以详情面板里的状态与时间线为准；退款通常需要一段时间才会显示在客户对账单上。

## 常见问法（Q→A）

* **Q：我的退款记录在哪里看？/ 怎么查退款？** A：「支付」→ 左侧「交易」→ 顶部「退款」标签，列表即名下全部退款；可按日期、状态、币种、金额、退款/支付 ID 筛选。
* **Q：怎么发起退款 / 申请退款？** A：退款不在「退款」标签里发起。去「全部支付」标签找到要退的那笔支付，打开后发起退款（填退款金额、选原因如重复/欺诈/客户要求/其他，提交）。提交后该退款会出现在「退款」列表里追踪。
* **Q：退款有哪些状态？** A：已发起、处理中、待处理、成功、失败；顶部「状态」筛选可按成功、已发起、处理中、失败筛选。
* **Q：状态显示「处理中 / 已发起」是什么意思？** A：退款已提交、正在处理中，还没到最终结果；以详情面板的状态和时间线为准。
* **Q：退款多久到账 / 多久显示在客户账单上？** A：退款通常需要 5–10 天才会显示在客户的对账单上；具体到账时间以卡组织/发卡行为准。
* **Q：怎么按退款 ID 或支付 ID 找退款？** A：用工具栏「搜索」，输入退款 ID 或支付 ID 搜索。
* **Q：怎么导出退款数据 / 退款对账报表？** A：工具栏「导出」打开「导出报告」弹窗生成退款报告；或勾选若干行后点「导出选中项」（一次最多 100 条）。
* **Q：退款详情里能看到哪些信息？** A：退款金额、状态、退款 ID、支付 ID、商户订单 ID、类型、账户、原因、描述、支付明细（退款金额/处理费/净额/净额结算时间）、支付方式（方式/产品/卡号/卡片类型/国家）、创建/完成/更新时间和处理时间线。
* **Q：退款详情里的「处理费」「净额」是什么？** A：处理费是本次退款产生的手续费，净额是扣费后的实际金额；净额结算时间是净额的结算时间点。
* **Q：类型里的「冲正」和「退款」有什么区别？** A：「退款」是常规退款；「冲正」「取消」是另两种退款类型，按该笔记录实际类型显示。
* **Q：怎么只看某个币种或某段时间的退款？** A：用工具栏「币种」勾选币种、日期范围选择器选时间段，还可用「金额」范围进一步筛选。
* **Q：我这笔退款现在到底到哪一步 / 什么时候能到账？** A：这属于单条退款的实时进度，请以详情面板里的状态和时间线为准；语料不提供具体个案结论。
