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

# 概览

在用户的**Fluz 钱包**与其**外部账户**之间转移资金——包括银行账户、银行卡或数字钱包（PayPal、Venmo）。存款将资金从外部来源\_转入\_ Fluz 钱包以为购买提供资金；取款将资金从 Fluz 钱包\_转出\_到已关联的外部目的地。

这与在 Fluz \_内部\_移动资金不同：在用户自己的消费账户之间划转资金，请使用[在消费账户之间转账](/features/transfer-between-spend-accounts)；向其他 Fluz 账户转账，请使用[账户到账户转账](/features/account-to-account-transfers)。

| 方向    | 页面                                                    | 作用                      |
| ----- | ----------------------------------------------------- | ----------------------- |
| **入** | [从外部账户存入资金](/features/deposit-from-external-accounts) | 从已关联的资金来源向 Fluz 余额充值。   |
| **入** | [兑换 Fluz 礼品卡至礼品卡余额](/features/redeem-fluz-gift-card)  | 将 Fluz 礼品卡兑换码记入礼品卡余额。   |
| **出** | [提现到外部账户](/features/withdraw-to-external-account)     | 将资金从 Fluz 余额转至已关联的外部账户。 |

***

## Fluz 余额

存款和取款会与几个不同的余额交互。了解一笔资金流动会影响到哪个余额很重要，因为并非所有余额都可提现。

| 余额        | 资金来源                                   | 可提现     |
| --------- | -------------------------------------- | ------- |
| **现金余额**  | 来自资金来源的存款                              | ✓       |
| **奖励余额**  | 购物获得的返现                                | ✓       |
| **礼品卡余额** | 存入到 `GIFT_CARD_BALANCE` 与已兑换的 Fluz 礼品卡 | ✗（仅可消费） |
| **备用金余额** | 存入到 `RESERVE_BALANCE`                  | ✗（保留金）  |

<Note>
  **礼品卡余额仅可用于消费。**

  记入礼品卡余额的资金——无论是存入到 `GIFT_CARD_BALANCE` 还是兑换 Fluz 礼品卡——都可用于消费，但不能提现到外部账户。
</Note>

***

## 存入资金

使用 `depositCashBalance` mutation 将资金从已关联的资金来源转入 Fluz。你可以选择**目标余额**（`CASH_BALANCE`、`GIFT_CARD_BALANCE` 或 `RESERVE_BALANCE`）以及**资金来源**——从 `getWallet` 获取的 `bankAccountId`、`bankCardId` 或 `paypalVaultId`。当存入现金余额时，可通过 `userCashBalanceId` 指定目标消费账户。

根据资金来源不同，存款可能即时结算或在 2–5 个工作日内结算。需要 `MAKE_DEPOSIT` scope。

完整的输入与响应参考，请参见[从外部账户存入资金](/features/deposit-from-external-accounts)。

***

## 兑换 Fluz 礼品卡

Fluz 礼品卡是一种特殊的存款方式。`redeemFluzGiftCard` mutation 会将礼品卡**兑换码**直接记入用户的礼品卡余额（`giftCardCashBalance`）。兑换为即时生效，任何激活费用会反映在 `depositFee` 中。需要 `MAKE_DEPOSIT` scope。

详情请参见[兑换 Fluz 礼品卡至礼品卡余额](/features/redeem-fluz-gift-card)。

***

## 提现资金

使用 `withdrawCashBalance` mutation 将资金从 Fluz 转出到已关联的外部账户。你需要选择**来源余额**（`CASH_BALANCE` 或 `REWARDS_BALANCE`）以及**提现方式**，并提供匹配的目标 ID：

| 方式          | 必填字段             | 说明                                  |
| ----------- | ---------------- | ----------------------------------- |
| `BANK_ACH`  | `bankAccountId`  | 通过 ACH 转至已关联银行账户。通常 1–3 个工作日结算。无费用。 |
| `BANK_CARD` | `bankCardId`     | 向符合条件的已关联借记卡进行推卡转账。可能收取费用。          |
| `PAYPAL`    | `paypalVaultId`  | 转至已关联的 PayPal 账户。可能收取费用。            |
| `VENMO`     | `venmoAccountId` | 转至已关联的 Venmo 账户。可能收取费用。             |

当从现金余额提现时，通过 `cashBalanceId` 指定提取的消费账户。提现需要 `MAKE_WITHDRAWAL` scope。

完整输入参考、错误处理与多席位行为，请参见[提现到外部账户](/features/withdraw-to-external-account)。

***

## 幂等性

存款、兑换与提现必须包含唯一、由客户端生成的 `idempotencyKey`。如果同一个键被多次提交，API 会返回最初请求的结果，而不会再次处理——从而防止重复资金流动。务必为每个请求生成新的 UUID。

***

## 要求速览

| 操作          | Mutation              | Scope             |
| ----------- | --------------------- | ----------------- |
| 存入资金        | `depositCashBalance`  | `MAKE_DEPOSIT`    |
| 兑换 Fluz 礼品卡 | `redeemFluzGiftCard`  | `MAKE_DEPOSIT`    |
| 提现资金        | `withdrawCashBalance` | `MAKE_WITHDRAWAL` |

在移动资金之前，使用[检查账户余额](/check-account-balance)或 `getWallet` 来确认用户有足够的可用余额，并检索相关的资金来源 ID。

***

**想了解更多？** 与我们的专家交流以获取更多信息或申请演示。