# 21.持卡人信息申请（暂停）

## URL

/api/v1.0/holder/apply

## **请求参数**

<table><thead><tr><th width="160">字段</th><th width="120">字段描述</th><th width="100">字段类型</th><th width="78">必填/可选</th><th>备注</th></tr></thead><tbody><tr><td>firstName</td><td>持卡人名字</td><td>String</td><td>必填</td><td></td></tr><tr><td>middleName</td><td>中间名字</td><td>String</td><td></td><td></td></tr><tr><td>lastName</td><td>持卡人姓</td><td>String</td><td>必填</td><td></td></tr><tr><td>email</td><td>邮箱</td><td>String</td><td>必填</td><td></td></tr><tr><td>mobilePrefix</td><td>手机区号</td><td>String</td><td>必填</td><td>见<a href="../fu-lu/shou-ji-qu-hao"> 附录-手机区号</a></td></tr><tr><td>mobile</td><td>手机号</td><td>String</td><td>必填</td><td></td></tr><tr><td>birthDate</td><td>生日</td><td>String</td><td>必填</td><td>格式： yyyy-MM-dd</td></tr><tr><td>countryCode</td><td>国家代码</td><td>String</td><td>可选</td><td>428卡头用美国地址，<a href="../fu-lu/guo-jia-dai-ma">附录- 国家代码</a></td></tr><tr><td>billingState</td><td>账单省/州</td><td>String</td><td>可选</td><td>如果客户选择了美国，则必须传州2位简称才能过场景验证，<a href="../fu-lu/zhou-dai-ma-mei-guo">附录- 州（美国）</a></td></tr><tr><td>billingCity</td><td>账单城市</td><td>String</td><td>可选</td><td>某些场景有AVS校验，则建议设置完整的账单地址</td></tr><tr><td>billingAddress</td><td>账单地址</td><td>String</td><td>可选</td><td>某些场景有AVS校验，则建议设置完整的账单地址</td></tr><tr><td>billingZipCode</td><td>账单邮编</td><td>String</td><td>可选</td><td>某些场景有AVS校验，则建议设置完整的账单地址</td></tr><tr><td>remark</td><td>备注</td><td>String</td><td>/</td><td></td></tr></tbody></table>

## **请求示例**

```
{
  "custNo": "158519...017664",
  "request": {
    "firstName": "zhang",
    "middleName": "san",
    "lastName": "feng",
    "email": "email@google.com",
    "mobilePrefix": "86",
    "mobile": "18888888888",
    "birthDate": "2010-10-25",
    "countryCode": "xxxxxx",
    "billingState": "billing state",
    "billingCity": "HongKong",
    "billingAddress": "your billing address",
    "billingZipCode": "your billing zip code",
    "remark": "you holder remark"
  },
  "verify": "234rfre43...u763ewdft"
}
```

## **待签名字符串**

```
"email="+email+"&mobilePrefix="+mobilePrefix+"&mobile="+mobile+"&birthDate="+birthDate
```

## **响应结果**

<table><thead><tr><th width="142">字段</th><th width="120">字段描述</th><th width="100">字段类型</th><th width="78">必填</th><th>备注</th></tr></thead><tbody><tr><td>cardUserId</td><td>持卡人ID</td><td>String</td><td>必填</td><td>持卡人ID</td></tr></tbody></table>

## **响应示例**

```
{
  "errorCode": null,
  "errorMsg": null,
  "result": "dafsdjfnh239u4....odnfb2i3ope",
  "success": true
}
```

## result 解密后格式

```
"2342......231231"
```