什麼是 Fluz 虛擬卡?
Fluz 的 預先資金注入虛擬卡 是完全存在於軟體中的網路品牌、即時發行卡。與實體卡不同:- 沒有塑膠卡、無需運送 —
createVirtualCard完成時,卡片立即可用。 - 預先資金注入 — 消費上限會在建立時,從 Fluz 錢包、禮品卡餘額、獎勵餘額,或已連結的銀行帳戶中預留。
- 具範圍控管 — 每張卡都有自己的消費上限、有效期間、鎖定日期,以及可選的單次使用旗標,讓你精準控管可被刷卡的金額與時間。
- 完整網路受理 — 以 Mastercard(簽帳金融卡或預付卡)或 Visa 軌道發行,可於線上或實體店面凡接受該網路之處使用。
卡片類型
使用
getVirtualCardOffers 列舉你的帳戶可用的所有方案,包括網路類型(Mastercard / Visa)、卡片類型(簽帳金融卡 / 預付卡)、發卡銀行,以及各方案的消費上限。
卡片生命週期
卡片會經過以下狀態: 若將卡片設定為lockCardNextUse: true,在第一次授權成功後會自動從 ACTIVE 轉為 LOCKED,不需額外的 API 呼叫。請參考 Edit Virtual Card 了解建立後如何修改此設定。
必要範圍(Scopes)
所有虛擬卡操作都需要以適當範圍產生的使用者存取權杖。三個核心範圍為:
在呼叫任何虛擬卡端點前,先以這三個範圍產生權杖:
token 以 Authorization: Bearer <token> 傳遞。當你收到 401 時,請參考 Refresh an Expired User Access Token。
資金如何運作
當卡片被扣款時,Fluz 預設依下列優先順序撥款:- 指定的消費帳戶(
userCashBalanceId) - 預付(禮品卡)餘額 — 除非設定
usePrepaymentBalance: false - 獎勵餘額 — 除非設定
useRewardsBalance: false
primaryFundingSource: BANK_ACCOUNT 設定為直接從已連結的銀行帳戶撥款。完整輸入細節與範例請見 Create Virtual Card。
消費上限期間
你所設定的spendLimit 會依選擇的 spendLimitDuration 套用:
你只會被收取實際消費金額 — 消費上限是授權上限,而非預先扣款。未使用的餘額會留在你的錢包中。
單次使用卡
在建立時將lockCardNextUse: true 設定(或透過 editVirtualCard 更新),可在首次授權後自動鎖卡。此為下列情境的建議做法:
- 一次性廠商付款
- 單筆交易的撥付
- 代理式支付流程中,卡片應於一次使用後即作廢的情境
所有虛擬卡操作
下一步
建立你的第一張虛擬卡
完整的
createVirtualCard 合約 — 輸入、資金選項、消費控管與範例。