createVirtualCardBulkOrder 变更允许你在一次请求中创建多个虚拟卡。
先决条件: 具有
CREATE_VIRTUALCARD 范围的用户访问令牌,以及一个 CreateVirtualCardBulkOrderInput 对象。要查找 offerId,请参见 获取虚拟卡优惠。批量订单以异步方式处理。此变更会返回一个
orderId 和初始 orderStatus 为 PENDING —— 轮询 获取批量订单状态 以跟踪完成情况。沙盒测试优惠
重要注意事项
- Offer ID:
offerId会应用于该批量订单中创建的所有卡片。 - 资金来源: 你可以使用 Fluz 余额或已关联的银行账户为你的虚拟卡提供资金。
- 如果选择银行账户作为
primaryFundingSource,必须提供bankAccountId。
- 如果选择银行账户作为
- 消费限额: 你设置的
spendLimit必须遵守所选spendLimitDuration对应项目定义的消费限额。若超出将会报错。 - 数量:
orderItems数组中的每一项都包含quantity,可高效创建具有相同配置的多张卡片。
参数
input(CreateVirtualCardBulkOrderInput!): 包含新虚拟卡批量订单详细信息的输入对象。
CreateVirtualCardBulkOrderInput 字段
CreateVirtualCardBulkOrderItemInput 字段
cURL 示例
示例变更
示例响应
响应字段
后续步骤
获取批量订单状态
轮询该
orderId 以跟踪处理进度,并在卡片签发后获取它们。