跳转到主要内容
createVirtualCardBulkOrder 变更允许你在一次请求中创建多个虚拟卡。
先决条件: 具有 CREATE_VIRTUALCARD 范围的用户访问令牌,以及一个 CreateVirtualCardBulkOrderInput 对象。要查找 offerId,请参见 获取虚拟卡优惠
批量订单以异步方式处理。此变更会返回一个 orderId 和初始 orderStatusPENDING —— 轮询 获取批量订单状态 以跟踪完成情况。

沙盒测试优惠

重要注意事项

  • Offer ID: offerId 会应用于该批量订单中创建的所有卡片。
  • 资金来源: 你可以使用 Fluz 余额或已关联的银行账户为你的虚拟卡提供资金。
    • 如果选择银行账户作为 primaryFundingSource,必须提供 bankAccountId
  • 消费限额: 你设置的 spendLimit 必须遵守所选 spendLimitDuration 对应项目定义的消费限额。若超出将会报错。
  • 数量: orderItems 数组中的每一项都包含 quantity,可高效创建具有相同配置的多张卡片。

参数

  • input (CreateVirtualCardBulkOrderInput!): 包含新虚拟卡批量订单详细信息的输入对象。

CreateVirtualCardBulkOrderInput 字段

CreateVirtualCardBulkOrderItemInput 字段

cURL 示例

示例变更

示例响应

响应字段

后续步骤

获取批量订单状态

轮询该 orderId 以跟踪处理进度,并在卡片签发后获取它们。