跳转到主要内容
在用户的Fluz 钱包与其外部账户之间转移资金——包括银行账户、银行卡或数字钱包(PayPal、Venmo)。存款将资金从外部来源_转入_ Fluz 钱包以为购买提供资金;取款将资金从 Fluz 钱包_转出_到已关联的外部目的地。 这与在 Fluz _内部_移动资金不同:在用户自己的消费账户之间划转资金,请使用在消费账户之间转账;向其他 Fluz 账户转账,请使用账户到账户转账

Fluz 余额

存款和取款会与几个不同的余额交互。了解一笔资金流动会影响到哪个余额很重要,因为并非所有余额都可提现。
礼品卡余额仅可用于消费。记入礼品卡余额的资金——无论是存入到 GIFT_CARD_BALANCE 还是兑换 Fluz 礼品卡——都可用于消费,但不能提现到外部账户。

存入资金

使用 depositCashBalance mutation 将资金从已关联的资金来源转入 Fluz。你可以选择目标余额CASH_BALANCEGIFT_CARD_BALANCERESERVE_BALANCE)以及资金来源——从 getWallet 获取的 bankAccountIdbankCardIdpaypalVaultId。当存入现金余额时,可通过 userCashBalanceId 指定目标消费账户。 根据资金来源不同,存款可能即时结算或在 2–5 个工作日内结算。需要 MAKE_DEPOSIT scope。 完整的输入与响应参考,请参见从外部账户存入资金

兑换 Fluz 礼品卡

Fluz 礼品卡是一种特殊的存款方式。redeemFluzGiftCard mutation 会将礼品卡兑换码直接记入用户的礼品卡余额(giftCardCashBalance)。兑换为即时生效,任何激活费用会反映在 depositFee 中。需要 MAKE_DEPOSIT scope。 详情请参见兑换 Fluz 礼品卡至礼品卡余额

提现资金

使用 withdrawCashBalance mutation 将资金从 Fluz 转出到已关联的外部账户。你需要选择来源余额CASH_BALANCEREWARDS_BALANCE)以及提现方式,并提供匹配的目标 ID: 当从现金余额提现时,通过 cashBalanceId 指定提取的消费账户。提现需要 MAKE_WITHDRAWAL scope。 完整输入参考、错误处理与多席位行为,请参见提现到外部账户

幂等性

存款、兑换与提现必须包含唯一、由客户端生成的 idempotencyKey。如果同一个键被多次提交,API 会返回最初请求的结果,而不会再次处理——从而防止重复资金流动。务必为每个请求生成新的 UUID。

要求速览

在移动资金之前,使用检查账户余额getWallet 来确认用户有足够的可用余额,并检索相关的资金来源 ID。
想了解更多? 与我们的专家交流以获取更多信息或申请演示。