跳轉到主要內容
消費帳戶是 Fluz 中的一種現金餘額帳戶,使用者用來存放、整理與追蹤資金。每個帳戶都有自己的暱稱,因此使用者可以依用途分開消費——例如「Team Travel」、「Operations Wallet」或「Marketing Budget」——而且每個帳戶都有各自的即時餘額。 消費帳戶是其他一切資金的來源:它們持有用於購買禮品卡、資助虛擬卡交易的資金,並接收存款與轉帳。
「消費帳戶」與「現金餘額帳戶」是同一件事。在 API 中,消費帳戶以 UserCashBalance 類型呈現,相關操作名稱為 ...UserCashBalance(例如 createUserCashBalance)。本頁面全程使用「消費帳戶」一詞。

餘額

每個消費帳戶會追蹤三種餘額,皆以字串回傳: 使用者可以持有多個消費帳戶,其中一個會被標記為預設isDefault: true)。

你可以做什麼


帳戶生命週期

消費帳戶會經過少數狀態(UserCashBalanceStatus):通常為 ACTIVE,關閉後為 CLOSED 關閉帳戶不僅是狀態變更。當你關閉仍有可用餘額的消費帳戶時,該餘額必須移轉到另一個消費帳戶。若有任何虛擬卡的資金來源為欲關閉的帳戶,你必須在同一請求中將它們重新指派到新的資金來源,或將其鎖定。
關閉帳戶時,你必須處理其餘額與相依的卡片。若帳戶仍有可用餘額,請提供 transferUserCashBalanceId 以移轉該餘額。若有虛擬卡綁定此帳戶,請提供 newFundingSource 以重新指派,或提供 lockAllVirtualCards 以將其鎖定。完整輸入參數請參閱關閉消費帳戶

消費帳戶如何融入整體

消費帳戶位於使用者錢包的核心:

必要條件

列出消費帳戶需要 LIST_PAYMENT 範圍。建立、編輯與關閉消費帳戶需要 MANAGE_PAYMENT 範圍。請在呼叫這些操作前,確認你的使用者存取權杖具有正確的範圍。
想了解更多嗎?與我們的專家交談以獲取更多資訊或申請示範。