跳轉到主要內容
redeemFluzGiftCard mutation 可讓你使用禮品卡代碼,將 Fluz 禮品卡兌換到已驗證使用者的帳戶。 兌換成功會將金額存入使用者的禮品卡餘額giftCardCashBalance)。 此 mutation 需要 MAKE_DEPOSIT 範圍。

參數

  • inputRedeemFluzGiftCardInput!):包含冪等鍵與禮品卡代碼的輸入物件。

RedeemFluzGiftCardInput 欄位


回應

回傳 DepositCashBalanceResponse,包含:
  • cashBalanceDeposits — 本次兌換所建立的存入紀錄
  • balances — 兌換後更新的使用者餘額
兌換的金額會存入 balances.giftCardCashBalance(而非 cashBalance)。

範例 Mutation


變數


cURL 範例


行為

  • 餘額目的地 — 資金會存入 giftCardCashBalance
  • 冪等性 — 針對相同的 idempotencyKey,在處理中的重複請求會被拒絕。
  • 空白處理code 的前後空白會自動去除。
  • 手續費 — 任何啟用費用會反映在 depositFee 中。
  • 清算 — 兌換為即時INSTANTAVAILABLE)。

錯誤