> ## 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. 顶部选择「**全部支付**」标签（另一标签「退款」是独立的退款列表页）。
3. 列表默认展示最近 3 个月的支付；用顶部筛选栏缩小范围。

筛选与搜索：

1. 「**日期**」：选时间范围（默认最近 3 个月，可选「全部时间」或自定义起止日期）。
2. 「**金额**」：设最小/最大金额区间。
3. 「**状态**」：勾选一个或多个支付状态，可多选（见下表）。
4. 「**币种**」：勾选一个或多个币种。选**单一币种**时统计条才会显示「金额」合计、图表才能按金额展示。
5. 「**支付方式**」：勾选一个或多个支付方式（卡、各类钱包等）。
6. 「**搜索**」：按支付 ID、商户订单 ID 或客户邮箱搜索。
7. 已生效的筛选会在「**筛选条件**」行以标签显示，点标签上的「×」移除单项，或点「**全部清除**」清空。

查看统计与趋势图：筛选栏下方统计条显示「**总计 / 金额 / 成功 / 待处理 / 失败**」；点「**显示图表**」展开趋势图，可切换柱状图/折线图，以及「金额 / 数量」两种口径（金额口径需先选定单一币种）。

查看单笔详情：点击任意一行（或该行「**⋯**」菜单 →「**查看详情**」），右侧滑出「**支付详情**」面板。

对单笔支付操作：点某行末尾「**⋯**」菜单，按该笔支付情况显示可用操作——查看详情、复制支付 ID、复制订单 ID，以及（有权限且该笔可操作时）退款、取消。

退款一笔支付：在「⋯」菜单或详情面板点「**退款**」，在「发送退款」弹窗填退款金额（不超过可退款金额）、选原因（重复 / 欺诈 / 客户要求 / 其他）、可补充说明，点「**退款**」提交。

取消一笔支付：在「⋯」菜单或详情面板点「**取消**」，弹窗二次确认后点「**确认**」。

导出：点右上角「**导出**」，在「**导出报告**」弹窗按日期类型和币种范围生成支付报告——报告异步生成，就绪后到「**报告**」页面下载；也可勾选多行后在选择条点「**导出选中项**」直接导出所选记录。

## 字段与状态含义

**列表列：**

| 列       | 含义（商户视角）                    | 备注        |
| ------- | --------------------------- | --------- |
| 参考 ID   | 该笔支付的唯一编号                   | 行内可复制     |
| 商户订单 ID | 你自己系统的订单号；没有则显示「---」        | 行内可复制     |
| 类型      | 该笔支付所用支付方式的类型（卡交易显示卡品牌）     |           |
| 金额      | 支付金额及币种                     | 可点表头按金额排序 |
| 状态      | 支付当前状态，见下                   |           |
| 支付方式    | 实际使用的支付方式（卡显示卡号，其余显示方式名及图标） |           |
| 创建时间    | 支付创建的日期时间                   | 可点表头按时间排序 |

**支付状态：**

| 状态                            | 含义（商户视角）               |
| ----------------------------- | ---------------------- |
| 需要支付方式                        | 支付已发起，等待客户选择/提供支付方式    |
| 需要客户操作                        | 等待客户完成额外验证或操作（如 3D 验证） |
| Requires Capture（屏显文案以线上实际为准） | 款项已授权、等待完成扣款           |
| 待处理                           | 支付处理中，尚无最终结果           |
| 已成功                           | 支付成功                   |
| 已退款                           | 该笔支付已发生退款              |
| 已取消                           | 支付已取消                  |
| 失败                            | 支付失败                   |

> 统计条里的「待处理」为汇总口径：把 待处理、需要支付方式、需要客户操作、Requires Capture 几种「进行中」状态一并计入。

**统计条指标：**

| 指标  | 含义                        |
| --- | ------------------------- |
| 总计  | 当前筛选条件下的支付总笔数             |
| 金额  | 当前筛选下的支付总金额（仅当只选了一个币种时显示） |
| 成功  | 状态为已成功的笔数                 |
| 待处理 | 各类进行中状态的笔数合计              |
| 失败  | 状态为失败的笔数                  |

**支付详情面板** 分区展示：

* **交易概览**：支付 ID、商户订单 ID、账户 ID、类型、客户邮箱、描述，以及金额与状态。
* **支付明细**：支付金额、处理费、净额、净额结算时间。
* **支付方式**：方式；卡支付还会展示卡号、有效期、卡片类型、国家、账单地址。
* **详情**：创建时间、完成时间、最后更新，以及风险评估（**正常** 或 **已拦截**）。
* **最近活动**：该笔支付的状态变更时间线。

