Skip to main content
在測試環境中使用這些優惠 ID 來簽發虛擬卡。每張虛擬卡皆對應一個_offer_，其決定卡片計畫（網路、BIN 與回饋）。下列優惠 ID 已在測試環境啟用，可直接傳給 createVirtualCard。
請先完成 KYC只有完成身分驗證的帳戶才能簽發虛擬卡。在帳戶 — 若為企業則包含其實益擁有人 — 通過 KYC/KYB 之前，getVirtualCardOffers 可能會回傳空結果，而 createVirtualCard 也會失敗。請先執行驗證再進行測試。參見使用者 KYC 驗證以了解如何提交，並從測試 KYC 流程擷取測試身分資料。
僅限測試環境這些優惠 ID 只接受於測試端點（https://transactional-graph.staging.fluzapp.com/api/v1/graphql）。在正式環境會被拒絕，屆時你必須從取得虛擬卡優惠檢索正式的優惠 ID。

​
測試環境的優惠 ID

​
應該選哪個優惠？

每個計畫都會簽發 Mastercard 預付卡，但它們在可消費場所與資金補充方式上有所不同。選擇符合你想測試行為的選項：
通用型計畫——標準的多次使用預付卡，可在接受 Mastercard 的任何地方消費，受你設定的消費上限限制。若你想從頭到尾跑一遍順利路徑，從這裡開始。
僅限單一商家或品牌使用的卡片。在其他任何商家的交易都會被拒絕。用於測試商家限制的消費控管——例如只允許在某一個供應商使用的卡片。
在建立時一次性加值的卡片。餘額會先行加值並逐步消耗——之後無法再儲值。用於測試固定面額、一次性使用的卡片流程，如單次供應商付款或撥款。
可在建立後再次加值的卡片。用於測試長期使用、可反覆補款的卡片——例如定期補助、團隊卡，或持續性的訂閱支出。

​
建議流程

我們建議在執行時動態探索優惠，而非硬編碼優惠 ID——回傳的清單會精準反映你的帳戶可用的項目。這是個快速的兩步驟流程。
1

列出可用優惠

呼叫 getVirtualCardOffers 並從回應中擷取一個 offer_id。
2

建立卡片

將該 offer_id 傳給 createVirtualCard。成功回應會回傳狀態為 ACTIVE 的 virtual_card_id。
將 spendLimit 設為不超過你可用餘額——卡片資金來自你的 Fluz 餘額，若上限較高會因餘額不足而失敗。建議先以 5 美元進行測試最安全。你可以在第一張卡片省略帳單地址，讓順利路徑更簡單；之後再透過新增虛擬卡地址補上。

​
下一步

建立虛擬卡

完整的 createVirtualCard 參考——輸入參數、資金與卡片生命週期。

測試 KYC 流程

可回傳各種驗證結果的測試身分——核准、拒絕與重複。
想了解更多？ 請聯絡 partnerships@fluz.app。與我們的專家交流以取得更多資訊或申請示範。