> ## 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. 「**币种**」筛选：勾选一个或多个币种（USD / EUR / GBP / SGD / HKD），可多选。
4. 「**搜索**」：按参考 ID 搜索某笔提现。
5. 已生效的筛选会在「**筛选条件**」区以标签显示，点标签上的「×」移除单项，或点「**全部清除**」清空。

查看单笔提现详情：

1. 点击某一行（或该行「**⋯**」菜单 →「**详情**」）。
2. 右侧滑出「**提现详情**」面板，展示金额、状态、提现 ID、对账单描述、收款账户信息与处理时间线。

取消一笔提现（仅当状态为「已发起」或「处理中」时可用）：

1. 在「提现详情」面板点「**取消提现**」。
2. 弹窗二次确认，点「**确认**」取消该笔提现。

导出：工具栏「**导出**」打开「导出报告」弹窗，选日期类型/币种/日期范围/文件格式生成对账报告（报告异步生成，就绪后在「报告」页下载）；也可勾选列表中多行后点「**导出选中项**」直接下载 CSV（一次最多选 100 行）。

发起提现（页面右上角，需相应权限）：

1. 点右上角「**提现资金**」，打开「将资金提现至您的银行账户」弹窗。
2. 选「**币种**」（只能选已有余额的币种）；下方「提现金额」会显示该币种可用余额。
3. 在提现金额输入框填要提的金额，填写「**对账单描述**」（会显示在银行对账单上，最多 15 字符），可选填「内部备注」。
4. 选「**银行账户**」：UQPay Banking 内部账户为实时到账，外部银行账户为 1-3 个工作日。
5. 核对「支付金额」区的提现金额、手续费与总金额后，点「**提交**」。

管理提现计划 / 银行账户（页面右上角，需相应权限）：

1. 点右上角「**管理提现**」下拉。
2. 「**管理提现计划**」：设置自动提现（自动每日）或手动提现，并为每个币种指定默认收款账户。
3. 「**管理银行账户**」：查看、添加、编辑或删除收款银行账户。

## 字段与状态含义

**列表列：**

| 列     | 含义（商户视角）        | 备注    |
| ----- | --------------- | ----- |
| 参考 ID | 该笔提现的参考编号       | 行内可复制 |
| 银行账户  | 显示收款银行名与账号      |       |
| 金额    | 提现金额及币种         |       |
| 创建时间  | 提现发起时间          |       |
| 完成时间  | 提现完成时间，未完成显示「—」 |       |
| 状态    | 提现当前状态，见下       |       |

**顶部统计条：**

| 指标  | 含义                  |
| --- | ------------------- |
| 总计  | 当前筛选下的提现总笔数         |
| 总金额 | 提现总金额（仅在只筛选单一币种时显示） |
| 成功  | 成功的提现笔数             |
| 传输中 | 正在处理中的提现笔数          |
| 失败  | 失败的提现笔数             |

**提现状态（列表）：**

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

**提现状态（详情面板，更细）**：详情面板里状态可能进一步细分为 已发起、处理中、成功、已取消、失败、退款失败、冲正成功、已发起冲正、冲正处理中（冲正指资金原路退回的处理）。

**提现详情字段**：提现金额、状态、提现 ID、提现已完成（时间）、对账单描述、内部备注；「支付金额」区：提现金额、手续费、总金额；「账户详情」区：收款银行（账号以 \*\*\*\* + 后四位 显示）、创建时间、国家、SWIFT 代码 / BIC；以及「时间线」（各处理节点的时间）。

**发起提现弹窗字段**：

| 字段       | 含义                                          |
| -------- | ------------------------------------------- |
| 币种       | 提现币种，只能选已有余额的币种                             |
| 提现金额（余额） | 所选币种的当前可用余额，仅供参考                            |
| 提现金额（输入） | 本次要提现的金额，不能超过可用余额                           |
| 对账单描述    | 会显示在银行对账单上的标识，最多 15 字符                      |
| 内部备注     | 可选，仅内部记录                                    |
| 银行账户     | 收款账户；UQPay Banking 内部账户实时到账，外部银行账户 1-3 个工作日 |
| 手续费      | 按提现金额的一定比例收取，从 UQPay 余额中扣除，具体以弹窗提示为准        |
| 总金额      | 提现金额 + 手续费                                  |

