> ## 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 上最具彈性的資金來源，也是唯一可透過程式方式新增的選項。銀行卡可用於支付禮品卡購買、為虛擬卡交易提供資金、存入至你的 Fluz 餘額，並作為其他付款方式所需的備用項目。

銀行卡可透過 **API**，或透過 Fluz 行動 App 與網路入口網站新增與管理。

<Note>
  **必須先將銀行卡新增為備用付款方式，交易才能完成。**

  當使用者透過 ACH 付款時，可能會在備用卡上對交易金額進行臨時預授權。若 ACH 付款成功入帳，預授權會在 1–7 個工作天內解除；若未能入帳，則會改由備用卡扣款。
</Note>

***

## 你可以做什麼

| 動作                                  | Mutation                                                                 | 說明                          |
| ----------------------------------- | ------------------------------------------------------------------------ | --------------------------- |
| [新增銀行卡](/features/add-bank-card)    | `addBankCard`                                                            | 將金融卡、信用卡或預付卡連同帳單地址新增到使用者帳戶。 |
| [更新銀行卡](/features/add-bank-card)    | `updateBankCardNickname` · `updateBankCardPreferredMerchantCategoryCode` | 重新命名卡片或設定其偏好的商家類別代碼（MCC）。   |
| [刪除銀行卡](/features/delete-bank-card) | `deleteBankCard`                                                         | 透過將卡片狀態設為 `INACTIVE` 來移除卡片。 |

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

***

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

| 卡片類型    | 處理費   | 相對現金回饋 |
| ------- | ----- | ------ |
| **金融卡** | –1%   | 較高     |
| **信用卡** | –3%   | 較低     |
| **預付卡** | 依卡片而異 | 依情況而定  |

<Note>
  **金融卡獲得的現金回饋比信用卡更多。**

  銀行帳戶（ACH）沒有處理費，並可賺取完整的商家現金回饋比例。在可選擇的情況下，ACH 回饋最高，其次是金融卡，而信用卡的費用最高。無手續費選項請參見 [銀行帳戶](/features/link-external-bank-accounts)。
</Note>

***

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

**帳單地址。** 每張卡都必須關聯一個地址。請提供新的 `billingAddress` 物件或現有的 `userAddressId` 其一即可，兩者不可同時提供。使用 `getUserAddresses` 查詢以查找已儲存的 `userAddressId`。

<Note>
  **只有個人應用程式可以透過 API 新增銀行卡。**

  想要新增銀行卡的公開應用程式需完成 PCI 認證與 PCI 相容性聲明。若你的應用程式未通過 PCI 認證，請引導使用者透過 Fluz App 或網路入口網站新增銀行卡。
</Note>

***

> 透過 API 可設定主要、偏好或備用卡，以及更新與刪除卡片。**選擇哪個資金來源為主要、偏好或備用，需在 Fluz 控制台中管理**，無法透過 API 設定。

***

## 讀取銀行卡使用 `getWallet` 查詢可回傳使用者帳戶中的所有銀行卡，包含其類型、末四碼與目前狀態。

```graphql theme={null}
query getWallet {
  getWallet {
    bankCards {
      bankCardId
      cardType
      lastFourDigits
      cardStatus
    }
  }
}
```

完整欄位參考請見 [檢視資金來源](/features/view-funding-sources)。

***

**想了解更多嗎？** 與我們的專家聯繫以獲得更多資訊或申請示範。