概览

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

关闭用户现金余额账户

示例请求

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

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

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

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 时必填。

示例

{
  "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.

示例

{
  "userCashBalanceId": "ca8e1ccf-b42d-41d3-8cad-2237e020d1b1",
}

示例响应

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

{
    "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!	虚拟卡卡号的后四位。

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

功能

关闭消费账户

概览

关闭用户现金余额账户

示例请求

CloseUserCashBalanceInput

示例

CloseUserCashBalanceFundingSource

示例

示例响应

响应字段

closeUserCashBalance

affectedVirtualCards

​概览

​关闭用户现金余额账户

​示例请求

​CloseUserCashBalanceInput

​示例

​CloseUserCashBalanceFundingSource

​示例

​示例响应

​响应字段

​closeUserCashBalance

​affectedVirtualCards

概览

关闭用户现金余额账户

示例请求

CloseUserCashBalanceInput

示例

CloseUserCashBalanceFundingSource

示例

示例响应

响应字段

closeUserCashBalance

affectedVirtualCards