總覽

​

支援的資金來源

💡 銀行帳戶沒有處理手續費，且可賺取最高的現金回饋率。 簽帳卡是其次佳選擇。信用卡、PayPal、Apple Pay 和 Google Pay 皆有處理手續費，會降低實際現金回饋率。

​

依資金來源的現金回饋率

ACH / Bank Account    → 4.0%  →  $8.00
Debit Card            → 3.0%  →  $6.00  (–1% processing fee)
Credit Card           → 1.0%  →  $2.00  (–3% processing fee)
PayPal / Apple Pay    → 1.0%  →  $2.00  (–3% processing fee)

​

透過 API 與 App / Web 可執行的操作

🚧 銀行卡是唯一可透過 API 新增的資金來源。 其他資金來源管理——銀行帳戶、PayPal、Apple Pay、Google Pay，以及付款方式偏好設定——都必須透過 Fluz App 或網頁入口完成。

​

銀行帳戶

💡 透過單一銀行登入連結的所有帳戶都會被連結，包括儲蓄帳戶。使用者應在連結後移除儲蓄帳戶——多數銀行不允許從儲蓄帳戶進行付款。

​

銀行卡

• 新增 — addBankCard（需要 MANAGE_PAYMENT scope）
• 更新暱稱 — updateBankCardNickname
• 更新偏好 MCC — updateBankCardPreferredMerchantCategoryCode
• 刪除 — deleteBankCard（將狀態設為 INACTIVE）

❗️ 在完成任何交易之前，必須先新增一張銀行卡作為備用付款方式。 當使用者透過 ACH 付款時，可能會在備用卡上暫時預扣交易金額。若 ACH 付款成功清算，預扣會在 1–7 個工作天內解除；若未清算，則會改由備用卡扣款。

​

PayPal / Apple Pay / Google Pay

💡 部分商家會限制可接受的付款方式。商家可能只接受 ACH 與簽帳卡，並封鎖信用卡與數位錢包。這會反映在 getWallet 回傳的 blockedPaymentTypes 欄位中。

​

透過 API 讀取資金來源

query getWallet {
  getWallet {
    bankCards { bankCardId cardType lastFourDigits cardStatus }
    bankAccounts { bankAccountId type status lastFour }
    paypalAccounts { paypalVaultId status email }
    blockedPaymentTypes
    balances {
      rewardsBalance { availableBalance }
      cashBalance { availableBalance }
    }
  }
}