> ## 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 平台内管理和跟踪其可用资金。每个现金余额账户都有唯一的昵称，并分别维护总余额、可用余额和历史累计存入额。用户可以创建多个现金余额账户（例如，“团队差旅”、“运营钱包”、“市场预算”），以按不同用途组织支出。

在 Fluz 平台上进行存款、购买礼品卡以及为虚拟卡交易提供资金都需要现金余额账户。

# 创建用户现金余额账户

## 示例请求

你可以使用 `createUserCashBalance` 变更来创建新的用户现金余额账户。此变更允许你设置带有自定义昵称的新消费账户，以帮助组织资金。该查询接收一个 `CreateUserCashBalanceInput` 输入对象。

```json theme={null}
{
  "query": "mutation createUserCashBalance($input: CreateUserCashBalanceInput!) { createUserCashBalance(input: $input) { userCashBalanceId totalCashBalance availableCashBalance lifetimeCashBalance nickname status createdAt }}",
  "variables": {
    "input": {
      "nickname": "Team Travel"
    }
  }
}
```

此变更需要 `CreateUserCashBalanceInput` 输入类型。架构中任何带有感叹号（`!`）的字段都是必填项，必须包含在请求中。

| 字段名      | 类型      | 描述                     |
| :------- | :------ | :--------------------- |
| nickname | String! | 现金余额账户的自定义名称。用于标识账户用途。 |

## CreateUserCashBalanceInput

```json theme={null}
{
  "nickname": "Team Travel"
}
```

## 示例响应

`createUserCashBalance` 变更的响应将包含新创建的现金余额账户详情，包括其唯一标识符和初始余额信息。

```json theme={null}
{
  "data": {
    "createUserCashBalance": {
      "userCashBalanceId": "f8a3c9e1-7b2d-4f5e-9c8a-1d2e3f4g5h6i",
      "totalCashBalance": "0",
      "availableCashBalance": "0",
      "lifetimeCashBalance": "0",
      "nickname": "Team Travel",
      "status": "ACTIVE",
      "createdAt": "2025-01-15T10:30:00.000Z"
    }
  }
}
```

### 响应字段

| 字段名                  | 类型                     | 描述                                |
| :------------------- | :--------------------- | :-------------------------------- |
| userCashBalanceId    | UUID!                  | 现金余额账户的唯一标识符                      |
| totalCashBalance     | String!                | 账户总现金余额（初始为 0）                    |
| availableCashBalance | String!                | 可立即使用的现金余额（初始为 0）                 |
| lifetimeCashBalance  | String!                | 历史累计存入总额（初始为 0）                   |
| nickname             | String                 | 分配给该账户的自定义名称                      |
| status               | UserCashBalanceStatus! | 账户当前状态（ACTIVE、CLOSED 或 SUSPENDED） |
| createdAt            | DateTime!              | 账户创建的时间戳                          |

> ❗️ 需要授权
>
> 此变更需要 `MANAGE_PAYMENT` 范围。请确保你的访问令牌已被授予该范围后再尝试创建现金余额账户。

<StickyContactSalesBanner />