> ## Documentation Index
> Fetch the complete documentation index at: https://waffo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 提现异常与状态

> 提现在审核时被拒绝、被银行拒付，或在已成功后被退回时会发生什么：完整的状态链、提现费用是否退回、一次退回会产生哪些 Account History 行、Description 列在各状态下显示什么，以及为什么 Withdraw 按钮可能是灰的。

[提现与批量付款 FAQ](/docs/zh/support/withdrawal-and-batch-payout-faq) 覆盖正常路径：费用、
收款账户、账单和状态列表。本页覆盖**提现未能完成时会发生什么**——在审核时被拒绝、被银行
拒付，或在已成功后被退回——以及每种结果对你的钱、你的费用和你的账本有什么影响。余额和
Account History 本身在
[余额与 Account History](/docs/zh/support/balance-and-account-history-faq) 中描述。

## 提现的完整状态链是什么？

提现有三种不好的结局，它们是真正不同的状态，而不是一个笼统的失败：

| Portal 状态 | 含义 | 终态？ |
| - | - | - |
| `Not Submitted` | 已创建但你尚未提交 | 否 |
| `Under Review` | 已提交，Waffo 正在审核 | 否 |
| `Rejected` | 审核拒绝了它——在任何付款指令到达银行**之前** | 是 |
| `Processing` | 审核通过；付款正在处理 | 否 |
| `Result Submitted` | 结果已返回，正在最终确认 | 否 |
| `Success` | 已完成 | 是 |
| `Failed` | 未完成。涵盖记录为失败的审核阶段拒绝，**以及**银行拒绝付款的情况 | 是 |
| `Closed` | 未完成即关闭 | 是 |
| `Bank Return` | 资金已经划出，收款银行已将其退回。正在确认中 | 否 |
| `Bank Return Confirmed` | 退回已确认并入账 | 是 |

这里有两点容易误读：

* **`Rejected` 和 `Failed` 不是同一个事件。** `Rejected` 意味着从未有指令发给银行。
  `Processing` 之后的 `Failed` 意味着指令确实发出了，而银行拒绝了它。
* **`Bank Return` 不是终态。** 它意味着一笔已完成的提现正在被撤回。一旦退回以及银行为此
  收取的任何费用入账，它就变为 `Bank Return Confirmed`。

## 为什么我的提现自己关闭了？

因为它在创建后几个小时仍处于 `Not Submitted`，一次自动清理把它关闭了。

在 Portal 中申请提现是**两个**步骤。输入金额会创建提现订单并使其停留在 `Not Submitted`；
随后的确认页面才是真正提交它的地方。如果你从未走完那个页面——关掉了标签页、走开了、
会话丢失——订单就一直停在那里。经过固定的几个小时后，系统把它移至 `Closed`。

| | 在 Portal 中发起的提现 | 通过 API 创建的提现 |
| - | - | - |
| 在 `Not Submitted` 等待第二步 | 是，直到你确认 | 否——一次调用即创建并提交 |
| 停留在 `Not Submitted` 时自动关闭 | **是，创建后几个小时** | **否，永不** |
| 如果提交步骤未完成 | 你再次确认，否则它会关闭 | 稍后自动完成 |

清理按计划运行而不是按每单计时器，所以关闭可能比截止时间稍晚落地。只有在 Portal 中发起的
提现才符合条件：通过 API 创建的提现由你提供的 `withdrawRequestId` 标识，完全排除在清理之外。

由此得出两点，这也是为什么 `Closed` 的提现很少成为问题：

* **没有任何扣款。** 你的结算账户在你**确认**时扣款，而不是在申请创建时。未提交即关闭的
  提现从未触及你的余额，所以没有需要等待的冲正，也没有需要对账的账本行。
* **从确认页面退出会立即产生同样的效果。** 在那里取消会当场关闭订单，而不是留给清理。
  同样的 `Closed` 状态，同样没有任何资金流动。

`Closed` 是终态，在 API 上映射为 `FAILURE`。如果之后还是要提现，请重新申请。

## 我创建提现时 API 返回了 `E0001 Unknown status`。是失败了吗？

不是——把它当作未知，正如已发布的
[错误码](/docs/zh/developer-docs/tools-and-references/developer-tools/error-codes) 参考所说。
提现订单可能已经存在并且已在向前推进：一笔已创建但提交步骤未完成的 API 提现会在稍后
被自动接手并完成。

