> ## 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 帳戶中新增資金來源後，你可以使用 `getWallet`[query](https://storage.googleapis.com/fluz-public-docs/api-reference.html#query-getWallet) 來擷取其清單。此查詢會提供連結到使用者錢包的所有資金來源詳細資訊。

## 範例請求

```graphql theme={null}
query getWallet {
    getWallet {
        bankCards {
            bankCardId
            cardType
            cardholderName
            lastFourDigits
            expirationMonth
            expirationYear
            cardStatus
            billingAddressId
        }
        bankAccounts {
            bankAccountId
            type
            accountName
            status
            achRouting
            lastFour
            nickname
        }
        paypalAccounts {
            paypalVaultId
            status
            email
        }
        blockedPaymentTypes
        balances {
            rewardsBalance {
                availableBalance
                totalBalance
                lifetimeBalance
            }
            cashBalance {
                availableBalance
                totalBalance
                pendingBalance
                lifetimeBalance
            }
            giftCardCashBalance {
                availableBalance
                totalBalance
                pendingBalance
                lifetimeBalance
            }
        }
    }
}
```

查詢回應將包含使用者的餘額與資金來源類型，例如 `BankCard`、` BankAccount` 和 `PayPal`。以下為回應物件範例：

## 範例回應

```json theme={null}
{
  "data": {
    "getWallet": {
      "bankCards": [
        {
          "bankCardId": "e7979eb7-1727-48ed-8c5a-c56532908c1e",
          "ownerAccountId": "e7979eb7-1727-48ed-8c5a-c56532908c1e",
          "addedUserId": "e7979eb7-1727-48ed-8c5a-c56532908c1e",
          "cardType": "DEBIT",
          "cardProcessor": "xyz789",
          "cardholderName": "John Doe",
          "lastFourDigits": "1234",
          "expirationMonth": "12",
          "expirationYear": "25",
          "cardStatus": "ACTIVE",
          "billingAddressId": "e7979eb7-1727-48ed-8c5a-c56532908c1e"
        }
      ],
      "bankAccounts": [
        {
          "bankAccountId": "e7979eb7-1727-48ed-8c5a-c56532908c1e",
          "accountId": "e7979eb7-1727-48ed-8c5a-c56532908c1e",
          "type": "SAVING",
          "accountName": "John Doe",
          "status": "ENABLED",
          "achRouting": "021000021",
          "lastFour": "1234",
          "authChargeBackupPaymentMethod": true,
          "billingAddressId": "e7979eb7-1727-48ed-8c5a-c56532908c1e",
          "nickname": "Johnny"
        }
      ],
      "paypalAccounts": [
        {
          "paypalVaultId": "e7979eb7-1727-48ed-8c5a-c56532908c1e",
          "userId": "e7979eb7-1727-48ed-8c5a-c56532908c1e",
          "status": "ACTIVE",
          "email": "abc123@example.com"
        }
      ],
      "blockedPaymentTypes": ["BANK_CARD"],
      "balances": {
        "rewardsBalance": "100.00",
        "cashBalance": "250.00",
        "giftCardCashBalance": "50.00"
      }
    }
  }
}
```

## 回應欄位說明

### bankCards - BankCardType:

`BankCard` 物件代表使用者已新增到其帳戶的銀行卡。此陣列中的每個物件代表一張銀行卡，包含卡號（遮罩後）、到期日、持卡人姓名與帳單資訊等詳細資料。

