什么是 Fluz 虚拟卡？
Fluz 的预充值虚拟卡是一种带网络品牌、即时发行、完全存在于软件中的卡。不同于实体卡：- 无塑料、无邮寄 —— 当
createVirtualCard完成时，卡片即可使用。 - 预充值 —— 消费上限在创建时从 Fluz 钱包、礼品卡余额、奖励余额或绑定银行账户中预留。
- 有范围控制 —— 每张卡都有独立的消费上限、有效期、锁定日期，以及可选的单次使用标记，因此你可以精确控制可被扣款的金额和时长。
- 全网络受理 —— 在 Mastercard（借记或预付）或 Visa 网络上发行，可在这些网络在线或线下受理的任何地方使用。
卡片类型
使用
getVirtualCardOffers 列举与你账户相关的所有可用计划，包括网络类型（Mastercard / Visa）、卡类型（借记 / 预付）、发卡银行以及每个计划的消费上限。
卡片生命周期
卡片按以下状态流转： 当卡片设置了lockCardNextUse: true，在首次授权成功后会自动从 ACTIVE 转为 LOCKED —— 无需额外 API 调用。参见编辑虚拟卡以了解如何在创建后修改此设置。
LOCKED 并不是 status 的取值：被锁定的卡仍会返回 status: ACTIVE。从获取虚拟卡余额的 locked 字段读取卡片是否可消费。
所需 Scopes
所有虚拟卡操作都需要使用带相应 scope 生成的用户访问令牌。三个核心 scope 为：
在调用任一虚拟卡端点前，生成包含三个 scope 的令牌：
token 作为 Authorization: Bearer <token> 传递。当你收到 401 时，参见刷新过期的用户访问令牌。
展示卡片详情
将卡片的 PAN、有效期和 CVV 呈现给用户有两种方式，它们在合规要求上差异很大。
当你确实需要在服务端获取卡号（例如转交给另一个处理方）时，选择 API mutation。如果只是让用户在屏幕上读取，使用安全元素是更省事的路径。
资金如何扣取
当卡片被扣款时，Fluz 默认按以下优先级扣取资金：- 指定的消费账户（
userCashBalanceId） - 预付（礼品卡）余额 —— 除非设置
usePrepaymentBalance: false - 奖励余额 —— 除非设置
useRewardsBalance: false
primaryFundingSource: BANK_ACCOUNT，直接从绑定银行账户扣款。完整的输入细节与示例请见创建虚拟卡。
消费上限周期
你设置的spendLimit 将按选择的 spendLimitDuration 生效：
你只会为实际消费金额付费——消费上限是授权上限，而非预扣款。未使用的余额保留在你的钱包中。
单次使用卡
在创建时设置lockCardNextUse: true（或通过 editVirtualCard 更新），可在首次授权后自动锁卡。推荐用于：
- 一次性供应商付款
- 单笔交易拨付
- 需要在一次使用后即作废的智能代理支付流程
全部虚拟卡操作
后续步骤
创建你的第一张虚拟卡
完整的
createVirtualCard 合同——输入、资金选项、消费控制与示例。