什么是 Fluz 虚拟卡?
Fluz 的 预充值虚拟卡 是完全存在于软件中的网络品牌、即时发行的卡。不同于实体卡:- 无塑料、无邮寄 —— 一旦
createVirtualCard返回,卡片立刻可用。 - 预充值 —— 消费限额在创建时从 Fluz 钱包、礼品卡余额、奖励余额,或关联的银行账户中预留。
- 范围限定 —— 每张卡都有独立的消费限额、有效期、锁定日期以及可选的单次使用标记,你可以精确控制可被扣款的金额与时长。
- 完整的网络受理 —— 通过 Mastercard(借记或预付)或 Visa 网络发行,可在这些网络被线上或线下接受的任何地方使用。
卡片类型
使用
getVirtualCardOffers 列举你账户可用的所有计划,包括网络类型(Mastercard / Visa)、卡片类型(借记 / 预付)、发卡银行,以及每个计划的消费限额。
卡片生命周期
一张卡会经历以下状态: 设置了lockCardNextUse: true 的卡,在首次授权成功后会自动从 ACTIVE 转换为 LOCKED —— 无需额外的 API 调用。参见 编辑虚拟卡 了解如何在创建后修改该设置。
必需的范围(Scopes)
所有虚拟卡操作都需要使用带有相应范围的用户访问令牌。三个核心范围为:
在调用任何虚拟卡端点前,生成包含这三个范围的令牌:
token 以 Authorization: Bearer <token> 添加到所有后续调用。收到 401 时参见 刷新已过期的用户访问令牌。
资金如何运作
当卡被扣款时,Fluz 默认按以下优先级划拨资金:- 指定的消费账户(
userCashBalanceId) - 预付(礼品卡)余额 —— 除非设置了
usePrepaymentBalance: false - 奖励余额 —— 除非设置了
useRewardsBalance: false
primaryFundingSource: BANK_ACCOUNT,直接从关联银行账户扣款。完整的输入细节和示例参见 创建虚拟卡。
消费限额周期
你设置的spendLimit 将依据所选的 spendLimitDuration 生效:
你只会为实际消费的金额付费——消费限额是授权上限,而非预先扣款。未使用的余额保留在你的钱包中。
单次使用卡
在创建时设置lockCardNextUse: true(或通过 editVirtualCard 更新)可在首次授权后自动锁定该卡。建议在以下场景使用:
- 一次性供应商付款
- 单笔交易发放
- 需要在一次使用后即作废的智能代理支付流程
全部虚拟卡操作
下一步
创建你的第一张虚拟卡
完整的
createVirtualCard 合同——输入、资金选项、消费控制与示例。