4 绑卡
4.1 绑卡查询
4.1.1 接口说明
- 接口由宜信提供，合作方调用，用户在宜信是否绑定过传入的银行卡。
4.1.2 接口地址
api/v1/rightsOrder/card/bindQuery
4.1.3 请求参数
| 参数名称 | 类型 | 是否必须 | 说明 | 备注 |
|---|
| openId | String | 是 | 用户唯一标识 | |
| cardNo | String | 是 | 银行卡号 | |
4.1.4 响应参数
| 参数名称 | 类型 | 是否必须 | 说明 | 备注 |
|---|
| openId | String | 是 | 用户唯一标识 | |
| bindCard | Boolean | 是 | 是否已绑卡 true-已绑卡 false-未绑卡 | |
4.2 CardBin查询
4.2.1 接口说明
- 接口由宜信提供，合作方调用。合作方查询用户银行卡所属银行。
4.2.2 接口地址
api/v1/rightsOrder/card/bin
4.2.3 请求参数
| 参数名称 | 类型 | 是否必须 | 说明 | 备注 |
|---|
| openId | String | 是 | 用户唯一标识 | |
| cardNo | String | 是 | 银行卡号 | |
4.2.4 响应参数
| 参数名称 | 类型 | 是否必须 | 说明 | 备注 |
|---|
| openId | String | 是 | 用户唯一标识 | |
| cardNo | String | 是 | 本次短验对应银行卡号 | |
| bankName | String | 是 | 银行卡所属银行 | |
4.3 绑卡申请接口
4.3.1 接口说明
- 接口由宜信提供，合作方调用。宜信根据合作方传入信息对用户四要素进行鉴权，宜信向用户发送通道绑卡短信验证码。 目前支持6位验证码。
4.3.2 接口地址
api/v1/rightsOrder/card/bindSms
4.3.3 请求参数
| 参数名称 | 类型 | 是否必须 | 说明 | 备注 |
|---|
| openId | String | 是 | 用户唯一标识 | |
| phone | String | 是 | 银行卡预留手机号 | |
| cardNo | String | 是 | 银行卡号 | |
4.3.4 响应参数
| 参数名称 | 类型 | 是否必须 | 说明 | 备注 |
|---|
| openId | String | 是 | 用户唯一标识 | |
| bizId | String | 是 | 短验流水号 | |
| phone | String | 是 | 本次短验对应手机号 | |
| cardNo | String | 是 | 本次短验对应银行卡号 | |
4.4 支持的银行列表
4.4.1 接口说明
- 接口由宜信提供，合作方调用。合作方查询用户在宜信所支持的银行。
4.4.2 接口地址
api/v1/rightsOrder/card/bankLimit
4.4.3 请求参数
| 参数名称 | 类型 | 是否必须 | 说明 | 备注 |
|---|
| channel | String | 是 | 渠道方名称 | 宜信提供 |
4.4.4 响应参数
| 参数名称 | 类型 | 是否必须 | 说明 | 备注 |
|---|
| bankList | List | 是 | 支持的银行列表 | 详见bankList |
== bankList ==
| 参数名称 | 类型 | 是否必须 | 说明 | 备注 |
|---|
| bankCode | String | 是 | 银行编码 | ICBC |
| bankName | String | 是 | 银行名称 | |
| iconUrl | String | 是 | 银行图标地址 | |
4.5 绑卡短信验证（确认绑卡）
4.5.1 接口说明
- 接口由宜信提供，合作方调用。合作方通知宜信校验用户填写的绑卡鉴权短信验证码。
4.5.2 接口地址
api/v1/rightsOrder/card/bindVerify
4.5.3 请求参数
| 参数名称 | 类型 | 是否必须 | 说明 | 备注 |
|---|
| openId | String | 是 | 用户唯一标识 | |
| phone | String | 是 | 银行卡预留手机号 | |
| cardNo | String | 是 | 银行卡号 | |
| bizId | String | 是 | 短验流水号 | |
| smsCode | String | 是 | 短信验证码 | |
4.5.4 响应参数
| 参数名称 | 类型 | 是否必须 | 说明 | 备注 |
|---|
| openId | String | 是 | 用户唯一标识 | |
| status | Integer | 是 | 0-成功 1-失败 | |
4.6 已绑卡列表查询
4.6.1 接口说明
- 接口由宜信提供，合作方调用。合作方查询用户已在宜享花绑定的银行卡列表
4.6.2 接口地址
api/v1/rightsOrder/card/list
4.6.3 请求参数
| 参数名称 | 类型 | 是否必须 | 说明 | 备注 |
|---|
| openId | String | 是 | 用户唯一标识 | |
4.6.4 响应参数
| 参数名称 | 类型 | 是否必须 | 说明 | 备注 |
|---|
| openId | String | 是 | 用户唯一标识 | |
| cardList | List | 是 | 已绑卡列表 | 详见cardList |
== cardList ==
| 参数名称 | 类型 | 是否必须 | 说明 | 备注 |
|---|
| cardNo | String | 是 | 银行卡号 | |
4.7 绑卡协议信息同步
4.7.1 接口说明
- 接口由宜信提供，合作方调用。合作方同步绑卡协议到宜信方
4.7.2 接口地址
api/v1/rightsOrder/card/protocol/sync
4.7.3 请求参数
| 参数名称 | 类型 | 是否必须 | 说明 | 备注 |
|---|
| openId | String | 是 | 用户唯一标识 | |
| tranNo | String | 是 | 代扣申请流水号 | |
| bankCode | String | 是 | 银行编码 | |
| cardNo | String | 是 | 银行卡号 | |
| phone | String | 是 | 银行预留手机号 | |
| protocolNo | String | 是 | 业务协议编号 | |
| payComName | String | 是 | 支付公司名称 | |
4.7.4 响应参数
