签发虚拟卡
为已通过审核的持卡人签发虚拟卡。同步结果通常是 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 | 最近更新时间 |