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

# 关闭消费账户

# 概览

每个现金余额账户都可以关闭，其全部余额会被转移，且相关虚拟卡的资金来源将被更改或这些虚拟卡将被锁定。

# 关闭用户现金余额账户

## 示例请求

你可以使用 `closeUserCashBalance` mutation 关闭用户现金余额账户。此 mutation 允许你执行以下操作：

* 关闭你的消费账户。
* 如果存在将此消费账户作为资金来源的虚拟卡，则更改这些虚拟卡的资金来源。
* 锁定相关虚拟卡。
* 将剩余余额转移到另一个消费账户。

该查询接收一个 `CloseUserCashBalanceInput` 输入对象。

```graphql theme={null}
mutation closeUserCashBalance($input: CloseUserCashBalanceInput!) {
    closeUserCashBalance(input: $input) {
        closedUserCashBalance {
            userCashBalanceId
            lifetimeCashBalance
            nickname
            status
            createdAt
            closedAt
        }
        affectedVirtualCards {
            virtualCardId
            virtualCardLast4
        }
    }
}
```

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

## CloseUserCashBalanceInput

| 字段名                       | 类型                                | 描述                                                              |
| :------------------------ | :-------------------------------- | :-------------------------------------------------------------- |
| idempotencyKey            | UUID!                             | 由客户端生成的唯一 UUID，确保请求只被处理一次。                                      |
| userCashBalanceId         | UUID!                             | 现金余额账户的唯一标识符。                                                   |
| newFundingSource          | CloseUserCashBalanceFundingSource | 所有依赖虚拟卡的新资金来源。仅当存在与此现金余额账户绑定的虚拟卡且未提供 `lockAllVirtualCards` 时必填。 |
| lockAllVirtualCards       | Boolean                           | 是否锁定所有依赖的虚拟卡。仅当存在与此现金余额账户绑定的虚拟卡且未提供 `newFundingSource` 时必填。     |
| transferUserCashBalanceId | UUID                              | 转账的唯一标识符。仅当现金余额账户的可用余额为 >0 时必填。                                 |

### 示例

```json theme={null}
{
  "idempotencyKey": "65666780-c552-47f0-ba05-f90fced0ef9f",
  "userCashBalanceId": "ca8e1ccf-b42d-41d3-8cad-2237e020d1b1",
  "lockAllVirtualCards": true,
  "transferUserCashBalanceId": "6d1b4b19-deef-42f5-80d7-ec34804ce091"
}
```

## CloseUserCashBalanceFundingSource

| 字段名                                                          | 类型                       | 描述                         |
| :----------------------------------------------------------- | :----------------------- | :------------------------- |
| bankAccountId                                                | UUID                     | 银行账户的唯一标识符。若其他选项均未提供则必填。   |
| userCashBalanceId                                            | UUID                     | 现金余额账户的唯一标识符。若其他选项均未提供则必填。 |
| primaryFundingSource:                                        | VirtualCardFundingSource | 主资金来源类型，为 `FLUZ_BALANCE`   |
| or `BANK_ACCOUNT`. Required if other options aren't present. |                          |                            |

### 示例

```json theme={null}
{
  "userCashBalanceId": "ca8e1ccf-b42d-41d3-8cad-2237e020d1b1",
}
```

## 示例响应

`closeUserCashBalance` mutation 的响应将包含已关闭现金余额账户的详细信息，包括其唯一标识符以及受影响的虚拟卡列表。

```json theme={null}
{
    "data": {
        "closeUserCashBalance": {
            "closedUserCashBalance": {
                "userCashBalanceId": "ca8e1ccf-b42d-41d3-8cad-2237e020d1b1",
                "lifetimeCashBalance": "0.00000",
                "nickname": "Closed Spend Account",
                "status": "CLOSED",
                "createdAt": "2025-12-30T21:18:26.782Z",
                "closedAt": "2025-12-30T21:22:29.359Z"
            },
            "affectedVirtualCards": [
                {
                    "virtualCardId": "afad4d6d-11f0-4ac1-b971-caca7c34c77c",
                    "virtualCardLast4": "4473"
                }
            ]
        }
    }
}
```

### 响应字段

| 字段名                  | 类型                                         | 描述              |
| :------------------- | :----------------------------------------- | :-------------- |
| closeUserCashBalance | ClosedUserCashBalance!                     | 已关闭现金余额账户的详细信息。 |
| lifetimeCashBalance  | \[CloseUserCashBalanceResponseVirtualCard] | 受此次关闭影响的虚拟卡列表。  |

#### closeUserCashBalance

| 字段名                 | 类型                     | 描述                   |
| :------------------ | :--------------------- | :------------------- |
| userCashBalanceId   | UUID!                  | 现金余额账户的唯一标识符。        |
| lifetimeCashBalance | String!                | 历史累计存入资金总额（从 0 开始）。  |
| nickname            | String!                | 分配给账户的自定义名称。         |
| status              | UserCashBalanceStatus! | 账户当前状态（应为 `CLOSED`）。 |
| createdAt           | DateTime!              | 账户创建时间戳。             |
| closedAt            | DateTime!              | 账户关闭时间戳。             |

#### affectedVirtualCards

| 字段名              | 类型    | 描述         |
| :--------------- | :---- | :--------- |
| virtualCardId    | UUID! | 虚拟卡的唯一标识符。 |
| virtualCardLast4 | UUID! | 虚拟卡卡号的后四位。 |

<br />

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