createVirtualCard。
仅限预发这些优惠 ID 只在预发端点(
https://transactional-graph.staging.fluzapp.com/api/v1/graphql)有效。在生产环境中会被拒绝,届时必须从 获取虚拟卡优惠 拉取实时优惠 ID。预发优惠 ID
应该选择哪个优惠?
各个计划都会签发 Mastercard 预付卡,但在可用场景和资金方式上有所不同。请选择与你想要测试的行为相匹配的计划:Virtual Card
Virtual Card
通用型计划——标准的多次使用预付卡,可在接受 Mastercard 的任意商户消费,受你设定的支出限额约束。如果你只是想走通端到端的“快乐路径”,从这里开始。
Brand Locked Virtual Card
Brand Locked Virtual Card
仅限单一商户或品牌使用的卡。在其他任何商户的交易都会被拒绝。用它来测试商户受限的支出控制——例如仅能在某个指定供应商使用的卡。
Single Load Virtual Card
Single Load Virtual Card
在创建时一次性注资的卡。余额预先充值后逐步消耗——之后无法再次充值。用它来测试固定面值、一次性使用的卡片流程,如单次供应商付款或发放款项。
Reloadable Virtual Card
Reloadable Virtual Card
可在创建后继续充值的卡。用它来测试长期使用、可反复补充资金的卡——如周期性补贴、团队卡或持续性的订阅支出。
推荐流程
与其硬编码一个优惠 ID,我们建议在运行时动态发现优惠——返回列表会准确反映你的账户有权使用的内容。仅需两个快速调用。1
列出可用优惠
调用
getVirtualCardOffers,并从响应中取一个 offer_id。2
创建卡片
将该
offer_id 传给 createVirtualCard。成功响应会返回状态为 ACTIVE 的 virtual_card_id。后续步骤
创建虚拟卡
完整的
createVirtualCard 参考——入参、资金和卡片生命周期。测试 KYC 流程
覆盖各类验证结果(通过、拒绝、重复)的测试身份。