# 32.实体卡添加卡片接口

## 基本信息

* 接口类型：HTTPS POST
* 编码格式：UTF-8
* 测试地址：/api/v1.0/card/bind
* 生产接口：/api/v1.0/card/bind
* 同异步标识：异步

## 请求参数

| 名字          | 字段描述    | 字段类型    | 是否必填 | 备注                                       |
| ----------- | ------- | ------- | ---- | ---------------------------------------- |
| requestNo   | 请求流水号   | String  | Y    | 请求流水号                                    |
| activeCode  | 激活码     | ​String | N    | cardBin为other时,此字段必填                     |
| cardAlias   | 卡别名     | ​String | N    |                                          |
| cardBin     | cardBin | String  | Y    | 请联系客户经理                                  |
| cardCvv     | 卡片CVV   | String  | N    | 卡片CVV                                    |
| cardNo      | 卡号      | String  | Y    | 当cardBin字段传"other"时, cardNo只需要传卡号后6位数字即可 |
| countryCode | 国家地区码   | String  | N    | 2位                                       |
| email       | 邮箱      | String  | N    | 建议传客户的邮箱, 不然展示的会是默认邮箱                    |
| operator    | 操作人     | String  | N    |                                          |
| phoneCode   | 手机号区号   | String  | N    |                                          |
| phoneNumber | 手机号     | String  | N    |                                          |
| pinCode     | PIN码    | String  | N    | 实体卡卡密码,4位数字,第一次激活卡片时必填                   |

## 请求示例

```json
{
    "custNo": "1586....2992",
    "request": {
        "requestNo": "805968....135",
        "activeCode": "",
        "cardAlias": "",
        "cardBin": "123456",
        "cardCvv": "123",
        "cardNo": "5395.....89",
        "countryCode": "",
        "email": "demo@demo.com",
        "operator": "",
        "phoneCode": "",
        "phoneNumber": "",
        "pinCode": "1525"
    },
    "verify": "dca18f7a9ac3d80.....a6f8327d3ecdb33cb0b6c97edd84"
}
```

## 待签名字符串

```
"requestNo=" + requestNo + "&cardNo=" + cardNo + "&cardBin=" + cardBin
```

## 响应结果

| 字段名称   | 字段描述 | 字段类型   | 备注 |
| ------ | ---- | ------ | -- |
| result | 加密数据 | String |    |

## 响应实例

```json
{
    "success": true,
    "result": "4d3ebe417ed61....1a45c25af09b523efcd....f0de3b",
    "errorCode": null,
    "errorMsg": null
}
```