> ## 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 上成本最低、回饋最高的資金來源。銀行帳戶透過 **Plaid** 連結並以 **ACH** 清算——不收取處理費，且可賺取商家的完整現金回饋比率。

銀行帳戶的連結與管理透過公開的 GraphQL 包裝層提供。Identity-service 仍是 Plaid 權杖、帳戶擷取、餘額、歷史交易，以及 Plaid webhook 的權威系統。

<Note>
  **銀行帳戶不收處理費，並可賺取最高的現金回饋比率。**

  以 4% 的商家優惠為例，ACH 付款可拿到完整 4%，而扣款卡因處理費為 3%，信用卡為 1%。在使用者可選擇的情況下，已連結的銀行帳戶永遠是回饋最高的選項。
</Note>

***

## 你可以做什麼

以下所有功能皆透過 Plaid 整合實現。完整的請求與回應細節請參見 [透過 Plaid 連結銀行帳戶](/features/link-via-plaid)。

### 連結

| 功能         | 操作                                                               | 說明                                                      |
| ---------- | ---------------------------------------------------------------- | ------------------------------------------------------- |
| 建立 Link 權杖 | `createPlaidLinkToken`                                           | 產生用於開啟 Plaid Link 的權杖。                                  |
| 完成新連結      | `completePlaidLink`                                              | 交換 Plaid 的 `public_token` 並擷取已連結的帳戶。                    |
| 修復中斷的連線    | `createPlaidLinkToken` + `completePlaidLink`（含 `platformItemId`） | 重新連結先前已連結但已中斷的金融機構。                                     |
| 附加必要地址     | `createPlaidLinkAddress`                                         | 當 `completePlaidLink` 回傳 `requiresAddress: true` 時新增地址。 |

### 餘額與可用消費力

| 功能       | 操作                                                    | 說明                         |
| -------- | ----------------------------------------------------- | -------------------------- |
| 列出已連結帳戶  | `getPlaidBankAccounts`                                | 回傳所有已連結銀行帳戶的安全後設資料。        |
| 讀取儲存的餘額  | `getPlaidBankBalances` · `getPlaidBankAccountBalance` | 取得所有帳戶或單一帳戶的最新儲存餘額。        |
| 讀取可用消費力  | `getPlaidBankAccountSpendPower`                       | 回傳可用消費力、上次記錄的餘額與待處理活動。     |
| 重新整理單一餘額 | `refreshPlaidBankAccountBalance`                      | 針對單一帳戶發起受速率限制的即時餘額重新整理。    |
| 重新整理所有連線 | `refreshPlaidBankConnections`                         | 對所有已連結的 Plaid 資料發起快取式重新整理。 |

### 交易

| 功能     | 操作                         | 說明                    |
| ------ | -------------------------- | --------------------- |
| 讀取交易歷史 | `getPlaidBankTransactions` | 回傳具商家與類別細節的歷史、分頁銀行交易。 |

### 管理

| 功能     | 操作                           | 說明                   |
| ------ | ---------------------------- | -------------------- |
| 移除金融機構 | `removePlaidBankInstitution` | 中斷與已連結銀行金融機構及其帳戶的連線。 |

***

## 要求

所有銀行帳戶操作皆需要包含 `MANAGE_PAYMENT` 範圍的 Fluz 使用者存取權杖。

**僅支援 Bearer 驗證。** Plaid 欄位不接受 Basic 驗證。請先透過標準驗證流程取得使用者存取權杖，然後以 `Authorization: Bearer <fluz-user-access-token>` 呼叫 Plaid 欄位。

***

## 餘額重新整理限制

餘額重新整理會依每個 Plaid 金融機構控管成本：

* 每小時限 **一次** 即時重新整理
* 每日限 **六次** 即時重新整理

在限制時間窗內的呼叫，將回傳最新的已儲存餘額，而不會觸發新的即時請求。

***

## 儲蓄帳戶

<Note>
  **連結一次登入會連到其底下的所有帳戶，包括儲蓄帳戶。**

  多數銀行不允許從儲蓄帳戶付款。連結後，使用者應移除不打算用於付款的任何儲蓄帳戶，以避免交易失敗。
</Note>

***

## 不支援的流程

不支援以小額存款驗證的連結。新的連結與重新連結必須使用標準的 Plaid Link 流程，該流程支援餘額與歷史交易。

***

## 安全性

我們不會儲存 Plaid access tokens、Plaid public tokens、身份比對細節、銀行帳號或匯款路由號。透過 API 僅會暴露安全的帳戶後設資料——例如金融機構名稱、末四碼、類型，以及使用者輸入的標籤。

***

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