有些卡头申请开卡时,需要绑定持卡人信息,调用此接口申请持卡人。

请求URL

POST {域名}/api/vas/cardhodler/apply

请求参数

加密数据dataContent

序号 域名 变量名 必填 长度 备注
01. 持卡人名字 firstName M String(40) 持卡人名(firstName)
02. 中间名字 middleName O String(40) 持卡人名(middleName)
03. 持卡人姓 lastName M String(40) 持卡人姓名中的姓
04. 邮箱 email M String(40) 持卡人邮箱唯一,每个邮箱只可绑定一个持卡人
05. 手机号前缀 mobilePrefix M String(4) 持卡人手机对应地域的前缀(如:86),目前支持地域见附录:手机前缀
06. 手机号 mobile M String(11) (手机号前缀+手机号)唯一,每个手机号只可绑定一个持卡人
07. 出生日期 birthDate M String(10) 持卡人的出生日期,格式:yyyy-MM-dd(持卡人需满18周岁)
08. 账单国家代码 countryCode M String(3) 持卡人账单所属国家代码(如:中国,上送CNH),可见附录:国家代码
09. 账单省/州 billingState M String(50) 持卡人账单所属省/州,当国家为美国时,此字段传州的二字码(如:AR),可见附录:美国州二字码
10. 账单城市 billingCity M String(50) 持卡人账单所属城市
11. 账单地址 billingAddress M String(100) 持卡人账单地址详情
12. 账单邮编 billingZipCode M String(10) 持卡人账单地址的邮编
13. 备注 remark O String

dataContent示例

{
  "billingAddress": "Horse Material Water, Shatin",
  "billingCity": "New Territories",
  "billingState": "Hong Kong",
  "billingZipCode": "518115",
  "birthDate": "2000-01-01",
  "countryCode": "HKG",
  "email": "mucang1@baofoo.com",
  "firstName": "MUMU",
  "lastName": "ZHANG",
  "middleName": "",
  "mobile": "13000000001",
  "mobilePrefix": "86",
  "remark": ""
}

响应参数

结果信息result

序号 域名 变量名 必填 长度 备注
01. 持卡人Id cardUserId M String 持卡人唯一标识id

result示例

{
    "cardUserId":"2408142012000000458"
}