> ## 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 新增 | 透過 App / Web 新增 | 手續費                      | 最佳現金回饋    |
| ----------------------------------- | --------- | --------------- | ------------------------ | --------- |
| **銀行帳戶（ACH）**                       | ✗         | ✓               | 無                        | ✓ 全額      |
| **銀行卡**（簽帳/信用/預付）                   | ✓         | ✓               | 簽帳卡：–1% · 信用卡/PayPal：–3% | 簽帳卡 > 信用卡 |
| **PayPal / Apple Pay / Google Pay** | ✗         | ✓               | –3%                      | 較低        |
| **Fluz 餘額**                         | —         | —               | 無                        | 標準        |

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

***

## 依資金來源的現金回饋率

以**商家 4% 現金回饋率**、購買一張 200 美元禮品卡為例：

```text theme={null}
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 可執行的操作

```mermaid theme={null}
flowchart LR
    subgraph API["🔌 API"]
        A1[Add Bank Card\naddBankCard mutation]
        A2[Update Bank Card\nnickname / MCC]
        A3[Delete Bank Card]
        A4[Read all funding sources\ngetWallet query]
    end

    subgraph Web["🌐 App / Web Portal Only"]
        W1[Add Bank Account\nvia Plaid Link]
        W2[Remove Bank Account]
        W3[Add PayPal]
        W4[Add Apple Pay / Google Pay]
        W5[Set primary / preferred /\nbackup payment method]
    end
```

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

***

## 銀行帳戶

銀行帳戶透過 **Plaid** 連結，並以 ACH 清算。無手續費，且可賺取商家提供的全額現金回饋率。

**新增方式：僅限 App 或網頁入口。**

![在 Fluz App 中新增銀行帳戶](https://downloads.intercomcdn.com/i/o/836799999/6f3ab32e045b7011dd3bd0fb/How+to+manage+and+select+a+funding+source.gif)

*新增步驟：選單 → Funding Sources → Add New → Bank Account → 依照 Plaid 提示進行。*

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

***

## 銀行卡

銀行卡（簽帳、信用或預付）可透過 **API**，或透過 App 與網頁入口新增。

**新增方式：** `addBankCard `**mutation（API）或 App / Web 入口。**

![在 Fluz App 中新增銀行卡](https://downloads.intercomcdn.com/i/o/836809654/93aa3bc1b082cff44ef2a70c/How+to+manage+and+select+a+funding+source.gif)

*在網頁新增：選單 → Accounts and Cards → Bank Cards → Add New → 輸入卡片資料與帳單地址。*

銀行卡透過 API 支援以下操作：

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

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

***

## PayPal / Apple Pay / Google Pay

數位錢包僅能透過 App 或網頁入口新增。其有 –3% 的處理手續費，對實際現金回饋率的影響與信用卡相同。

**新增方式：僅限 App 或網頁入口。API 不支援。**

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

***

## 透過 API 讀取資金來源

`getWallet` 查詢會回傳連結至使用者帳戶的所有資金來源、其目前狀態，以及任何被封鎖的付款類型。

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

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

<br />