檢視資金來源

當你已在 Fluz 帳戶中新增資金來源後，你可以使用 getWalletquery 來擷取其清單。此查詢會提供連結到使用者錢包的所有資金來源詳細資訊。

範例請求

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

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 預付款餘額。欲了解更多，請參閱 ‘查詢帳戶餘額’.

​範例請求

​範例回應

​回應欄位說明

​bankCards - BankCardType:

​bankAccounts - [BankAccount]:

​paypalAccounts - [Paypal]:

​blockedPaymentTypes - [PaymentMethodType]:

​balances - UserBalances: