# 2.3 绑卡
# 2.3.1 绑卡申请
# 接口说明：
- 接口由宜信提供，合作方调用。合作方渠道传递用户四要素交由宜信鉴权通道进行绑卡，宜信向用户发送绑卡鉴权短信验证码。 目前支持6位验证码。
# 接口地址：
card.bind
# 请求参数：
| 参数 | 类型 | 是否必传 | 说明 | 备注 |
|---|---|---|---|---|
| openId | String | 是 | 用户ID | |
| transNo | String | 是 | 绑卡流水号 | 响应参数中 status=1 即绑卡失败时会重新生成流水号 |
| cardNo | String | 是 | 绑卡卡号 | |
| cardType | Integer | 是 | 卡类型 | 1: 借记卡 2: 信用卡 目前只支持借记卡 |
| bankCode | String | 是 | 银行卡开户行代码 | 银行代码，见枚举项 |
| userName | String | 是 | 用户姓名 | 广告主方应当校验用户两要素是否与注册时相同，保证用户绑的是本人的卡 |
| idCard | String | 是 | 用户身份证号 | |
| phone | String | 是 | 手机号 | 银行卡预留手机号 |
| bizType | String | 是 | 场景类型 | 借款:loan 还款:repay |
| bizNo | String | 否 | 业务流水号 | 根据bizType传对应的业务单号，如借款单号；bizType为repay（还款）必填 |
# 响应参数：
| 参数 | 类型 | 是否必传 | 说明 | 备注 |
|---|---|---|---|---|
| bindCardId | String | 是 | 绑卡id | 返回可唯一标识卡数据的字段，如表的主键，便于与绑卡短信验证接口及后续相关接口关联 |
| status | String | 是 | 绑卡状态码 | 如：0000 |
| desc | String | 否 | 绑卡信息 | 错误描述，如：绑卡成功 可透传真实错误信息或转为用户友好的信息，根据业务需求决定 |
# status枚举
| status | desc |
|---|---|
| 0000 | 绑卡成功（针对卡已绑定的情况） |
| 0002 | 发送验证码成功 |
| 9999 | 其他 |
# 2.3.2 绑卡短信验证
# 接口说明：
- 接口由宜信提供，合作方调用。合作方通知宜信校验用户填写的绑卡鉴权短信验证码。
# 接口地址：
card.verify
# 请求参数：
| 参数 | 类型 | 是否必传 | 说明 | 备注 |
|---|---|---|---|---|
| openId | String | 是 | 用户ID | |
| bindCardId | String | 是 | 绑卡id | 绑卡申请响应参数 |
| verifyCode | String | 是 | 短信验证码 | 目前支持6位验证码 |
| bizType | String | 是 | 场景类型 | 借款:loan 还款:repay |
| bizNo | String | 否 | 业务流水号 | 根据bizType传对应的业务单号，如借款单号；bizType为repay（还款）必填 |
# 响应参数：
| 参数 | 类型 | 是否必传 | 说明 | 备注 |
|---|---|---|---|---|
| status | String | 是 | 状态 | 如：0002 |
| desc | String | 否 | 错误描述 | 如：验证码错误 |
# status枚举
| status | desc |
|---|---|
| 0000 | 绑卡成功 |
| 1000 | 发送下一条验证码 （若需要多次绑卡，宜信在合作方调用此接口时自行发送验证码，返回此状态，合作方会再次调用此接口，直到返回终态（成功或失败等）） |
| 9999 | 其他 |
# 2.3.3 查询支持银行列表
# 接口说明：
- 接口由宜信提供，合作方调用。合作方查询用户在宜信所支持的银行；
# 接口地址：
bank.list
# 请求参数：
| 参数 | 类型 | 是否必传 | 说明 | 备注 |
|---|---|---|---|---|
| openId | String | 是 | 用户ID | |
| bizType | String | 是 | 场景类型 | 借款:loan 还款:repay |
| bizNo | String | 否 | 业务流水号 | 根据bizType传对应的业务单号，如借款单号；bizType为repay（还款）必填 |
# 响应参数
| 参数 | 类型 | 是否必传 | 说明 | 备注 |
|---|---|---|---|---|
| bankList | List | 是 | 银行列表 | 广告主方支持的银行列表 |
bankList:
| 参数 | 类型 | 是否必传 | 说明 | 备注 |
|---|---|---|---|---|
| bankName | String | 是 | 银行名称 | 见枚举项 |
| bankCode | String | 是 | 银行代码 | 见枚举项 |
| timesLimit | Long | 是 | 单笔限额 | 单位：分 |
| dayLimit | Long | 是 | 单日限额 | 单位：分 |
# 2.3.4 用户绑卡列表
# 接口说明：
- 接口由宜信提供，合作方调用。合作方查询用户在宜信绑定的银行卡列表；
# 接口地址：
card.list
# 请求参数：
| 参数 | 类型 | 是否必传 | 说明 | 备注 |
|---|---|---|---|---|
| openId | String | 是 | 用户ID | |
| bizType | String | 是 | 场景类型 | 借款:loan 还款:repay |
| bizNo | String | 否 | 业务流水号 | 根据busiType传对应的业务单号，如借款单号；bizType为repay（还款）必填 |
# 响应参数：
| 参数 | 类型 | 是否必传 | 说明 | 备注 |
|---|---|---|---|---|
| bankCardList | List | 是 | 银行卡列表 | 用户已绑银行卡列表，若无则为空 |
bankCardList:
| 参数 | 类型 | 是否必传 | 说明 | 备注 |
|---|---|---|---|---|
| bindCardId | String | 是 | 绑卡id | 建议广告主返回可唯一标识卡数据的字段，如表的主键，便于与绑卡短信验证接口及后续相关接口关联 |
| cardNo | String | 是 | 卡号 | |
| cardType | Integer | 是 | 卡类型 | 1: 借记卡 2: 信用卡 目前只支持借记卡 |
| bankCode | String | 是 | 银行卡开户行代码 | 银行代码，见枚举项 |
| bankName | String | 是 | 银行名称 | 见枚举项 |
| phone | String | 否 | 预留手机号 | 用户预留手机号。用来给用户发送短信 |