Fluz 餘額
存款與提款會與數個不同的餘額互動。了解資金移動會影響哪個餘額很重要，因為並非每個餘額都可被提領。禮品卡餘額僅可用於消費。入帳至禮品卡餘額的資金——無論是存入
GIFT_CARD_BALANCE 或兌換 Fluz 禮品卡——都可用於購買，但無法提領至外部帳戶。存入資金
使用depositCashBalance mutation，將資金自已連結的資金來源匯入 Fluz。你可選擇目的餘額（CASH_BALANCE、GIFT_CARD_BALANCE 或 RESERVE_BALANCE）以及資金來源——從 getWallet 取得的 bankAccountId、bankCardId 或 paypalVaultId。當存入至現金餘額時，你可以使用 userCashBalanceId 指定目標的特定消費帳戶。
根據資金來源不同，存款可能即時入帳，或需 2–5 個工作天結算。需要 MAKE_DEPOSIT 權限範圍。
完整的輸入與回應參考請見從外部帳戶存入資金。
兌換 Fluz 禮品卡
Fluz 禮品卡屬於一種特殊的存款。redeemFluzGiftCard mutation 會將禮品卡代碼直接入帳至使用者的禮品卡餘額（giftCardCashBalance）。兌換為即時入帳，任何啟用手續費會反映在 depositFee。需要 MAKE_DEPOSIT 權限範圍。
詳細資訊請見兌換 Fluz 禮品卡至禮品卡餘額。
提領資金
使用withdrawCashBalance mutation，將資金自 Fluz 匯出至已連結的外部帳戶。你可選擇來源餘額（CASH_BALANCE 或 REWARDS_BALANCE）以及提領方式，並提供對應的目的地 ID：
從現金餘額提領時，請以
cashBalanceId 指定要扣款的消費帳戶。提款需要 MAKE_WITHDRAWAL 權限範圍。
完整輸入參考、錯誤處理與多座位行為請見提領資金至外部帳戶。
冪等性
存款、兌換與提款必須包含唯一且由用戶端產生的idempotencyKey。若相同的 key 被重複提交，API 會回傳原始請求的結果，而不會再次處理——以避免重複的資金移動。請為每個請求產生新的 UUID。
一覽需求
在移動資金之前，請使用 檢查帳戶餘額 或
getWallet 以確認使用者有足夠的可用餘額，並取得相關的資金來源 ID。
想了解更多？ 與我們的專家聯繫以獲取更多資訊或申請示範。