> ## 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 内部的现金余额账户，用户用它来持有、整理和追踪资金。每个账户都有自己的昵称，因此用户可以按用途分开支出——例如“团队差旅”、“运营钱包”或“市场预算”——且每个账户都维护各自的流水余额。

消费账户是其他一切的资金来源：它们持有用于购买礼品卡、为虚拟卡交易提供资金的款项，并接收存款和转账。

<Note>
  **“消费账户”和“现金余额账户”是同一概念。**

  在 API 中，消费账户由 `UserCashBalance` 类型表示，相关操作以 `...UserCashBalance` 命名（例如 `createUserCashBalance`）。本页面统一使用“消费账户”这一术语。
</Note>

***

## 余额

每个消费账户会追踪三种余额，全部以字符串形式返回：

| Balance       | Field                  | Description       |
| ------------- | ---------------------- | ----------------- |
| **Total**     | `totalCashBalance`     | 账户当前持有的全部余额。      |
| **Available** | `availableCashBalance` | 可立即用于支出的部分。       |
| **Lifetime**  | `lifetimeCashBalance`  | 账户历史上所有存入资金的累计总额。 |

用户可以持有**多个**消费账户，其中一个会被标记为**默认**（`isDefault: true`）。

***

## 你可以做什么

| Action                                    | Query / Mutation                                 | Scope            | Description                     |
| ----------------------------------------- | ------------------------------------------------ | ---------------- | ------------------------------- |
| [创建消费账户](/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` scope。创建、编辑和关闭消费账户需要 `MANAGE_PAYMENT` scope。调用这些操作前，请确保你的用户访问令牌携带正确的 scope。

***

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