创建虚拟卡【接口】

简要描述

创建虚拟卡

请求URL

open/api/card/create

请求方式

POST

请求参数说明

参数名	必选	类型	长度	说明
vid	是	string		卡段id
+cardHolder	否	object		持卡人
└firstName	是	string	32	持卡人姓 [a-zA-Z]{1,32}
└lastName	是	string	32	持卡人名 [a-zA-Z]{1,32}
deposit	是	string	24	充值金额（美元）, 1000代表 $10.00
orderNo	是	string	64	自定义客户交易流水id {1，64}
callbackUrl	是	string	256	回调地址 {1,256}
feeType	是	string	256	月费类型 {ONE,TWO,THREE}

🚧

注意事项

• deposit 为虚拟卡充值(初始存款)金额，1 代表 1 美分，即 1000 代表 $10.00，本系统中所有金额(例如balance, consume)都采用此规则
• 单笔充值金额范围：5 USD - 5000 USD
• vid 为卡段id, 通过获取卡段列表查询您可使用的卡段
• 为改进用户体验，创建虚拟卡为异步操作，创建虚拟卡后，通常卡会经过 【开卡中 -> 创建持卡人 -> 创建虚拟卡 -> 激活卡片 -> 已激活
• 单笔充值金额 >1000 USD，会核验该用户邮箱账户是否已完成 KYC，若未完成，则返回错误。商户可调用 ACH KYC 接口完成用户 KYC 认证（如果用户已通过其它平台完成 KYC 认证，则商户可通过共享 KYC 接口同步用户信息）。

请求示例

JSON

{
    "cardHolder": {
        "firstName": "Milton",
        "lastName": "Schmitt"
    },
    "deposit": "1000",
    "vid": "vab_069af8a792ad",
    "orderNo": "v_5bc814",
    "callbackUrl": "https://www.baidu.com",
}

返回参数说明

参数名	类型	说明
success	boolean	成功标志
error	boolean	失败标志
msg	string	返回处理消息
code	integer	返回代码
+model	object	返回数据对象 data
+cardHolder	object	持卡人信息
└firstName	string	持卡人姓
└lastName	string	持卡人名
└street	string	街道
└city	string	城市
└state	string	州
└country	string	国家
└zipCode	string	邮编
+card	object	卡信息
└userId	string	用户ID
└cardHolderId	string	持卡人ID
└cardId	string	卡ID
└customerId	string	自定义客户id
└cardSeqNo	string	卡序列号
└deposit	integer	存款, 1000代表 $10.00
└consume	integer	消费, 1000代表 $10.00
└balance	integer	余额, 1000代表 $10.00
└cvc	string	cvc 虚拟卡校验码，在VISA卡中也称为cvv
└number	string	卡号
└cardBin	string	卡段(卡号前6位)
└last4	string	后四位
└status	string	INIT :开卡中 INIT_CREATE_CARD:创建虚拟卡 INIT_CREATE_CARD_HOLDER:创建持卡人 INIT_ACTIVE_CARD:激活卡片 CREATE_CARD_FAILED_REFUND:创建卡失败全额退款 ACTIVE :已激活 FREEZE:已冻结 CANCELLING:删卡中 CANCELED :已删除 DELETED :永久删除 EXPIRED :已过期
└expYear	integer	卡过期年
└expMonth	integer	卡过期月
└gmtCreate	string	开卡时间
└tags	array	卡标签列表
└	string	标签

返回示例

JSON

{
    "success": true,
    "error":false,
    "msg": "成功",
    "code": 0,
    "model": {
        "cardHolder": {
            "firstName": "Milton",
            "lastName": "Schmitt",
             "street": "1010 Pine St LOT 12-E",
             "city": "Vienna",
              "state": "GA",
              "country": "US",
              "zipCode": "31092"

        },
        "card": {
            "userId": "u_xxxxxxxx",
            "customerId" : "user_id_123",
            "cardHolderId": "ch_xxxxxxxxx",
            "holderName": "Milton Schmitt",
            "cardId": "c_xxxxxxxxx",
            "cardSeqNo": "CXXXXXXXX",
            "deposit": 1000,
            "consume": 0,
            "balance": 1000,
            "cvc": "-",
            "number": "-",
            "cardBin": "-",
            "last4": "-",
            "status": "INIT",
            "expYear": 0,
            "expMonth": 0,
            "gmtCreate": null
        },
        "tags": [
            "test"
        ]
    },
    "traceId": 1646648711017
}

备注

更多返回错误代码请看首页的错误代码描述