有些卡头申请开卡时,需要绑定持卡人信息,调用此接口申请持卡人。
请求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. | 邮箱 | 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"
}