> ## 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 中的一種現金餘額帳戶，使用者用來存放、整理與追蹤資金。每個帳戶都有自己的暱稱，因此使用者可以依用途分開消費——例如「Team Travel」、「Operations Wallet」或「Marketing Budget」——而且每個帳戶都有各自的即時餘額。

消費帳戶是其他一切資金的來源：它們持有用於購買禮品卡、資助虛擬卡交易的資金，並接收存款與轉帳。

<Note>
  **「消費帳戶」與「現金餘額帳戶」是同一件事。**

  在 API 中，消費帳戶以 `UserCashBalance` 類型呈現，相關操作名稱為 `...UserCashBalance`（例如 `createUserCashBalance`）。本頁面全程使用「消費帳戶」一詞。
</Note>

***

## 餘額

每個消費帳戶會追蹤三種餘額，皆以字串回傳：

| 餘額     | 欄位                     | 說明             |
| ------ | ---------------------- | -------------- |
| **總額** | `totalCashBalance`     | 目前帳戶中持有的全部餘額。  |
| **可用** | `availableCashBalance` | 可立即支用的金額。      |
| **累積** | `lifetimeCashBalance`  | 帳戶歷來存入資金的累計總額。 |

使用者可以持有**多個**消費帳戶，其中一個會被標記為**預設**（`isDefault: true`）。

***

## 你可以做什麼

| 動作                                        | 查詢 / 變更                                          | 範圍               | 說明                             |
| ----------------------------------------- | ------------------------------------------------ | ---------------- | ------------------------------ |
| [建立消費帳戶](/features/create-spend-accounts) | `createUserCashBalance`                          | `MANAGE_PAYMENT` | 以自訂暱稱開立新消費帳戶。                  |
| [取得消費帳戶](/features/get-spend-accounts)    | `getUserCashBalances` · `getUserCashBalanceById` | `LIST_PAYMENT`   | 列出所有消費帳戶（支援篩選與分頁）或依 ID 取得單一帳戶。 |
| [編輯消費帳戶](/features/edit-spend-accounts)   | `updateUserCashBalance`                          | `MANAGE_PAYMENT` | 重新命名消費帳戶（暱稱，2–100 個字元）。        |
| [關閉消費帳戶](/features/close-spend-accounts)  | `closeUserCashBalance`                           | `MANAGE_PAYMENT` | 關閉帳戶、移轉其剩餘餘額，並處理任何相依的虛擬卡。      |

***

## 帳戶生命週期

消費帳戶會經過少數狀態（`UserCashBalanceStatus`）：通常為 `ACTIVE`，關閉後為 `CLOSED`。

關閉帳戶不僅是狀態變更。當你關閉仍有可用餘額的消費帳戶時，該餘額必須移轉到另一個消費帳戶。若有任何虛擬卡的資金來源為欲關閉的帳戶，你必須在同一請求中將它們重新指派到新的資金來源，或將其鎖定。

<Note>
  **關閉帳戶時，你必須處理其餘額與相依的卡片。**

  若帳戶仍有可用餘額，請提供 `transferUserCashBalanceId` 以移轉該餘額。若有虛擬卡綁定此帳戶，請提供 `newFundingSource` 以重新指派，或提供 `lockAllVirtualCards` 以將其鎖定。完整輸入參數請參閱[關閉消費帳戶](/features/close-spend-accounts)。
</Note>

***

## 消費帳戶如何融入整體

消費帳戶位於使用者錢包的核心：

* 使用[從外部帳戶存入資金](/features/deposit-from-external-accounts)為其加值，或透過[消費帳戶間內部轉帳](/features/transfer-between-spend-accounts)在帳戶之間移動資金。
* 透過[禮品卡](/purchase-gift-card)與[虛擬卡](/features/virtual-cards)從帳戶消費。
* 隨時使用[查詢帳戶餘額](/check-account-balance)或上述消費帳戶查詢來檢視餘額。

***

## 必要條件

列出消費帳戶需要 `LIST_PAYMENT` 範圍。建立、編輯與關閉消費帳戶需要 `MANAGE_PAYMENT` 範圍。請在呼叫這些操作前，確認你的使用者存取權杖具有正確的範圍。

***

想了解更多嗎？與我們的專家交談以獲取更多資訊或申請示範。