> ## 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.

# 總覽

**帳戶對帳戶轉帳** 會使用 `createTransfer` mutation 在兩個 Fluz 帳戶之間移動資金。不同於內部轉帳—也就是在你自己的兩個消費帳戶之間移動資金—帳戶對帳戶轉帳是把錢匯到一個**不同的 Fluz 帳戶**：你的某位使用者、你的應用程式，或是你的兩位使用者之間。

每筆轉帳是兩步驟流程：先識別收款人，然後建立轉帳。

| 步驟       | 頁面                                                          | 目的                            |
| -------- | ----------------------------------------------------------- | ----------------------------- |
| 1. 找到收款人 | [錢包轉帳收款人查詢](/features/recipient-lookup)                     | 將電話、電子郵件或公司名稱解析為收款人的帳戶 ID。    |
| 2. 匯出資金  | [轉帳至另一個 Fluz 帳戶](/features/transfer-to-another-fluz-wallet) | 使用 `createTransfer` 將資金匯給收款人。 |

<Note>
  **與內部轉帳不同。**

  若要在你自己的消費帳戶之間移轉資金，請改用 [內部資金轉移](/features/transfer-between-spend-accounts)。帳戶對帳戶轉帳是將資金轉至**其他** Fluz 帳戶。
</Note>

***

## 三種轉帳方向

相同的 `createTransfer` mutation 支援三種方向。你執行哪一種，取決於你的驗證方式以及是否提供 `destination`。

| 方向             | 驗證方式         | 付款方    | 典型用途                                 |
| -------------- | ------------ | ------ | ------------------------------------ |
| **使用者 → 應用程式** | Bearer token | 使用者    | 向使用者收款（不需 `destination`—預設為你的應用程式）。  |
| **應用程式 → 使用者** | Basic Auth   | 你的應用程式 | 對使用者撥款（需要 `destination`）。            |
| **使用者 → 使用者**  | Bearer token | 使用者    | 在你的兩位使用者之間移轉資金（`destination` 設為收款人）。 |

<Warning>
  **帳戶對帳戶轉帳需要公開的應用程式。**

  使用 Basic Auth（由應用程式作為付款方）的轉帳需要你的應用程式為 `ACTIVE` 狀態。個人應用程式無法透過 Basic Auth 發送。收款人也必須是你應用程式的註冊使用者。
</Warning>

***

## 步驟 1 — 查詢收款人

在匯款前，使用查詢將收款人解析為 `accountId`（兩者皆需要 `QUERY_RECIPIENT` 範圍）：

* `lookupUser` — 以**電話號碼**（E.164 格式）或**電子郵件**查找個人。
* `lookupBusiness` — 以**公司名稱**查找企業（不分大小寫的精確比對；同時搜尋法定名稱與 DBA）。

如果你已儲存收款人的 Fluz `accountId`，或在建立時替他們指定了 `externalReferenceId`，你可以略過查詢，直接在步驟 2 傳入該識別碼。

參見 [錢包轉帳收款人查詢](/features/recipient-lookup) 以取得輸入、回應與錯誤代碼。

***

## 步驟 2 — 建立轉帳

使用 `createTransfer` mutation 匯出資金。至少需提供 `idempotencyKey` 與 `amount`；`destination` 與資金來源則依方向而定。

* **識別收款人**：使用 `accountId` 或你所指定的 `externalReferenceId` 擇一提供。可選擇性地指定收款帳戶上的特定 `userCashBalanceId`。
* **為轉帳提供資金**：預設自付款方的現金餘額扣款，或（僅限 Bearer token）自已連結的 `bankCardId`、`bankAccountId`，或 `paypalVaultId`。每次請求僅能使用一種資金來源。
* **附註**：可選填 `memo`、`transactionCategory`，或 `attachmentId`。

以 Bearer token（由使用者發送）的轉帳需要 `MAKE_PAYOUT_TRANSFER_SEND` 範圍。

參見 [轉帳至另一個 Fluz 帳戶](/features/transfer-to-another-fluz-wallet) 取得完整輸入參考、各方向範例與錯誤處理。

***

## 冪等性

每筆轉帳必須包含唯一且由客戶端產生的 `idempotencyKey`。若相同金鑰被提交多次，API 會回傳原始請求的結果，而非建立重複的轉帳。金鑰有效期間為 10 分鐘。

***

## 一覽需求

| 操作           | 驗證                   | 範圍                          |
| ------------ | -------------------- | --------------------------- |
| 查詢收款人        | Bearer token         | `QUERY_RECIPIENT`           |
| 建立轉帳（使用者發送）  | Bearer token         | `MAKE_PAYOUT_TRANSFER_SEND` |
| 建立轉帳（應用程式發送） | Basic Auth (Api Key) | 公開 / `ACTIVE` 應用程式          |

***

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