Skip to main content
预发环境中使用这些优惠 ID 来签发虚拟卡。每张虚拟卡都基于一个_offer_创建,该对象决定卡计划(网络、BIN 和奖励)。下面的优惠 ID 已在预发环境启用,可直接传入 createVirtualCard
请先完成 KYC只有通过身份验证的账户才能签发虚拟卡。在账户(以及企业账户的受益所有人)通过 KYC/KYB 之前,getVirtualCardOffers 可能返回空结果,且 createVirtualCard 会失败。请在测试前先运行验证流程。参见 用户 KYC 验证 了解提交流程,并从 测试 KYC 流程 获取测试身份信息。
仅限预发这些优惠 ID 只在预发端点(https://transactional-graph.staging.fluzapp.com/api/v1/graphql)有效。在生产环境中会被拒绝,届时必须从 获取虚拟卡优惠 拉取实时优惠 ID。

预发优惠 ID

应该选择哪个优惠?

各个计划都会签发 Mastercard 预付卡,但在可用场景和资金方式上有所不同。请选择与你想要测试的行为相匹配的计划:
通用型计划——标准的多次使用预付卡,可在接受 Mastercard 的任意商户消费,受你设定的支出限额约束。如果你只是想走通端到端的“快乐路径”,从这里开始。
仅限单一商户或品牌使用的卡。在其他任何商户的交易都会被拒绝。用它来测试商户受限的支出控制——例如仅能在某个指定供应商使用的卡。
在创建时一次性注资的卡。余额预先充值后逐步消耗——之后无法再次充值。用它来测试固定面值、一次性使用的卡片流程,如单次供应商付款或发放款项。
可在创建后继续充值的卡。用它来测试长期使用、可反复补充资金的卡——如周期性补贴、团队卡或持续性的订阅支出。

推荐流程

与其硬编码一个优惠 ID,我们建议在运行时动态发现优惠——返回列表会准确反映你的账户有权使用的内容。仅需两个快速调用。
1

列出可用优惠

调用 getVirtualCardOffers,并从响应中取一个 offer_id
2

创建卡片

将该 offer_id 传给 createVirtualCard。成功响应会返回状态为 ACTIVEvirtual_card_id
spendLimit 设为不高于你的可用余额——该卡从你的 Fluz 余额中注资,因此更高的限额会因余额不足而失败。建议先做一次 5 美元的测试。首次创建卡片时你可以省略账单地址以简化“快乐路径”;稍后可通过 添加虚拟卡地址 补充。

后续步骤

创建虚拟卡

完整的 createVirtualCard 参考——入参、资金和卡片生命周期。

测试 KYC 流程

覆盖各类验证结果(通过、拒绝、重复)的测试身份。
想了解更多? 请联系 partnerships@fluz.app。与我们的专家沟通以获取更多信息或申请演示。