每個帳戶在任一時間點都只有一個主要與一個備用。為某角色選擇新的資金來源會取代先前的設定。
資金扣款如何運作
當使用者進行購買、為虛擬卡加值,或存入 Fluz 餘額時,Fluz 會先向主要資金來源扣款——預設為透過 ACH 的偏好銀行帳戶。 由於 ACH 需要數天結算(且可能失敗),備用卡片會作為安全網:- 當使用者以 ACH 付款時,系統可能會在備用卡片上對交易金額暫時預授權保留。
- 若 ACH 付款結清,預授權會在1–7 個工作天內解除。
- 若 ACH 付款未結清,則會改由備用卡片扣款。
❗️ 交易完成前必須已設定備用卡片 Fluz 要求備用資金來源為有效的銀行卡,這樣當主要資金來源失敗時,交易仍可結算。若沒有備用卡,依賴 ACH 的交易無法啟動。
設定主要與備用
可以透過 API 或 在 Fluz App/網頁入口管理主要與備用的選擇。為某角色選擇新的資金來源會取代該帳戶先前的設定。透過 API
📘 驗證與權限範圍 這些操作需要使用者存取權杖。讀取(getDefaultFundingSource)使用LIST_PAYMENT範圍;變更(setPrimaryFundingSource、setBackupFundingSource)使用MANAGE_PAYMENT。
讀取目前的預設資金來源
回傳帳戶的兩個角色。當未設定主要銀行帳戶時,primary 為 null;當未設定備用卡片時,backup 為 null。
Query
Response
👍 一次呼叫,同步讀取兩者 相同的DefaultFundingSource物件也會出現在getWallet { defaultFundingSource { … } }中——因此你可在列出錢包內容的同一呼叫中讀取目前的選擇。
設定主要資金來源(銀行帳戶)
Mutation
Response
設定備用資金來源(銀行卡)
Mutation
Response
📘 兩種變更操作都會回傳帳戶完整的 DefaultFundingSource
每個變更操作都會在更新後同時回傳主要+備用——一次呼叫即可更新其中一個角色並確認結果狀態。
驗證規則
bankAccountId必須是已連結且啟用於該帳戶的銀行帳戶;bankCardId必須是屬於該帳戶且為啟用/有效的銀行卡。- 主要必須是銀行帳戶,備用必須是銀行卡——類型不符會被拒絕。
- 設定某角色會取代該帳戶先前的選擇(同時間僅有一個主要與一個備用)。
錯誤
Example error
extensions 下,並以 code/errorName 標識。statusCode 是載於 extensions 的「語意型」狀態碼(如 400、422)——即使發生錯誤,GraphQL 傳輸層仍會回傳 HTTP 200,失敗資訊位於 errors 陣列,且 data.<field> 會是 null。請透過檢查 errors 陣列而非 HTTP 狀態碼來判定失敗。 有些錯誤還會包含選用的 codeNumber 與 notificationDetails 欄位,userFriendly 表示 message 是否可直接顯示給終端使用者。
在 App/網頁
在網頁- 從帳戶選單開啟 Accounts and Cards(或前往
/accounts-and-cards)。 - 在頁面頂端的 Default funding source 區塊:
- 選擇 Manage preferred account 以挑選作為預設資金來源的銀行帳戶。
- 選擇 Manage backup card 以挑選在偏好帳戶無法扣款時會被扣款的銀行卡。
- 你的選擇會立即儲存。
- 開啟選單並點選 Accounts and Cards。
- 在 Default funding source 下,點選 Manage preferred account 或 Manage backup card。
- 從已連結的資金來源中選擇。你的選擇會立即儲存。
透過 API 與 App/網頁可執行的項目
請參閱 Bank Cards 與 Bank Accounts,以了解透過 API 可用的底層資金來源操作。
資格條件與注意事項
- 主要付款方式必須是已連結的銀行帳戶;備用必須是銀行卡。
- 企業帳戶必須完成 KYB 驗證,才能設定資金來源,進而設定預設資金來源。
- 某些資金來源可能因特定商家或帳戶限制而受限,將無法被選為預設。
📘 想了解更多?與我們的專家洽談 以取得更多資訊或預約示範。