概览

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

编辑用户现金余额账户

示例请求

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

mutation updateUserCashBalance($input: UpdateUserCashBalanceInput!) {
    updateUserCashBalance(input: $input) {
        userCashBalanceId
        totalCashBalance
        availableCashBalance
        lifetimeCashBalance
        nickname
        status
        createdAt
    }
}

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

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

UpdateUserCashBalanceInput

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

示例响应

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

{
  "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 范围。请确保你的访问令牌已被授予该范围，然后再尝试创建现金余额账户。

​概览

​编辑用户现金余额账户

​示例请求

​UpdateUserCashBalanceInput

​示例响应

​响应字段

概览

编辑用户现金余额账户

示例请求

UpdateUserCashBalanceInput

示例响应

响应字段