「消費帳戶」與「現金餘額帳戶」是同一件事。在 API 中,消費帳戶以
UserCashBalance 類型呈現,相關操作名稱為 ...UserCashBalance(例如 createUserCashBalance)。本頁面全程使用「消費帳戶」一詞。餘額
每個消費帳戶會追蹤三種餘額,皆以字串回傳:
使用者可以持有多個消費帳戶,其中一個會被標記為預設(
isDefault: true)。
你可以做什麼
帳戶生命週期
消費帳戶會經過少數狀態(UserCashBalanceStatus):通常為 ACTIVE,關閉後為 CLOSED。
關閉帳戶不僅是狀態變更。當你關閉仍有可用餘額的消費帳戶時,該餘額必須移轉到另一個消費帳戶。若有任何虛擬卡的資金來源為欲關閉的帳戶,你必須在同一請求中將它們重新指派到新的資金來源,或將其鎖定。
關閉帳戶時,你必須處理其餘額與相依的卡片。若帳戶仍有可用餘額,請提供
transferUserCashBalanceId 以移轉該餘額。若有虛擬卡綁定此帳戶,請提供 newFundingSource 以重新指派,或提供 lockAllVirtualCards 以將其鎖定。完整輸入參數請參閱關閉消費帳戶。消費帳戶如何融入整體
消費帳戶位於使用者錢包的核心:必要條件
列出消費帳戶需要LIST_PAYMENT 範圍。建立、編輯與關閉消費帳戶需要 MANAGE_PAYMENT 範圍。請在呼叫這些操作前,確認你的使用者存取權杖具有正確的範圍。
想了解更多嗎?與我們的專家交談以獲取更多資訊或申請示範。