管理已連結的銀行卡

銀行卡——借記卡、信用卡或預付卡——是在 Fluz 上最具彈性的資金來源，也是唯一可以透過程式化方式新增的資金來源。銀行卡可用於支付禮品卡購買、為虛擬卡交易提供資金、存入至你的 Fluz 餘額，並作為其他付款方式所需的備用支付工具。可透過 API 或 Fluz 行動應用程式與網頁入口新增與管理銀行卡。

在任何交易完成之前，必須先新增一張作為備用支付方式的銀行卡。當使用者以 ACH 付款時，系統可能會在備用卡上暫時預授權交易金額。若 ACH 付款成功結清，預授權會在 1–7 個工作天內解除；若未結清，則會改向備用卡收款。

你可以做什麼

動作	Mutation	說明
新增銀行卡	`addBankCard`	將借記卡、信用卡或預付卡連同帳單地址新增至使用者帳戶。
更新銀行卡	`updateBankCardNickname` · `updateBankCardPreferredMerchantCategoryCode`	重新命名卡片或設定其偏好的商家類別代碼（MCC）。
刪除銀行卡	`deleteBankCard`	將卡片狀態設為 `INACTIVE` 以移除卡片。

所有銀行卡的 mutation 都需要 MANAGE_PAYMENT 權限範圍。

費用與現金回饋卡片類型會影響使用者在購買時獲得的實際現金回饋比率：

卡片類型	手續費	相對現金回饋
借記卡	–1%	較高
信用卡	–3%	較低
預付卡	視卡片而定	視情況而定

借記卡獲得的現金回饋高於信用卡。銀行帳戶（ACH）不收取處理費，且可獲得商家提供的完整現金回饋比率。若使用者可選擇，ACH 回饋最高，其次是借記卡，而信用卡的費用最高。請參閱銀行帳戶以了解免手續費的選項。

必要條件權限範圍。每個銀行卡的 mutation 都需要使用者存取權杖上具備 `MANAGE_PAYMENT` 權限範圍。

帳單地址。 每張卡都必須關聯一個地址。請提供新的 billingAddress 物件或既有的 userAddressId 二選一，勿同時提供。使用 getUserAddresses 查詢以查找已儲存的 userAddressId。

只有個人類型的應用程式可以透過 API 新增銀行卡。任何公開提供的應用程式若要新增銀行卡，必須完成 PCI 認證並提交 PCI 相容性聲明。若你的應用程式未通過 PCI 認證，請引導使用者改以 Fluz 行動應用程式或網頁入口新增銀行卡。

透過 API 可設定主要、偏好或備用卡，並可更新與刪除卡片。選擇哪個資金來源為主要、偏好或備用，乃在 Fluz 儀表板中管理，而非透過 API。

讀取銀行卡使用 `getWallet` 查詢以回傳使用者帳戶上的所有銀行卡，以及其卡片類型、末四碼與目前狀態。

query getWallet {
  getWallet {
    bankCards {
      bankCardId
      cardType
      lastFourDigits
      cardStatus
    }
  }
}

完整欄位說明請參閱檢視資金來源。

想了解更多？ 與我們的專家洽談以取得更多資訊或申請示範。

​你可以做什麼

​費用與現金回饋卡片類型會影響使用者在購買時獲得的實際現金回饋比率：

​必要條件權限範圍。 每個銀行卡的 mutation 都需要使用者存取權杖上具備 MANAGE_PAYMENT 權限範圍。

​讀取銀行卡使用 getWallet 查詢以回傳使用者帳戶上的所有銀行卡，以及其卡片類型、末四碼與目前狀態。

你可以做什麼

費用與現金回饋卡片類型會影響使用者在購買時獲得的實際現金回饋比率：

必要條件權限範圍。每個銀行卡的 mutation 都需要使用者存取權杖上具備 `MANAGE_PAYMENT` 權限範圍。

讀取銀行卡使用 `getWallet` 查詢以回傳使用者帳戶上的所有銀行卡，以及其卡片類型、末四碼與目前狀態。