**收款银行账户状态**（管理银行账户里显示）：内部账户显示「活跃」；外部账户审核状态显示为 Valid（有效）/ Invalid（无效）/ Pending（待审核）。

## 边界与常见处理

* **列表显示「暂无转账」**：账户下还没有任何提现记录，提示「一旦开始活动，转账将显示在此处。」。
* **筛选后「没有转账符合您的筛选条件」**：当前筛选没有匹配项，提示「请尝试调整筛选条件。」，点「清除筛选」清空后再看。
* **统计条不显示「总金额」**：只有在币种筛选里只选一个币种时才会显示总金额；多币种或不筛币种时不显示。
* **看不到「提现资金」或「管理提现」按钮**：这两个操作需要相应权限，没有权限时按钮不显示，需让管理员分配权限。
* **发起提现时选不到币种 / 提示「暂无可提现的币种」**：该账户还没有任何有余额的币种，收到结算后资金到账才能提现。
* **提现金额提交后报错「余额不足」或提示超过上限**：填写的金额超过了所选币种的可用余额，减小金额后重试。
* **对账单描述填不进更多字**：对账单描述最多 15 字符。
* **提现多久到账**：UQPay Banking 内部账户为实时到账，外部银行账户通常需要 1-3 个工作日。
* **看不到「取消提现」按钮**：只有状态为「已发起」或「处理中」的提现才能取消；已成功、已失败、已取消的提现不能再取消。
* **提现计划选了「手动」**：改为手动后将无法再查看哪些交易被打包到同一笔提现中。
* **导出的报告不在当前页面**：报告为异步生成，生成开始后到「报告」页下载，不在提现页直接下载。

## 常见问法（Q→A）

* **Q：提现记录在哪里看？/ 怎么查我的提现？** A：左侧「支付」→「概览」，进入后在顶部切到「提现」标签，列表即名下全部提现记录，可按状态/币种/日期筛选。
* **Q：怎么发起提现 / 把余额提到银行？** A：提现页右上角「提现资金」，选币种、填提现金额、选收款银行账户，核对手续费后点「提交」。
* **Q：提现多久到账？** A：提到 UQPay Banking 内部账户是实时到账，提到外部银行账户通常 1-3 个工作日。
* **Q：提现要手续费吗？多少？** A：要，手续费按提现金额的一定比例收取，从 UQPay 余额中扣除，具体比例和金额以发起提现弹窗里的提示为准。
* **Q：怎么取消一笔提现？** A：打开该笔「提现详情」，若状态是「已发起」或「处理中」，点「取消提现」并确认；已成功/失败/取消的无法再取消。
* **Q：提现有哪些状态？** A：列表里是待处理、处理中、成功、失败四种；详情面板里还可能细分为已发起、已取消、退款失败、冲正成功/已发起冲正/冲正处理中等。
* **Q：状态「传输中」是什么意思？** A：统计条里的「传输中」指正在处理中、尚未完成的提现笔数。
* **Q：「冲正」是什么意思？** A：冲正指提现资金原路退回的处理，详情状态里会显示冲正成功 / 已发起冲正 / 冲正处理中。
* **Q：为什么统计条没有「总金额」？** A：只有在币种筛选里只选一个币种时才显示总金额；多币种或未筛币种时不显示。
* **Q：怎么导出提现记录？** A：工具栏「导出」生成对账报告（异步，去「报告」页下载）；或勾选多行后点「导出选中项」直接下载 CSV（一次最多 100 行）。
* **Q：怎么设置自动提现？** A：提现页右上角「管理提现」→「管理提现计划」，选「自动」并为每个币种指定默认收款账户；也可切到「手动」。
* **Q：怎么添加 / 删除提现的银行账户？** A：右上角「管理提现」→「管理银行账户」，在里面添加、编辑或删除收款银行账户。
* **Q：发起提现时找不到要提的币种？** A：只能提有余额的币种；若提示「暂无可提现的币种」，说明该账户还没有到账余额，需先收到结算。
* **Q：对账单描述是什么、要填吗？** A：它是会显示在你银行对账单上的标识，便于识别为 UQPay 提现，最多 15 字符。
* **Q：这笔提现现在到底进行到哪一步 / 什么时候到账？** A：这属于单笔提现的实时进度，请以「提现详情」面板里的状态和时间线为准；语料不提供具体个案结论。