什麼是 Fluz 虛擬卡？
Fluz 的 預儲值虛擬卡 是一張完全存在於軟體中的、具網路品牌且可即時核發的卡。與實體卡不同之處：- 無塑膠卡、無運送 — 一旦
createVirtualCard完成，卡片立即可用。 - 預先儲值 — 消費上限會在建立時，從 Fluz 錢包、禮品卡餘額、獎勵餘額，或已連結的銀行帳戶中預留。
- 具範疇控管 — 每張卡都有自己的消費上限、有效期間、鎖定日期以及可選的單次使用旗標，因此你可以精準掌控可被扣款的金額與期間。
- 完整網路受理 — 以 Mastercard（借記或預付）或 Visa 軌道發卡，可於線上或實體門市中任何接受這些網路的地方使用。
卡片類型
使用
getVirtualCardOffers 列出你的帳戶可用的所有方案，包括網路類型（Mastercard / Visa）、卡片類型（借記 / 預付）、發卡銀行，以及每個方案的消費上限。
卡片生命週期
卡片會經過以下狀態： 若在設定中啟用lockCardNextUse: true，卡片在首次授權成功後會自動從 ACTIVE 轉為 LOCKED——無需額外的 API 呼叫。參見編輯虛擬卡以了解如何在建立後修改此設定。
LOCKED 並非 status 的一個值：被鎖定的卡仍會回報 status: ACTIVE。請從取得虛擬卡餘額的回應中讀取 locked 以判斷卡片是否可消費。
必要 Scopes
所有虛擬卡操作都需要以合適 scopes 產生的使用者存取權杖。三個核心 scopes 為：
在呼叫任何虛擬卡端點前，先以三個 scopes 產生權杖：
Authorization: Bearer <token> 傳送回傳的 token。當你收到 401 時，請參見更新已過期的使用者存取權杖。
顯示卡片詳情
有兩種方式將卡號（PAN）、到期日與 CVV 呈現給使用者，而且它們的合規要求差異很大。
當你確實需要在伺服器端取得卡號（例如要推送到另一家處理方）時，請選擇 API mutation。若是要讓人員在螢幕上閱讀，使用 Secure Elements 會更省事。
資金運作方式
當卡片被扣款時，Fluz 預設依下列優先順序撥款：- 指定的消費帳戶（
userCashBalanceId） - 預付（禮品卡）餘額 — 除非設定
usePrepaymentBalance: false - 獎勵餘額 — 除非設定
useRewardsBalance: false
primaryFundingSource: BANK_ACCOUNT。完整的輸入細節與範例請見建立虛擬卡。
消費上限期間
你設定的spendLimit 會依所選的 spendLimitDuration 生效：
你只會為實際消費的金額付費——消費上限是授權上限，並非預先扣款。未使用的餘額會留在你的錢包中。
單次使用卡
在建立時設定lockCardNextUse: true（或稍後透過 editVirtualCard 更新）可在首次授權後自動鎖卡。此作法建議用於：
- 一次性供應商付款
- 單筆交易的撥款
- 代理式付款流程中需要於一次使用後即被耗用的卡片
所有虛擬卡操作
下一步
建立你的第一張虛擬卡
完整的
createVirtualCard 契約——輸入欄位、資金選項、消費控管與範例。