| Field name       | Type           | Description                           |
| :--------------- | :------------- | :------------------------------------ |
| bankCardId       | UUID!          | 銀行卡的唯一識別碼。                            |
| ownerAccountId   | UUID!          | 擁有此銀行卡之帳戶的唯一識別碼。                      |
| addedUserId      | UUID!          | 將此銀行卡新增至帳戶之使用者的唯一識別碼。                 |
| cardType         | BankCardType   | 卡片類型，例如 DEBIT 或 CREDIT。               |
| cardProcessor    | String         | 卡片處理方的名稱或代碼。                          |
| cardholderName   | String         | 銀行卡上顯示的持卡人姓名。                         |
| lastFourDigits   | String         | 銀行卡號末四碼，用於識別。                         |
| expirationMonth  | String         | 卡片到期的月份，格式為 MM。                       |
| expirationYear   | String         | 卡片到期的年份，格式為 YYYY。                     |
| cardStatus       | BankCardStatus | 銀行卡目前狀態，例如 ACTIVE、INACTIVE 或 BLOCKED。 |
| billingAddressId | UUID           | 與此銀行卡關聯之帳單地址的唯一識別碼。                   |

### bankAccounts - \[BankAccount]:

`BankAccount` 物件是使用者新增至其帳戶的銀行帳戶記錄。它儲存銀行帳戶的重要資訊，包括帳戶類型、狀態、細節與關聯的帳單地址。

| Field name                    | Type             | Description                   |
| :---------------------------- | :--------------- | :---------------------------- |
| bankAcountid                  | UUID!            | 銀行帳戶的唯一識別碼。                   |
| accountId                     | UUID!            | 與此銀行帳戶關聯之帳戶的唯一識別碼。            |
| type                          | BankAccountType! | 銀行帳戶類型，例如 CHECKING 或 SAVING。  |
| accountName                   | String!          | 與銀行帳戶關聯的名稱。                   |
| status                        | String!          | 銀行帳戶目前狀態，例如 ENABLED、DISABLED。 |
| achRouting                    | String!          | 該銀行帳戶的 ACH（自動清算中心）匯款代碼。       |
| lastFour                      | String!          | 銀行帳號末四碼，用於識別。                 |
| authChargeBackupPaymentMethod | Boolean!         | 指示此銀行帳戶是否設定為扣款的備用付款方式。        |
| billingAddressId              | UUID!            | 與此銀行帳戶關聯之帳單地址的唯一識別碼。          |
| nickname                      | String           | 為便於識別而給予銀行帳戶的選用暱稱。            |

### paypalAccounts - \[Paypal]:

`Paypal` 物件代表使用者已新增至其帳戶的 PayPal 帳戶。此物件包含該 PayPal 帳戶的關鍵細節，包括唯一識別碼、關聯使用者、狀態與電子郵件地址。

| Field name    | Type                 | Description                         |
| :------------ | :------------------- | :---------------------------------- |
| paypalVaultId | UUID!                | PayPal 帳戶的唯一識別碼。                    |
| userId        | UUID!                | 新增此 PayPal 帳戶之使用者的唯一識別碼。            |
| status        | PayPalAccountStatus! | PayPal 帳戶目前狀態，例如 ACTIVE、INACTIVE 等。 |
| email         | String!              | 與該 PayPal 帳戶關聯的電子郵件地址。              |

### blockedPaymentTypes - \[PaymentMethodType]:

**說明：** 此陣列列出目前對該使用者被封鎖的付款類型。\
**細節：** 若某付款類型被封鎖，表示使用者無法在平台上以此方式進行交易。舉例來說，"BANK\_CARD" 代表目前限制使用銀行卡。**PaymentMethodType 列舉值：**

* **`"BANK_CARD"`**：表示銀行卡被封鎖。
* **`"BANK_ACCOUNT"`**：表示銀行帳戶被封鎖。
* **`"PAYPAL"`**：表示 PayPal 被封鎖。
* **`"FLUZPAY"`**：表示你的 Fluz 餘額被封鎖。
* **`"APPLE_PAY"`**：表示你的 Apple Pay 錢包被封鎖。
* **`"GOOGLE_PAY"`**：表示你的 Google Pay 錢包被封鎖。

### balances - UserBalances:

**說明：** 此物件包含使用者目前的餘額，包括現金餘額、現金回饋餘額，以及 Fluz 預付款餘額。欲了解更多，請參閱 ['查詢帳戶餘額'](/check-account-balance).

<br />

<StickyContactSalesBanner />