Fluz 余额
存款和取款会与几个不同的余额交互。了解一笔资金流动会影响到哪个余额很重要,因为并非所有余额都可提现。礼品卡余额仅可用于消费。记入礼品卡余额的资金——无论是存入到
GIFT_CARD_BALANCE 还是兑换 Fluz 礼品卡——都可用于消费,但不能提现到外部账户。存入资金
使用depositCashBalance mutation 将资金从已关联的资金来源转入 Fluz。你可以选择目标余额(CASH_BALANCE、GIFT_CARD_BALANCE 或 RESERVE_BALANCE)以及资金来源——从 getWallet 获取的 bankAccountId、bankCardId 或 paypalVaultId。当存入现金余额时,可通过 userCashBalanceId 指定目标消费账户。
根据资金来源不同,存款可能即时结算或在 2–5 个工作日内结算。需要 MAKE_DEPOSIT scope。
完整的输入与响应参考,请参见从外部账户存入资金。
兑换 Fluz 礼品卡
Fluz 礼品卡是一种特殊的存款方式。redeemFluzGiftCard mutation 会将礼品卡兑换码直接记入用户的礼品卡余额(giftCardCashBalance)。兑换为即时生效,任何激活费用会反映在 depositFee 中。需要 MAKE_DEPOSIT scope。
详情请参见兑换 Fluz 礼品卡至礼品卡余额。
提现资金
使用withdrawCashBalance mutation 将资金从 Fluz 转出到已关联的外部账户。你需要选择来源余额(CASH_BALANCE 或 REWARDS_BALANCE)以及提现方式,并提供匹配的目标 ID:
当从现金余额提现时,通过
cashBalanceId 指定提取的消费账户。提现需要 MAKE_WITHDRAWAL scope。
完整输入参考、错误处理与多席位行为,请参见提现到外部账户。
幂等性
存款、兑换与提现必须包含唯一、由客户端生成的idempotencyKey。如果同一个键被多次提交,API 会返回最初请求的结果,而不会再次处理——从而防止重复资金流动。务必为每个请求生成新的 UUID。
要求速览
在移动资金之前,使用检查账户余额或
getWallet 来确认用户有足够的可用余额,并检索相关的资金来源 ID。
想了解更多? 与我们的专家交流以获取更多信息或申请演示。