跳转到主要内容
预充值虚拟卡 是通过 Fluz API 即时发行的网络品牌(Visa / Mastercard)卡。它在所有接受该网络的商户处都可获得返现,并且可以在 400+ 个品牌叠加礼品卡路由以获取更高回报。

什么是 Fluz 虚拟卡?

Fluz 的 预充值虚拟卡 是完全存在于软件中的网络品牌、即时发行的卡。不同于实体卡:
  • 无塑料、无邮寄 —— 一旦 createVirtualCard 返回,卡片立刻可用。
  • 预充值 —— 消费限额在创建时从 Fluz 钱包、礼品卡余额、奖励余额,或关联的银行账户中预留。
  • 范围限定 —— 每张卡都有独立的消费限额、有效期、锁定日期以及可选的单次使用标记,你可以精确控制可被扣款的金额与时长。
  • 完整的网络受理 —— 通过 Mastercard(借记或预付)或 Visa 网络发行,可在这些网络被线上或线下接受的任何地方使用。
卡片通过交换费经济在所有消费上获得基础返现。在支持的商户处,卡片关联优惠可叠加额外回报。

卡片类型

使用 getVirtualCardOffers 列举你账户可用的所有计划,包括网络类型(Mastercard / Visa)、卡片类型(借记 / 预付)、发卡银行,以及每个计划的消费限额。

卡片生命周期

一张卡会经历以下状态: 设置了 lockCardNextUse: true 的卡,在首次授权成功后会自动从 ACTIVE 转换为 LOCKED —— 无需额外的 API 调用。参见 编辑虚拟卡 了解如何在创建后修改该设置。

必需的范围(Scopes)

所有虚拟卡操作都需要使用带有相应范围的用户访问令牌。三个核心范围为: 在调用任何虚拟卡端点前,生成包含这三个范围的令牌:
将返回的 tokenAuthorization: Bearer <token> 添加到所有后续调用。收到 401 时参见 刷新已过期的用户访问令牌

资金如何运作

当卡被扣款时,Fluz 默认按以下优先级划拨资金:
  1. 指定的消费账户userCashBalanceId
  2. 预付(礼品卡)余额 —— 除非设置了 usePrepaymentBalance: false
  3. 奖励余额 —— 除非设置了 useRewardsBalance: false
你也可以通过设置 primaryFundingSource: BANK_ACCOUNT,直接从关联银行账户扣款。完整的输入细节和示例参见 创建虚拟卡

消费限额周期

你设置的 spendLimit 将依据所选的 spendLimitDuration 生效: 只会为实际消费的金额付费——消费限额是授权上限,而非预先扣款。未使用的余额保留在你的钱包中。

单次使用卡

在创建时设置 lockCardNextUse: true(或通过 editVirtualCard 更新)可在首次授权后自动锁定该卡。建议在以下场景使用:
  • 一次性供应商付款
  • 单笔交易发放
  • 需要在一次使用后即作废的智能代理支付流程

全部虚拟卡操作

下一步

创建你的第一张虚拟卡

完整的 createVirtualCard 合同——输入、资金选项、消费控制与示例。