Skip to main content
本快速入门在一次请求中发行 100 张虚拟卡。你将下达一个异步批量订单，在创建卡片的同时轮询其状态，并获取完整卡片详情——无论是发行 10 张还是 10,000 张，模式都相同。
先决条件
  • 一个带有预发环境应用的 Fluz 账户——任一快速入门的步骤 1–2，或参见准备你的账户和API 凭证。
  • 具有 CREATE_VIRTUALCARD 权限范围的令牌。
  • 有足够的可用余额覆盖订单——100 张卡 × 你设置的消费限额。每个变更都需要唯一的 idempotencyKey——见幂等性。

​
全流程

下达批量订单

一次 createVirtualCardBulkOrder 调用可创建全部 100 张卡。orderItems 中的每一项都是带有 quantity 的卡片配置——此处为 100 张相同的单次使用拨款卡：
offerId 适用于订单中的每一张卡；如需混合配置，可添加更多 orderItems 条目（例如 20 张×25的单次使用+80张×25 的单次使用 + 80 张×100 的按月）。lockCardNextUse: true 使每张卡在首次扣款后自毁——这是标准的拨款模式。
批量订单是异步的——响应返回的是 orderId 和 PENDING，而不是卡片本身。请保存 orderId；这是后续所有操作的句柄。

轮询至订单完成

使用 getVirtualCardBulkOrderStatus 跟踪进度。订单为 PENDING 时，卡片会逐步生成：
采用带退避的轮询，直到 orderStatus 为 COMPLETED（或 FAILED）——在等待期间，successfulCardCreations 会逐步接近 totalCards，且 virtualCards 不断填充。
响应包含完整 PAN、CVV 和到期日的明文。将其视为敏感持卡人数据：仅通过 TLS 传输，切勿记录日志，仅向授权用户展示。

处理部分失败

批量订单可能部分成功：在已完成的订单中，successfulCardCreations: 98, failedCardCreations: 2 表示 98 张真实可用的卡和 2 张需要重试。通过将这些计数与 totalCards 比较进行对账，然后仅重新发行缺口部分——因为是新订单，所以使用新的 idempotencyKey：
持续失败通常与项目限额或资金相关——请检查虚拟卡错误代码以及你的可用余额。

​
大功告成 🎉

一次请求获取一百张已配置的卡，配合可直接用于生产的轮询循环。接下来：

获取虚拟卡交易

监控整批的消费——每次查询最多 10 张卡，或按日期覆盖整个账户。

将卡片发送给收件人

要分发给组织外的人员？托管领取链接可为你处理引导流程。
想了解更多？ 通过 support@fluz.app 联系我们，与专家交流或申请演示。