Skip to main content
每個 Fluz 帳戶都有一組由兩個角色構成的預設資金來源——主要銀行帳戶與備用卡片。系統會先嘗試扣款主要來源;若無法扣款,才由備用來源接手。此頁說明資金扣款如何運作,以及如何透過 API 或在 App 中閱讀與變更兩個角色。 每個帳戶在任一時間點都只有一個主要與一個備用。為某角色選擇新的資金來源會取代先前的設定。

資金扣款如何運作

當使用者進行購買、為虛擬卡加值,或存入 Fluz 餘額時,Fluz 會先向主要資金來源扣款——預設為透過 ACH 的偏好銀行帳戶。 由於 ACH 需要數天結算(且可能失敗),備用卡片會作為安全網:
  1. 當使用者以 ACH 付款時,系統可能會在備用卡片上對交易金額暫時預授權保留
  2. 若 ACH 付款結清,預授權會在1–7 個工作天內解除。
  3. 若 ACH 付款未結清,則會改由備用卡片扣款
❗️ 交易完成前必須已設定備用卡片 Fluz 要求備用資金來源為有效的銀行卡,這樣當主要資金來源失敗時,交易仍可結算。若沒有備用卡,依賴 ACH 的交易無法啟動

設定主要與備用

可以透過 API在 Fluz App/網頁入口管理主要與備用的選擇。為某角色選擇新的資金來源會取代該帳戶先前的設定。

透過 API

📘 驗證與權限範圍 這些操作需要使用者存取權杖。讀取(getDefaultFundingSource)使用 LIST_PAYMENT 範圍;變更(setPrimaryFundingSourcesetBackupFundingSource)使用 MANAGE_PAYMENT

讀取目前的預設資金來源

回傳帳戶的兩個角色。當未設定主要銀行帳戶時,primarynull;當未設定備用卡片時,backupnull
Query
Response
回應欄位
👍 一次呼叫,同步讀取兩者 相同的 DefaultFundingSource 物件也會出現在 getWallet { defaultFundingSource { … } } 中——因此你可在列出錢包內容的同一呼叫中讀取目前的選擇。

設定主要資金來源(銀行帳戶)

Mutation
Response

設定備用資金來源(銀行卡)

Mutation
Response
📘 兩種變更操作都會回傳帳戶完整的 DefaultFundingSource 每個變更操作都會在更新後同時回傳主要+備用——一次呼叫即可更新其中一個角色並確認結果狀態。

驗證規則

  • bankAccountId 必須是已連結且啟用於該帳戶的銀行帳戶;bankCardId 必須是屬於該帳戶且為啟用/有效的銀行卡。
  • 主要必須是銀行帳戶,備用必須是銀行卡——類型不符會被拒絕。
  • 設定某角色會取代該帳戶先前的選擇(同時間僅有一個主要與一個備用)。

錯誤

Example error
結構化錯誤位於 extensions 下,並以 codeerrorName 標識。statusCode 是載於 extensions 的「語意型」狀態碼(如 400422)——即使發生錯誤,GraphQL 傳輸層仍會回傳 HTTP 200,失敗資訊位於 errors 陣列,且 data.<field> 會是 null請透過檢查 errors 陣列而非 HTTP 狀態碼來判定失敗。 有些錯誤還會包含選用的 codeNumbernotificationDetails 欄位,userFriendly 表示 message 是否可直接顯示給終端使用者。

在 App/網頁

在網頁
  1. 從帳戶選單開啟 Accounts and Cards(或前往 /accounts-and-cards)。
  2. 在頁面頂端的 Default funding source 區塊:
    • 選擇 Manage preferred account 以挑選作為預設資金來源的銀行帳戶。
    • 選擇 Manage backup card 以挑選在偏好帳戶無法扣款時會被扣款的銀行卡。
  3. 你的選擇會立即儲存。
在行動裝置
  1. 開啟選單並點選 Accounts and Cards
  2. Default funding source 下,點選 Manage preferred accountManage backup card
  3. 從已連結的資金來源中選擇。你的選擇會立即儲存。
若尚未有符合資格的資金來源,App 會先提示你新增——偏好帳戶需要銀行帳戶,備用需要銀行卡。

透過 API 與 App/網頁可執行的項目

請參閱 Bank CardsBank Accounts,以了解透過 API 可用的底層資金來源操作。

資格條件與注意事項

  • 主要付款方式必須是已連結的銀行帳戶;備用必須是銀行卡
  • 企業帳戶必須完成 KYB 驗證,才能設定資金來源,進而設定預設資金來源。
  • 某些資金來源可能因特定商家或帳戶限制而受限,將無法被選為預設。
📘 想了解更多?與我們的專家洽談 以取得更多資訊或預約示範。