> ## 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`[查询](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` 对象表示用户已添加到其账户中的银行卡。该数组中的每个对象代表一张银行卡，包括卡号（掩码）、到期日期、持卡人姓名和账单信息等详细信息。

| 字段名称             | 类型             | 描述                                     |
| :--------------- | :------------- | :------------------------------------- |
| 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` 对象记录了用户添加到其账户中的银行账户。它存储关于该银行账户的关键信息，包括账户类型、状态、详细信息以及关联的账单地址。

| 字段名称                          | 类型               | 描述                                        |
| :---------------------------- | :--------------- | :---------------------------------------- |
| bankAcountid                  | UUID!            | 银行账户的唯一标识符。                               |
| accountId                     | UUID!            | 与该银行账户关联的账户的唯一标识符。                        |
| type                          | BankAccountType! | 银行账户类型，例如 CHECKING 或 SAVING。              |
| accountName                   | String!          | 与银行账户关联的名称。                               |
| status                        | String!          | 银行账户的当前状态，例如 ENABLED、DISABLED。            |
| achRouting                    | String!          | 银行账户的 ACH（Automated Clearing House）转账路由号。 |
| lastFour                      | String!          | 银行账户号的后四位，用于识别。                           |
| authChargeBackupPaymentMethod | Boolean!         | 指示该银行账户是否被设置为扣款的备用付款方式。                   |
| billingAddressId              | UUID!            | 与该银行账户关联的账单地址的唯一标识符。                      |
| nickname                      | String           | 为便于识别而给银行账户设置的可选昵称。                       |

### paypalAccounts - \[Paypal]:

`Paypal` 对象表示用户已添加到其账户中的 PayPal 账户。该对象包含关于该 PayPal 账户的关键信息，包括其唯一标识符、关联用户、状态和电子邮件地址。

| 字段名称          | 类型                   | 描述                                   |
| :------------ | :------------------- | :----------------------------------- |
| 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 />