创建虚拟卡【接口】

简要描述

创建虚拟卡

请求URL

open/api/card/create

请求方式

POST

请求参数说明

参数名必选类型长度说明
vidstring卡段id
+cardHolderobject持卡人
  └firstNamestring32持卡人姓 [a-zA-Z]32
  └lastNamestring32持卡人名 [a-zA-Z]32
depositstring24充值金额(美元), 1000代表 $10.00
orderNostring64自定义客户交易流水id 1,64
callbackUrlstring256回调地址 256
feeTypestring256月费类型 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 接口同步用户信息)。

请求示例

{ "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

标签

返回示例

{ "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 }

备注

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


Did this page help you?