> ## 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 账户最多可以包含四种不同的余额：

1. **奖励余额** - 可提现的余额，包含您可用的返现和奖励奖金。
2. **现金余额（消费账户）** - 可提现的余额，您可以用来为礼品卡和虚拟卡的购买提供资金等用途。
3. **Fluz 预付余额** - 不可提现的余额，您可以将其用于礼品卡和虚拟卡的购买。
4. **储备余额** - 在 Fluz 中保留的余额，用于覆盖任何未能清算的交易，确保您的账户保持良好状态。

要查看您当前的余额，您可以使用 `getWallet` [查询](https://storage.googleapis.com/fluz-public-docs/api-reference.html#query-getWallet)。这可以帮助您确定要存入的金额或用于礼品卡购买的金额。这些余额的总和构成您的“可用 Fluz 余额”，它决定了您在 Fluz 上可用于为支付提供资金的总金额。

## 用户现金余额账户（消费账户）

您可以通过 `userCashBalances` 字段访问单个现金余额账户的详细信息。监控账户状态和创建日期

`userCashBalances` 字段支持分页，并返回按创建日期排序（最新优先）的现金余额账户数组。

### 示例响应：

```json theme={null}
{
  "data": {
    "getWallet": {
      "bankCards": [BankCard],
      "bankAccounts": [BankAccount],
      "paypalAccounts": [Paypal],
      "blockedPaymentTypes": ["BANK_CARD"],
      "balances": {
        "rewardsBalance": {
          "availableBalance": "50.00",
          "totalBalance": "50.00",
          "lifetimeBalance": "125.00"
        },
        "cashBalance": {
          "availableBalance": "100.00",
          "totalBalance": "100.00",
          "pendingBalance": "0.00",
          "lifetimeBalance": "500.00"
        },
        "giftCardCashBalance": {
          "availableBalance": "25.00",
          "totalBalance": "25.00",
          "pendingBalance": "0.00",
          "lifetimeBalance": "75.00"
        },
        "userCashBalances": [
          {
            "userCashBalanceId": "123e4567-e89b-12d3-a456-426614174000",
            "totalCashBalance": "100.00",
            "availableCashBalance": "100.00",
            "lifetimeCashBalance": "500.00",
            "nickname": "Primary Account",
            "status": "ACTIVE",
            "createdAt": "2024-01-15T10:30:00Z"
          },
          {
            "userCashBalanceId": "223e4567-e89b-12d3-a456-426614174001",
            "totalCashBalance": "25.00",
            "availableCashBalance": "25.00",
            "lifetimeCashBalance": "75.00",
            "nickname": "Savings",
            "status": "ACTIVE",
            "createdAt": "2024-02-20T14:15:00Z"
          }
        ]
      }
    }
  }
}
```

### 带分页的查询：

您可以使用 `paginate` 参数对现金余额账户进行分页：

```graphql theme={null}
query {
  getWallet {
    balances {
      userCashBalances(paginate: { limit: 10, offset: 0 }) {
        userCashBalanceId
        totalCashBalance
        availableCashBalance
        lifetimeCashBalance
        nickname
        status
        createdAt
      }
    }
  }
}
```

### UserCashBalance 字段：

| 字段                     | 类型                    | 描述                            |
| ---------------------- | --------------------- | ----------------------------- |
| `userCashBalanceId`    | UUID                  | 用户现金余额账户的唯一标识符                |
| `totalCashBalance`     | String                | 账户中的现金总余额                     |
| `availableCashBalance` | String                | 可用于交易的可用现金余额                  |
| `lifetimeCashBalance`  | String                | 此账户有史以来累计存入总额                 |
| `nickname`             | String                | 该余额账户的自定义昵称（可选）               |
| `status`               | UserCashBalanceStatus | 现金余额账户的状态（例如：ACTIVE、INACTIVE） |
| `createdAt`            | DateTime              | 账户创建的日期和时间                    |

<br />

<StickyContactSalesBanner />