签发虚拟卡

为已通过审核的持卡人签发虚拟卡。同步结果通常是 PROCESSING,最终以订单查询和 webhook 为准。

POSThttps://uqpay.zytong.cn/openapi/v1/cards/create

请求参数

参数类型必填说明
out_order_no string 是 商户订单号
cardholder_id string 是 持卡人 ID
card_product_id string 是 卡产品 ID
card_currency string 是 USD 或 SGD,须与钱包币种一致
card_limit string 否 卡限额,最多两位小数。Business Mastercard 与 Personal Visa 必填且不小于 0.01;Business Visa 可省略,省略时上游按 0 处理
spending_controls array 否 单笔限额,如 [{"amount":"200","interval":"PER_TRANSACTION"}]
risk_controls object 否 3DS 等风控参数
usage_type string 否 NORMAL 或 ONE_TIME
metadata object 否 自定义信息,最大 3200 字节

返回参数

参数类型说明
code int 0 成功,-1 失败,-2 处理中或结果未知
success boolean 是否成功
message string 结果说明。失败时为错误原因
data object 业务数据
data.out_order_no string 商户订单号
data.biz_type string 业务类型:CARD_CREATE、CARD_RECHARGE、CARD_WITHDRAW、CARD_STATUS
data.order_status string PROCESSING 处理中,SUCCESS 成功,FAILED 失败
data.fund_status string NONE 无资金变动,HELD 已预扣,CAPTURED 已确认扣款,REFUNDED 已退回,AWAITING 等待上游成功后入账,CREDITED 已计入钱包,UNKNOWN 结果未知,FAILED 失败
data.card_id string 卡片 ID。尚未生成时为空
data.card_order_id string 上游订单号
data.cardholder_id string 持卡人 ID
data.card_product_id string 卡产品 ID
data.card_currency string 卡片币种,USD 或 SGD
data.card_status string PENDING 处理中,ACTIVE 可用,FROZEN 冻结,BLOCKED 锁定,PRE_CANCEL 预注销,CANCELLED 已停用,FAILED 创建失败。尚未返回时为空
data.masked_pan string 掩码卡号,不含 CVV
data.amount string 业务金额。开卡时为卡限额,充值为充值金额,提现为提现金额
data.fee_amount string 手续费
data.debit_amount string 从客户钱包实际扣减的金额
data.error_message string 失败原因。成功时为空
data.create_time string 创建时间
data.update_time string 最近更新时间