查看资金来源

一旦你已将资金来源添加到你的 Fluz 账户中，你可以使用 getWallet查询来获取它们的列表。该查询将提供与用户钱包关联的所有资金来源的详细信息。

示例请求

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 等资金来源类型。以下是响应对象示例：

示例响应

{
  "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 预付款余额。欲了解更多，可查看’检查账户余额’。

​示例请求

​示例响应

​响应字段说明

​bankCards - BankCardType:

​bankAccounts - [BankAccount]:

​paypalAccounts - [Paypal]:

​blockedPaymentTypes - [PaymentMethodType]:

​balances - UserBalances: