Fluz 余额
存取款会与几种不同的余额交互。了解一次资金流动涉及哪个余额很重要，因为并非所有余额都可提现。礼品卡余额仅可用于消费。记入礼品卡余额的资金——无论是存入
GIFT_CARD_BALANCE 还是兑换 Fluz 礼品卡——都可用于消费，但不能提现到外部账户。存入资金
使用depositCashBalance mutation 从已绑定的资金来源将资金转入 Fluz。你需要选择目标余额（CASH_BALANCE、GIFT_CARD_BALANCE 或 RESERVE_BALANCE）以及资金来源——从 getWallet 获取的 bankAccountId、bankCardId 或 paypalVaultId。当存入现金余额时，你可以通过 userCashBalanceId 指定目标消费账户。
存款可能即时入账，或根据资金来源在 2–5 个工作日内结算。需要 MAKE_DEPOSIT 权限。
由借记卡资助、存入 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。如果同一键被多次提交，API 将返回最初请求的结果，而不会再次处理——以防止重复资金流动。务必为每次请求生成新的 UUID。
要求速览
在移动资金之前，使用检查账户余额或
getWallet 确认用户有足够的可用余额，并获取相关资金来源 ID。
想了解更多？ 联系我们的专家以获取更多信息或申请演示。