> ## 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` 權限範圍。

完整的輸入與回應參考請見[從外部帳戶存入資金](/features/deposit-from-external-accounts)。

***

## 兌換 Fluz 禮品卡

Fluz 禮品卡屬於一種特殊的存款。`redeemFluzGiftCard` mutation 會將禮品卡**代碼**直接入帳至使用者的禮品卡餘額（`giftCardCashBalance`）。兌換為即時入帳，任何啟用手續費會反映在 `depositFee`。需要 `MAKE_DEPOSIT` 權限範圍。

詳細資訊請見[兌換 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` 權限範圍。

完整輸入參考、錯誤處理與多座位行為請見[提領資金至外部帳戶](/features/withdraw-to-external-account)。

***

## 冪等性

存款、兌換與提款必須包含唯一且由用戶端產生的 `idempotencyKey`。若相同的 key 被重複提交，API 會回傳原始請求的結果，而不會再次處理——以避免重複的資金移動。請為每個請求產生新的 UUID。

***

## 一覽需求

| 動作          | Mutation              | 權限範圍              |
| ----------- | --------------------- | ----------------- |
| 存入資金        | `depositCashBalance`  | `MAKE_DEPOSIT`    |
| 兌換 Fluz 禮品卡 | `redeemFluzGiftCard`  | `MAKE_DEPOSIT`    |
| 提領資金        | `withdrawCashBalance` | `MAKE_WITHDRAWAL` |

在移動資金之前，請使用 [檢查帳戶餘額](/check-account-balance) 或 `getWallet` 以確認使用者有足夠的可用餘額，並取得相關的資金來源 ID。

***

**想了解更多？** 與我們的專家聯繫以獲取更多資訊或申請示範。