跳转到主要内容
redeemFluzGiftCard 变更允许你使用礼品卡代码,将 Fluz 礼品卡兑换到已认证用户的账户中。 兑换成功会将金额记入用户的礼品卡余额giftCardCashBalance)。 此变更需要 MAKE_DEPOSIT 权限范围。

参数

  • inputRedeemFluzGiftCardInput!):包含幂等键与礼品卡代码的输入对象。

RedeemFluzGiftCardInput 字段


响应

返回 DepositCashBalanceResponse,包括:
  • cashBalanceDeposits — 为本次兑换创建的存入记录
  • balances — 兑换后的用户余额更新
兑换的金额会计入 balances.giftCardCashBalance(而非 cashBalance)。

示例变更


变量


cURL 示例


行为

  • 余额去向 — 资金会记入 giftCardCashBalance
  • 幂等性 — 使用相同 idempotencyKey 的重复请求在进行中时会被拒绝。
  • 空白处理 — 会自动修剪 code 首尾的空格。
  • 费用 — 任何激活费会体现在 depositFee 中。
  • 结算 — 兑换为即时INSTANTAVAILABLE)。

错误