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