Fluz 餘額
存款與提款會與幾個不同的餘額互動。了解每次移動會影響哪個餘額很重要，因為並非每種餘額都可提領。禮品卡餘額僅可用於消費。存入至禮品卡餘額的資金——無論是存入
GIFT_CARD_BALANCE 或兌換 Fluz 禮品卡——皆可用於購物，但無法提領至外部帳戶。存入資金
使用depositCashBalance mutation，將資金從已連結的資金來源匯入 Fluz。你可以選擇目的餘額（CASH_BALANCE、GIFT_CARD_BALANCE 或 RESERVE_BALANCE）以及資金來源——從 getWallet 取得的 bankAccountId、bankCardId 或 paypalVaultId。當存入現金餘額時，你可以透過 userCashBalanceId 指定目標的特定消費帳戶。
存款可能即時結算，或依資金來源於 2–5 個工作天內結算。需要 MAKE_DEPOSIT 權限範圍。
以**金融簽帳卡（debit card）**為資金來源存入 CASH_BALANCE 的存款，可能會以帳戶資金交易（AFT）處理，並有其專屬費率。Fluz 會在可用時自動套用，因此請從回應的 depositFee 讀取費用，而非自行計算——請參閱從外部帳戶存入資金。
完整的輸入與回應參考，請見從外部帳戶存入資金。
兌換 Fluz 禮品卡
Fluz 禮品卡是一種特殊的存款方式。redeemFluzGiftCard mutation 會將禮品卡代碼直接入帳至使用者的禮品卡餘額（giftCardCashBalance）。兌換為即時處理，任何啟用費將反映於 depositFee。需要 MAKE_DEPOSIT 權限範圍。
詳情請參閱兌換 Fluz 禮品卡至禮品卡餘額。
提領資金
使用withdrawCashBalance mutation，將資金從 Fluz 匯出至已連結的外部帳戶。你可以選擇來源餘額（CASH_BALANCE 或 REWARDS_BALANCE）以及提領方式，並提供對應的目的地 ID：
從現金餘額提領時，請以
cashBalanceId 指定要扣款的消費帳戶。提款需要 MAKE_WITHDRAWAL 權限範圍。
手續費會自提款金額中扣除，因此目的地實收金額會小於 amount。請先使用 getWithdrawFeeEstimate 取得確切的費用、淨額與結算時間報價。
完整輸入參考、錯誤處理與多席位行為，請見提領資金至外部帳戶。
冪等性
存款、兌換與提款都必須包含唯一、由客戶端產生的idempotencyKey。若同一個 key 被重複提交，API 會回傳原始請求的結果，而不會再次處理——以防止重複移轉資金。請務必為每個請求產生新的 UUID。
一覽需求
在移轉資金前，請使用查詢帳戶餘額或
getWallet 確認使用者有足夠的可用餘額，並取得相關資金來源 ID。
想了解更多嗎？與我們的專家聯繫以取得更多資訊或索取示範。