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

# 余额与账户历史

> 如何理解 Waffo 的三种余额——待结算、结算账户和保证金——为什么可提现金额可能低于结算账户余额，账户历史记录了哪些内容，以及对账单和发票 PDF 的命名规则。

您赚到的资金在到达银行账户之前，会分别存放在多个地方。本页说明每一种余额、其背后的账本，以及您用来对账的文件。关于结算周期本身，请参见
[商户结算](/docs/zh/essentials/merchant-settlement)。

## Waffo 显示哪几种余额？每种分别是什么意思？

| 余额 | 包含内容 | 是否可提现？ |
| - | - | - |
| **待结算**（未结算 / 待结算） | 来自成功交易、但尚未到达结算日期的资金。退款和拒付首先在这里进行净额抵扣。 | 否——必须先完成结算。 |
| **结算账户** | 已完成结算的资金，按结算币种分别持有。 | 是，但需满足下文所述的检查条件。 |
| **保证金** | 根据合同扣留的金额：`Reserve balance = Reserve per contract + Reserve adjustment`。 | 否。 |

余额和结算批次均**按结算币种**展示，外汇换汇在资金进入结算账户之前就已完成——不再在提现时进行。

## 为什么我的可提现金额比结算账户余额少？

因为保证金必须保持完整。如果保证金余额足以覆盖应留存的金额，您的可提现金额等于结算账户余额；如果不足，则为结算账户余额**减去缺口**，缺口部分会一直扣留，直到保证金补足。当保证金被动用后，Waffo 会在扣减之后的下一个处理周期，按"用了多少补多少"的原则从您的结算账户补充保证金——在账户历史中显示为 `RESERVE_ADJUSTMENT`，备注为 *Debit from settlement account*。

## 保证金里有什么？我能从保证金里退款吗？

您的合同规定是否适用保证金以及保证金类型——**固定保证金**（在合同约定期间内扣留一笔固定金额）和/或**滚动保证金**（每次结算净额的一定比例，扣留一个合同约定的持有期）。两者可以同时适用，并且可以按支付方式分别开启或关闭收取。您的 `Reserve Ratio` 和 `Reserve Period` 可在商户 Portal 的 Payin 合同页面查看。

* **不会从保证金中退任何款。** 退款只从待结算余额中扣除，结算为负时会向后结转，而不会从保证金中扣。
* **净额为负的结算日不会产生扣留**——会在下一个净额为正的结算日一并扣留。
* 持有期按**工作日或自然日计算，以您的合同为准**。适用工作日时，按一份固定的保证金日历计算——这与用于调整结算日期的日历不同。只有当保证金余额超过当日仍需留存的金额时，扣留才会在预期释放日释放；等于或低于该金额时，在余额恢复之前不会释放任何资金。详见
  [保证金账户](/docs/zh/support/reserve-faq)。

保证金的变动记录在单独的**保证金账户**模块中：保证金总余额、*Reserve per contract*（扣留与释放）以及 *Reserve adjustment*（扣减与补充）。标记为**结算账户**的结算账本不再混入这些记录；结算日历会显示**保证金释放日期**。

## 账户历史记录了什么？业务类型有哪些？

账户历史是您各账户所有结算币种资金变动的账本。您能看到哪些账户取决于您从哪里查看：

| 入口 | 范围 |
| - | - |
| Portal **账户 → 余额 → 余额历史** | 您的**结算账户** |
| Portal **保证金账户**模块 | 您的**保证金账户**——扣留、释放和调整 |
| `/api/v1/account/history/inquiry` | **两个**账户；不传 `accountType` 时两者都会返回 |

每条记录包含 Account No、Account Type、Business Id、Business Type、Direction、Amount / Currency、Balance（变动发生后的余额）、Datetime 和 Description。

可用于筛选的业务类型如下：

| 业务类型 | 含义 |
| - | - |
| `SETTLEMENT` | 一笔结算，入账到您的结算账户 |
| `WITHDRAWAL` | 一笔提现，从结算账户扣款 |
| `ADJUSTMENT` | 人工调整 |
| `RESERVE_WITHHOLDING` | 转入保证金的资金 |
| `RESERVE_RELEASING` | 从保证金释放回来的资金 |
| `RESERVE_ADJUSTMENT` | 从您的结算账户补充被动用保证金的补足记录 |

外汇 `Conversion` 记录不再出现，因为换汇现在在提现之前进行，而不是在提现时进行；较早的记录可能仍带有该标签，因此对历史对账时请不加筛选地查看列表。筛选值及其底层账户结构见
[结算账户结构](/docs/zh/support/settlement-account-structure-faq)。

默认显示最近 **30 天**，最新在前，同一时间戳的记录按币种 A–Z 排序；结算记录默认显示最近 **90 天**。两个时间窗口均为 UTC+8。

## 退款和拒付从哪个余额扣？余额会变成负数吗？

退款从**待结算**余额中净额抵扣。拒付和拒付手续费按固定顺序尝试扣款：待结算余额 → 结算账户余额 → 待结算余额**透支**，此时余额可能变为负数，并由后续入账的资金冲抵。Payin 商户账户默认可透支。

如果某个结算日的净额为负——退款和拒付超过了支付款——当日不会发生资金转移；负数金额会结转到下一个净额为正的结算日。因待结算余额不足而无法执行的结算，会在之后的结算日重试，按日期最早优先、金额最大优先，直到连最小的一笔也无法覆盖为止。

## 对账单和发票 PDF 怎么命名？里面有什么内容？

| 文件 | 文件名 |
| - | - |
| 结算对账单 | `settlement_statement_{merchant id}_{currency}_{date}.pdf` |
| 提现对账单 | `{merchant id}-{withdraw order id}_{account type}.pdf`（重新生成时会追加时间戳） |
| 发票 | `invoice_{currency}_{date1}_{date2}.pdf` |

日期格式为 `YYYYMMDD`。三种文件共用同一个四区块版式：出具方 Waffo 实体的名称和地址、文件信息区（日期和编号）、您的公司名称和地址，然后是业务明细表。`Total` 永远不是表格内的一行——它单独列在表格下方。金额使用千分位分隔符和 2 位小数，币种置于金额之前（`{Currency} {Amount}`），Country/Region 使用 ISO 3166-1 alpha-3 代码（`USA`、`CHN`、`HKG`）。

结算对账单的列为 Country/Region、Transaction Amount、Fee Amount、Tax Amount、Avg. Forex Rate 和 Settlement Amount，另加合计。提现对账单上的汇率列名为 **Forex Rate**；未涉及换汇时显示 `--`，而不是去掉该列。保证金扣留不会出现在结算文件或对账单中——它们在结算之后扣取，通过结算批次列表和保证金账户模块进行对账；参见[保证金账户](/docs/zh/support/reserve-faq)。


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