所以**不要**为同一意图创建第二笔提现。用你的 `withdrawRequestId` 查询第一笔——见
[提现与余额 API](/docs/zh/support/withdrawal-and-balance-api-faq)——并根据返回的状态行动。
创建替代订单正是商户付出两次款的方式。

## 提现 API 报告的状态我在 Portal 中看不到。为什么？

因为 API 有意报告一个更小的集合，这样你的集成就不必跟踪每一个操作步骤。映射如下：

| API 状态 | 它覆盖的 Portal 状态 |
| - | - |
| `IN_PROGRESS` | `Not Submitted`、`Under Review`、`Processing`、`Result Submitted` |
| `SUCCESS` | `Success` |
| `FAILURE` | `Rejected`、`Failed`、`Closed`、`Bank Return Confirmed` |
| `BANK_DISPUTE_NOTIFIED` | `Bank Return` |

`BANK_DISPUTE_NOTIFIED` 是值得显式处理的那一个：它**还不是**失败。把它当作"一笔已完成的
提现正在被冲正"，并等待后续，退回确认后它将是 `FAILURE`。轮询顺序见
[提现与余额 API](/docs/zh/support/withdrawal-and-balance-api-faq)。

## 提现失败时我能拿回提现费用吗？

完全取决于付款指令是否已经发给了银行：

| 结果 | 费用 |
| - | - |
| **审核时被拒绝**（`Rejected`） | **退还。** 提现全额（含费用）贷记回你的结算账户。不收费，因为没有任何东西发给银行 |
| **银行拒绝付款**（`Processing` 之后的 `Failed`） | **不退还。** 提现金额**扣除费用后**贷记回来 |
| **成功后银行退回资金**（`Bank Return Confirmed`） | **不退还。** 同样处理——冲正扣除费用 |

背后的规则：一旦 Waffo 发出了付款指令，工作及其成本就已发生。当失败由收款账户导致——
信息错误、账户已关闭或受限——费用照收。当提现从未离开审核阶段时，则不收。

对于**跨币种**提现，冲正改为按全额入账，因为该路径上的费用与银行的退回费用一起处理，
而不是单独扣除。无论哪种方式，你都不会被收两次费。

费用本身始终**内含**扣除——汇出金额是你的提现金额减去费用——所以"退还费用"只是意味着
原始全额回来了。

## 提现费用是从我输入的金额中扣除，还是在其之上另收？

从中扣除。你输入的金额是**总额**：这是离开你结算账户的数字，费用在汇款发出之前从中扣除。

| 数字 | 与你输入金额的关系 |
| - | - |
| 提现金额 | 你输入的金额。从你的结算账户**全额**扣除 |
| 提现费用 | 从该金额中扣除，并以你的收款币种收取 |
| 预期收到金额 | 提现金额**减去**提现费用 |

对同币种提现而言，这意味着到达你银行的数字总是小于你输入的数字。如果必须到账某个特定金额，
请申请该金额**加上**费用。

值得知道的三个后果：

* **你永远不会被第二次收取费用。** 只有提现金额被扣除，费用包含在其中。之后没有单独收费，
  也没有为此开的发票。
* **提现金额必须大于费用。** 等于或低于费用的金额将没有可汇出的部分，所以申请会在那一刻被
  拒绝，而不是先接受再失败。
* **费用以你的收款币种收取**，它必须与你提现协议上的费用币种一致。这就是为什么一份协议
  只报一个货币对，而不是你要求的任何货币对。

跨币种提现的处理方式相同——费用从金额中扣除，而不是在其之上——但申请时无法说明收到金额；
见下文的*跨币种提现为什么收到金额为空但费用有显示？*。

本页有意不告诉你的是**费用金额本身如何得出**。它来自你的提现协议，适用于你的数字就是协议
上的那些。

## 银行为退回我的提现收了费。它显示在哪里？

作为 Account History 中针对你结算账户的独立一行。因此一次银行退回会产生**两种**账本动账，
而不是一种：

| 行 | 方向 | 金额 |
| - | - | - |
| 提现的冲正 | **贷记**到你的结算账户 | 银行拒付的金额，同币种提现时扣除提现费用 |
| 银行的退回费用 | 从你的结算账户**借记** | 银行收取的费用 |

两行共享相同的标识属性，你可以据此关联回去：

