跳轉到主要內容
帳戶對帳戶轉帳 會使用 createTransfer mutation 在兩個 Fluz 帳戶之間移動資金。不同於內部轉帳—也就是在你自己的兩個消費帳戶之間移動資金—帳戶對帳戶轉帳是把錢匯到一個不同的 Fluz 帳戶：你的某位使用者、你的應用程式，或是你的兩位使用者之間。 每筆轉帳是兩步驟流程：先識別收款人，然後建立轉帳。
與內部轉帳不同。若要在你自己的消費帳戶之間移轉資金，請改用 內部資金轉移。帳戶對帳戶轉帳是將資金轉至其他 Fluz 帳戶。

​
三種轉帳方向

相同的 createTransfer mutation 支援三種方向。你執行哪一種，取決於你的驗證方式以及是否提供 destination。
帳戶對帳戶轉帳需要公開的應用程式。使用 Basic Auth（由應用程式作為付款方）的轉帳需要你的應用程式為 ACTIVE 狀態。個人應用程式無法透過 Basic Auth 發送。收款人也必須是你應用程式的註冊使用者。

​
步驟 1 — 查詢收款人

在匯款前，使用查詢將收款人解析為 accountId（兩者皆需要 QUERY_RECIPIENT 範圍）：
  • lookupUser — 以電話號碼（E.164 格式）或電子郵件查找個人。
  • lookupBusiness — 以公司名稱查找企業（不分大小寫的精確比對；同時搜尋法定名稱與 DBA）。
如果你已儲存收款人的 Fluz accountId，或在建立時替他們指定了 externalReferenceId，你可以略過查詢，直接在步驟 2 傳入該識別碼。 參見 錢包轉帳收款人查詢 以取得輸入、回應與錯誤代碼。

​
步驟 2 — 建立轉帳

使用 createTransfer mutation 匯出資金。至少需提供 idempotencyKey 與 amount；destination 與資金來源則依方向而定。
  • 識別收款人：使用 accountId 或你所指定的 externalReferenceId 擇一提供。可選擇性地指定收款帳戶上的特定 userCashBalanceId。
  • 為轉帳提供資金：預設自付款方的現金餘額扣款，或（僅限 Bearer token）自已連結的 bankCardId、bankAccountId，或 paypalVaultId。每次請求僅能使用一種資金來源。
  • 附註：可選填 memo、transactionCategory，或 attachmentId。
以 Bearer token（由使用者發送）的轉帳需要 MAKE_PAYOUT_TRANSFER_SEND 範圍。 參見 轉帳至另一個 Fluz 帳戶 取得完整輸入參考、各方向範例與錯誤處理。

​
冪等性

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

​
一覽需求

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