> ## 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.

# 编辑消费账户

# 概览

每个现金余额账户都有自己的昵称，便于用户在有多个账户时轻松区分。

# 编辑用户现金余额账户

## 示例请求

你可以使用 `updateUserCashBalance` mutation 来更新用户现金余额账户。此 mutation 允许你编辑消费账户的昵称，以帮助整理你的资金。该查询接收一个 `UpdateUserCashBalanceInput` 输入对象。

```json theme={null}
mutation updateUserCashBalance($input: UpdateUserCashBalanceInput!) {
    updateUserCashBalance(input: $input) {
        userCashBalanceId
        totalCashBalance
        availableCashBalance
        lifetimeCashBalance
        nickname
        status
        createdAt
    }
}
```

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

| 字段名               | 类型      | 描述                                                |
| :---------------- | :------ | :------------------------------------------------ |
| userCashBalanceId | UUID!   | 现金余额账户的唯一标识符。                                     |
| nickname          | String! | 现金余额账户的自定义名称。用于帮助识别账户用途。长度至少为 2 个字符，且不超过 100 个字符。 |

## UpdateUserCashBalanceInput

```json theme={null}
{
  "userCashBalanceId": "f8a3c9e1-7b2d-4f5e-9c8a-1d2e3f4g5h6i",
  "nickname": "New Team Travel"
}
```

## 示例响应

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

```json theme={null}
{
  "data": {
    "updateUserCashBalance": {
      "userCashBalanceId": "f8a3c9e1-7b2d-4f5e-9c8a-1d2e3f4g5h6i",
      "totalCashBalance": "0",
      "availableCashBalance": "0",
      "lifetimeCashBalance": "0",
      "nickname": "New 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!              | 账户创建的时间戳                          |

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