| 列 | 值 |
| - | - |
| `Business Type` | `WITHDRAWAL` |
| `Business Id` | **提现订单 id**——不是结算批次 id |
| `Description` | `Withdrawal Cancelled` |

所以如果你在对账时遇到一笔无法解释的结算账户动账，且其 `Description` 为
`Withdrawal Cancelled`，请到 Withdrawal History 查找该 `Business Id`——那是一笔正在被
撤回的提现，不是结算调整。

## 提现的 Description 列显示什么？

它随状态变化，在某些状态下为空是正常的：

| 状态 | Description |
| - | - |
| `Success` | `Serial No.: {bank reference}` 和 `Actual Payment Amount: {amount} {currency}` |
| `Rejected` | 解释拒绝原因的审核意见 |
| `Failed` | 为该提现记录的拒付原因 |
| `Bank Return Confirmed` | 为该退回记录的拒付原因 |
| `Bank Return` | **空**——该状态不是终态，所以尚无最终原因可说明 |
| 任何其他状态 | 空 |

`Bank Return` 行上的空 Description 是预期行为，不是数据缺失。原因会在状态变为
`Bank Return Confirmed` 后出现。

注意 `Actual Payment Amount` 是实际付出的金额。如果收款银行或中间行在其一侧扣除了任何费用，
它与到达你银行账户的金额不是同一个数字。

## 为什么 Withdraw 按钮是灰的？

该入口有三种状态，由 Waffo 在渲染按钮之前针对你结算账户运行的检查驱动：

| 你看到什么 | 原因 |
| - | - |
| 完全没有 Withdraw 按钮 | 该账户未启用提现 |
| 按钮可见但**灰色** | 你的**可提现余额低于提现协议上的最小提现金额** |
| 按钮可用 | 你可以继续 |

该检查使用的余额是你的**可提现**余额，而不是结算账户余额——为保持保证金完整而扣留的
任何金额会先被排除。两者的区别见
[余额与 Account History](/docs/zh/support/balance-and-account-history-faq)。

点击时检查也会重新运行。如果你的余额在此期间发生了变化——在页面加载和你点击之间有退款或
拒付到账——该尝试会被阻止，并要求你用刷新后的数字再试。那是一次安全复查，不是你账户的错误。

在申请抽屉内还有第二层按金额的校验：你输入的金额必须不低于最小值、不高于协议上的最大值，
并在你的可用余额之内。

## 跨币种提现为什么费用和收到金额都是空的？

因为在汇率已知之前，两者都无法如实说明：

| 字段 | 申请时 | 何时填入 |
| - | - | - |
| 提现费用 | 可能为**空** | 在最终审核时回填 |
| 预期收到金额 | **空** | 结果返回后回填 |

申请页面会告知你金额将被换算、实际收到金额可能不同，并有意允许你在这些数字仍为空时提交——
此阶段费用为空不是错误，也不意味着提现免费。汇率和最终金额之后都会写到提现记录及其账单上，
所以**请从记录对账，而不是从申请页面**。

## 为什么我的混合币种提现显示为一笔付款，而实际涉及多个账户？

因为结算币种背后的账户结构有意不向你暴露。无论内部为筹措资金发生了什么，你得到的是：

* 每种结算币种**一个结算账户**，
* 该结算**一条 Account History 记录**，
* 该提现**一笔付款**。

费用从总额中内含扣除，只扣一次——不是每次内部动账各扣一次。你永远不需要对照 Portal
显示的单一数字之外的任何东西进行对账。

## 我的提现卡在 Processing。什么时候应该联系客服？

`Processing` 覆盖审核通过到结果返回之间的一切，包括 Waffo 系统之外的汇款环节。
在开工单之前：

1. 检查状态是否已经变为 `Result Submitted`——那意味着结果已进来并正在最终确认。
2. 如果到达了 `Success`，查看 Description 中的 `Serial No.`——这是你追踪入账付款时可以
   提供给自己银行的银行参考号。
3. 如果到达了 `Bank Return`，你无需采取任何行动：冲正已经在进行中，确认后资金会回到你的
   结算账户。

对于退回，重新发起一笔新提现是前进的方式——原订单一经确认即为终态，不会自动重试。
请先与 Waffo 一起修正收款账户信息，否则同一账户会再次退回资金。

***

仍然卡住？请附上提现订单 id [联系客服](mailto:support@waffo.com)——它就是任何相关
Account History 行上的 `Business Id`。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.