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

# 虚拟卡资金：充值、退回与余额构成

> 解答虚拟卡资金的常见问题：卡账户资金来源、充值与到账时间、退回结算余额、资金页各余额的含义、余额不足时的表现，以及通过 API 充值和退回。

本页说明卡账户的钱从哪里来、怎么充值、怎么退回结算余额，以及资金页上各个余额分别是什么意思。操作入口都在 Portal「虚拟卡 → 资金」。

## 卡账户的钱从哪里来？

从你的收款结算余额转入。充值不需要先提现到银行再汇款，资金始终在 Waffo 体系内流转；用不完的钱可以申请退回结算余额，随常规结算打款一同发放。

卡账户下所有卡共用一个可用余额。每张卡的限额只是这张卡的上限，不会预留资金。

## 怎么充值？多久到账？

1. 在「虚拟卡 → 资金」点「为余额充值」。
2. 输入充值金额，页面会显示结算余额的可用金额，以及充值后结算余额和卡账户余额分别是多少。
3. 点「提交」，提示「充值申请已提交」。

提交后这笔钱当即从结算余额扣除，卡账户显示「充值处理中」。分配完成后进入可用余额，通常需要 1 个工作日。

充值金额的限制：

| 规则 | 说明 |
| - | - |
| 最低金额 | Portal 充值最低 5（卡账户币种），低于时提示「最低充值金额为 …」 |
| 最高金额 | 不能超过结算余额的可用金额，超过时提示「结算可用余额不足，无法完成本次充值。可用 …，本次需要 …」 |
| 币种 | 与卡账户币种一致 |

如果提交后提示「提交处理中，请稍后查看资金记录，请勿重复提交」，说明这次提交还在处理，不要重复点击。Portal 同一次提交会自动去重，不会重复充值。

## 怎么把用不完的钱退回结算余额？

1. 在「虚拟卡 → 资金」点「退回资金」。
2. 输入退回金额，可选填写原因（最多 200 字，有助于更快审核）。
3. 点「提交」，提示「退资申请已提交」。

提交后这笔金额立即冻结，不能再用于卡片支付，余额中显示为「退回结算余额中」。Waffo 审核并划转后，资金进入你的结算余额，随常规结算打款一同发放。

退回金额的限制：

| 规则 | 说明 |
| - | - |
| 最低金额 | Portal 退回最低 5（卡账户币种）；可用余额低于 5 时无法发起 |
| 最高金额 | 不超过可用余额；处于拒付冻结或仍在充值中的金额暂不可退回 |
| 账户暂停时 | 仍可退回资金 |

## 资金页上的几个余额分别是什么？

| 项目 | 含义 |
| - | - |
| 可用余额 | 当前可立即用于卡片支付的金额 |
| 充值处理中 | 已从结算余额扣除、正在分配到卡账户的金额，分配完成后即可使用 |
| 拒付冻结中 | 卡交易发生拒付后，在拒付冷却期内被冻结的金额 |
| 退回结算余额中 | 你申请退回、审核中或等待划转期间锁定的金额 |
| 总余额 | 可用余额加上处理中及冻结资金 |

已授权但还没有清算的卡消费，已经从可用余额中扣除。页面会单独提示「其中 … 为已授权未清算的消费，已从可用余额中扣除」。

如果余额旁显示「数据截至 …」，说明当前展示的是最近一次的余额数据，不是实时值，稍后刷新即可。

## 余额不足时卡还能开、还能刷吗？

可用余额为 0 时仍然可以开卡，开卡页会提示「您的账户暂无可用余额。充值后即可创建并使用虚拟卡」。但支付时如果可用余额不足，这笔交易会被拒绝，交易「状态说明」显示「可用余额不足，请先充值」。

没有任何卡时，卡片页会提示先充值：充值正在途中时显示「资金正在到账途中」，到账进入可用余额后即可开出第一张卡。

## 通过 API 充值和退回有什么不同？

API 与 Portal 走同一套资金规则，另外：

* 每次请求要带 `idempotentId`（1–64 位字母、数字、下划线或横线）作为业务键，重发同一个业务键不会重复充值或退回。
* 金额是字符串，最多 12 位整数、2 位小数，不接受科学计数法和千分位；币种须等于卡账户币种。
* 可以用资金单查询和资金单列表接口查看每笔充值、退回的状态，状态按资金单类型解读：

| 状态 | 充值单 | 退回单 |
| - | - | - |
| `PENDING` | 已提交 | 已提交，等待审核，金额已冻结 |
| `APPROVED` | 等待分配到卡账户 | 已审核通过，等待划转 |
| `SUCCESS` | 已分配，进入可用余额 | 已划转回结算余额 |
| `REJECTED` | 已驳回，原因见 `rejectReason` | 已驳回，原因见 `rejectReason` |

接口清单见[发卡 API 接入概览](https://waffo.com/docs/zh/support/vcc-issuing-api-overview-faq.md)。


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