卡片生命周期
概述
Qbit平台提供多种应用程序接口，用于管理卡片的整个生命周期。下图概述了卡片流程的各个阶段以及与每个阶段相关的应用程序接口。
添加一张新卡
获取可用卡bin
调用接口列出当前可用卡BIN获取当前可使用的卡bin。
- 字段解释请查看文档的返回内容说明。
- 优选卡为动态更新的非固定卡bin，存在不定期的卡bin上下线情况，因此建议开卡前或每日定时调用一次接口同步可用卡bin的信息，避免开卡时因卡bin不可用导致开卡失败。
开卡前检查
调用接口检查开卡参数做开卡参数的初步校验，根据接口返回内容做参数的相应更改，返回空值即可进行开卡操作。
- 请详细查看每个字段的说明。
- 额度卡须首先创建预算，在此步骤时传入对应budgetId，且无需设置初始余额cost；储值卡可直接进行此步骤，设置对应初始余额cost。
- 开卡费不包含在cost中，储值卡开卡费从量子账户中扣除，额度卡开卡费从对应预算中扣除。
- 优选卡有地址校验仅可使用美国地址开卡，地址可为虚拟地址，手机号建议使用真实号码，不建议所有卡片都使用同一地址开卡，会有风控上的风险。
- 493193、414631、493728对非大陆手机号有强校验。
- useType字段具体填什么值取决于用户是否需要对这张卡做特殊的分类备注，例如主要消费场景或使用人群，目前对于此字段若没有特殊需要，可统一传值为“默认/default”。
创建量子卡
检查接口返回无错误信息，调用接口创建量子卡执行开卡操作，返回为true即可查询卡片是否创建成功，也可查看webhook回调通知。
- 开卡接口不返回卡片具体信息如cardId、CVV等，卡id可查看回调通知，CVV信息须调接口查询。
查询量子卡
开卡时在label字段传入用户自己系统中卡片的uuid做对应，开卡后调用列出所有量子卡V2、列出所有量子卡查询接口传入label查询，单张卡片的详细信息（包括卡片地址、余额、交易及费用统计等）可通过接口Get a card传入参数cardId查询。
删除量子卡
接口删除量子卡传入cardId可进行卡片的删除操作。
- 卡片状态变更会收到状态变更回调通知。
- 删卡会同时产生卡片的一条转出交易、一条量子账户的转入交易，即删除的卡片余额会退回至量子账户。
冻结&解冻量子卡
卡
基于卡片本身状态的操作。接口冻结量子卡和解冻量子卡可以操作量子卡的冻结和解冻状态。
- 已冻结的卡片不会产生新的已授权交易，但已授权的处理中订单会继续清算直至完结，因此已授权订单相关联的退款、撤销、订单修正不会受卡片状态影响。
- 卡片状态变更会收到状态变更回调通知。
卡余额
Updated 8 days ago