**退款弹窗字段**（「发送退款」）：可退款金额（只读，本笔最多可退金额）、退款金额（不得超过可退款金额，且需大于 0）、原因（重复 / 欺诈 / 客户要求 / 其他）、补充说明（可选）。提交后有提示「退款需要 5-10 天才会显示在客户的对账单上」。

**添加到拦截列表**（详情面板「⋯」→「添加到拦截列表」）：可勾选按 卡号 / 邮箱 / IP 地址 拦截，并设定移除时间（不要移除 / 30 天 / 90 天 / 180 天 / 1 年）。加入后会拦截所有具有相同特征的未来扣款——仅在确认对方并非合法客户时使用。

## 边界与常见处理

* **列表显示「暂无支付」**：账户下还没有支付记录，提示「一旦开始活动，支付将显示在此处。」
* **筛选后「没有支付符合您的筛选条件」**：当前筛选没有匹配项，提示「请尝试调整筛选条件。」，点「清除筛选」或「全部清除」再看。
* **统计条不显示「金额」合计 / 图表金额口径灰掉**：需先在「币种」筛选里只选一个币种；选了多个或未选币种时只按笔数统计（提示「选择单个币种查看金额」）。
* **「⋯」菜单里没有「退款」或「取消」**：该笔支付当前不可退款/不可取消，或你的账号没有相应操作权限。
* **退款金额填不进 / 提交被拦下**：退款金额必须大于 0 且不超过「可退款金额」，超出会提示「超出可退款金额」。
* **批量选择导出有上限**：一次最多可勾选 100 条用于导出，达到上限后无法再继续勾选，界面会给出已达上限的提示。
* **参考 ID / 订单 ID 太长显示不全**：列表做了截断显示，鼠标悬停行内用复制按钮可复制完整值，或用「⋯」菜单的「复制支付 ID / 复制订单 ID」。

## 常见问法（Q→A）

* **Q：我的收款/支付记录在哪里看？** A：左侧「交易」→ 顶部「全部支付」标签，列表即名下全部收单支付。
* **Q：怎么按订单号 / 客户邮箱找一笔支付？** A：用顶部「搜索」框，支持按支付 ID、商户订单 ID、客户邮箱搜索。
* **Q：支付一共有哪些状态？** A：需要支付方式、需要客户操作、Requires Capture（款项已授权待完成扣款）、待处理、已成功、已退款、已取消、失败。
* **Q：状态「需要客户操作」是什么意思？** A：这笔支付在等客户完成额外验证或操作（例如 3D 验证），还没走完。
* **Q：怎么给客户退款？** A：找到该笔支付，在「⋯」菜单或详情面板点「退款」，填退款金额、选原因后点「退款」提交。退款一般 5-10 天显示在客户对账单上。
* **Q：退款金额可以超过原支付金额吗？** A：不可以，最多只能退到「可退款金额」，超出会被拦下。
* **Q：怎么取消一笔支付？** A：在该笔「⋯」菜单或详情面板点「取消」，确认后即发起取消（需具备取消权限，且该笔当前可取消）。
* **Q：为什么有的支付没有「退款」或「取消」选项？** A：该笔当前状态不支持退款/取消，或你的账号没有对应操作权限。
* **Q：统计里的「金额」为什么不显示？** A：金额合计只在「币种」筛选选定单一币种时显示；选多个或不选币种时只统计笔数。
* **Q：怎么导出支付数据 / 报告？** A：点右上角「导出」，在「导出报告」弹窗按日期类型和币种生成支付报告——报告异步生成，就绪后到「报告」页面下载；也可勾选若干行后点「导出选中项」直接导出所选记录。
* **Q：「添加到拦截列表」是做什么的？** A：把某个卡号/邮箱/IP 加入拦截，之后相同特征的扣款都会被拦下，可设定多久后自动移除；仅在确认不是合法客户时使用。
* **Q：详情里的「风险评估」显示「已拦截」是什么意思？** A：这笔支付被风控判定并拦截；显示「正常」则表示风控未拦截。
* **Q：全部支付和「退款」标签有什么区别？** A：「全部支付」是所有收单支付的列表，「退款」标签是独立的退款记录列表页。
* **Q：这笔支付现在到底到哪一步了 / 什么时候到账？** A：这属于单笔的实时进度，请以详情面板里的状态和「最近活动」时间线为准；语料不提供具体个案结论。
