跳轉到主要內容
預先資金注入的虛擬卡 是透過 Fluz API 即時發行、具有網路品牌(Visa / Mastercard)的卡片。凡是該網路被商家接受的地方都可賺取現金回饋,並可在 400+ 品牌透過禮品卡導流以獲得更高回饋。

什麼是 Fluz 虛擬卡?

Fluz 的 預先資金注入虛擬卡 是完全存在於軟體中的網路品牌、即時發行卡。與實體卡不同:
  • 沒有塑膠卡、無需運送createVirtualCard 完成時,卡片立即可用。
  • 預先資金注入 — 消費上限會在建立時,從 Fluz 錢包、禮品卡餘額、獎勵餘額,或已連結的銀行帳戶中預留。
  • 具範圍控管 — 每張卡都有自己的消費上限、有效期間、鎖定日期,以及可選的單次使用旗標,讓你精準控管可被刷卡的金額與時間。
  • 完整網路受理 — 以 Mastercard(簽帳金融卡或預付卡)或 Visa 軌道發行,可於線上或實體店面凡接受該網路之處使用。
卡片透過交換手續費機制,對所有消費賺取基礎現金回饋。在支援的商家,卡片連結優惠可再疊加額外回饋。

卡片類型

使用 getVirtualCardOffers 列舉你的帳戶可用的所有方案,包括網路類型(Mastercard / Visa)、卡片類型(簽帳金融卡 / 預付卡)、發卡銀行,以及各方案的消費上限。

卡片生命週期

卡片會經過以下狀態: 若將卡片設定為 lockCardNextUse: true,在第一次授權成功後會自動從 ACTIVE 轉為 LOCKED,不需額外的 API 呼叫。請參考 Edit Virtual Card 了解建立後如何修改此設定。

必要範圍(Scopes)

所有虛擬卡操作都需要以適當範圍產生的使用者存取權杖。三個核心範圍為: 在呼叫任何虛擬卡端點前,先以這三個範圍產生權杖:
在後續所有呼叫中,將回傳的 tokenAuthorization: Bearer <token> 傳遞。當你收到 401 時,請參考 Refresh an Expired User Access Token

資金如何運作

當卡片被扣款時,Fluz 預設依下列優先順序撥款:
  1. 指定的消費帳戶userCashBalanceId
  2. 預付(禮品卡)餘額 — 除非設定 usePrepaymentBalance: false
  3. 獎勵餘額 — 除非設定 useRewardsBalance: false
你也可以將 primaryFundingSource: BANK_ACCOUNT 設定為直接從已連結的銀行帳戶撥款。完整輸入細節與範例請見 Create Virtual Card

消費上限期間

你所設定的 spendLimit 會依選擇的 spendLimitDuration 套用: 只會被收取實際消費金額 — 消費上限是授權上限,而非預先扣款。未使用的餘額會留在你的錢包中。

單次使用卡

在建立時將 lockCardNextUse: true 設定(或透過 editVirtualCard 更新),可在首次授權後自動鎖卡。此為下列情境的建議做法:
  • 一次性廠商付款
  • 單筆交易的撥付
  • 代理式支付流程中,卡片應於一次使用後即作廢的情境

所有虛擬卡操作

下一步

建立你的第一張虛擬卡

完整的 createVirtualCard 合約 — 輸入、資金選項、消費控管與範例。