# 4.3 绑卡

# 4.3.1 绑卡申请

# 接口说明：

接口由宜信提供，合作方调用。合作方渠道传递用户四要素交由宜信鉴权通道进行绑卡，宜信向用户发送绑卡鉴权短信验证码。目前支持6位验证码。

# 接口地址：

bindCard

# 请求参数：

参数	类型	是否必传	说明	备注
outerUserNo	String	是	用户ID
cardNo	String	是	绑卡卡号
phone	String	是	手机号	银行卡预留手机号
bizType	String	是	场景类型	借款:loan 还款:repay
bizNo	String	否	业务流水号	bizType为还款场景时必传，传对应借款单号

# 响应参数：

参数	类型	是否必传	说明	备注
bizId	String	是	短信业务流水号	用于绑卡短信验证接口及后续相关接口关联
status	String	是	绑卡状态	0：成功 -1：无需绑卡 -2：失败
desc	String	否	业务信息	如："已开通协议支付，不必重复开通"

# 绑卡申请响应示例

 {
 "msg": "success",
 "code": 0,
 "params": "{\"bizId\":\"234051213805486090\",\"status\":\"0\",\"desc\":\"成功\"}"
 }

1
2
3
4
5

# 4.3.2 绑卡短信验证

# 接口说明：

接口由宜信提供，合作方调用。合作方通知宜信校验用户填写的绑卡鉴权短信验证码。

# 接口地址：

verifyCode

# 请求参数：

参数	类型	是否必传	说明	备注
outerUserNo	String	是	用户ID
bizId	String	是	绑卡id	绑卡申请响应参数
verifyCode	String	是	短信验证码	目前支持6位验证码

# 响应参数：

参数	类型	是否必传	说明	备注
status	String	是	短验状态	0：成功 -1：无需绑卡 -2：失败 -3:验证码过期
desc	String	否	错误描述	如：验证码错误

###绑卡短信验证响应示例

{
  "msg": "success",
  "code": 0,
  "params": "{\"status\":\"0\",\"desc\":\"绑卡成功\"}"
  }

1
2
3
4
5

# 4.3.3 用户绑卡列表

# 接口说明：

接口由宜信提供，合作方调用。合作方查询用户在宜信绑定的银行卡列表；

# 接口地址：

cardList

# 请求参数：

参数	类型	是否必传	说明	备注
outerUserNo	String	是	用户ID

# 响应参数：

参数	类型	是否必传	说明	备注
bankCardList	List	是	银行卡列表	用户已绑银行卡列表，若无则为空

bankCardList:

参数	类型	是否必传	说明	备注
bindCardId	String	是	绑卡id
cardNo	String	是	卡号
cardType	Integer	是	卡类型	1: 借记卡 2: 信用卡目前只支持借记卡
bankCode	String	是	银行卡开户行代码	银行代码，见枚举项
bankName	String	是	银行名称	见枚举项
phone	String	否	预留手机号	用户预留手机号。用来给用户发送短信

# 用户绑卡列表响应示例

{
  "msg": "success",
  "code": 0,
  "params": "{\"bankCardList\":[{\"cardNo\":\"4340626190606023\",\"cardType\":1,\"bankCode\":\"CCB\",\"bankName\":\"建设银行\",\"phone\":\"18356670064\"}]}"
  }

1
2
3
4
5

# 4.3.4 查询支持银行列表

# 接口说明：

接口由宜信提供，合作方调用。合作方查询用户在宜信所支持的银行；

# 接口地址：

bankList

# 请求参数：

参数	类型	是否必传	说明	备注
outerUserNo	String	是	用户ID

# 响应参数

参数	类型	是否必传	说明	备注
bankList	List	是	银行列表	支持的银行列表

bankList:

参数	类型	是否必传	说明	备注
bankName	String	是	银行名称	见枚举项
bankCode	String	是	银行代码	见枚举项
timesLimit	BigDecimal	是	单笔限额	单位：元
dayLimit	BigDecimal	是	单日限额	单位：元

# 查询银行卡列表响应示例

{
  "msg": "success",
  "code": 0,
  "params": "{\"bankList\":[{\"bankName\":\"农业银行\",\"bankCode\":\"ABC\",\"timesLimit\":500000,\"dayLimit\":5000000},{\"bankName\":\"中国银行\",\"bankCode\":\"BOC\",\"timesLimit\":5000000,\"dayLimit\":5000000},{\"bankName\":\"建设银行\",\"bankCode\":\"CCB\",\"timesLimit\":5000000,\"dayLimit\":20000000},{\"bankName\":\"光大银行\",\"bankCode\":\"CEB\",\"timesLimit\":1000000,\"dayLimit\":5000000},{\"bankName\":\"兴业银行\",\"bankCode\":\"CIB\",\"timesLimit\":5000000,\"dayLimit\":5000000},{\"bankName\":\"中信银行\",\"bankCode\":\"ECITIC\",\"timesLimit\":500000,\"dayLimit\":2000000},{\"bankName\":\"招商银行\",\"bankCode\":\"CMB\",\"timesLimit\":5000000,\"dayLimit\":20000000},{\"bankName\":\"民生银行\",\"bankCode\":\"CMBC\",\"timesLimit\":5000000,\"dayLimit\":5000000},{\"bankName\":\"交通银行\",\"bankCode\":\"BOCOM\",\"timesLimit\":1000000,\"dayLimit\":10000000},{\"bankName\":\"广发银行\",\"bankCode\":\"CGB\",\"timesLimit\":5000000,\"dayLimit\":20000000},{\"bankName\":\"工商银行\",\"bankCode\":\"ICBC\",\"timesLimit\":5000000,\"dayLimit\":5000000},{\"bankName\":\"邮储银行\",\"bankCode\":\"PSBC\",\"timesLimit\":500000,\"dayLimit\":500000},{\"bankName\":\"浦发银行\",\"bankCode\":\"SPDB\",\"timesLimit\":5000000,\"dayLimit\":20000000},{\"bankName\":\"平安银行\",\"bankCode\":\"PAB\",\"timesLimit\":5000000,\"dayLimit\":10000000},{\"bankName\":\"华夏银行\",\"bankCode\":\"HXB\",\"timesLimit\":500000,\"dayLimit\":5000000}]}"
  }

1
2
3
4
5

# 4.3.5 根据卡号获取发卡银行

# 接口说明：

接口由宜信提供，合作方调用。合作方查询用户银行卡发卡行；

# 接口地址：

cardBank

# 请求参数：

参数	类型	是否必传	说明	备注
cardNo	String	是	绑卡卡号

# 响应参数

参数	类型	是否必传	说明	备注
bankName	String	是	银行名称	见枚举项
bankCode	String	是	银行代码	见枚举项

# 查询银行卡列表响应示例

{
  "msg": "success",
  "code": 0,
  "params": "{\"bankName\":\"农业银行\",\"bankCode\":\"ABC\"}"
  }

1
2
3
4
5

# 4.3.6 是否需要协议绑卡

# 接口说明：

接口由宜信提供，合作方调用。合作方查询用户银行卡是否需要协议绑卡；

# 接口地址：

needCardSign

# 请求参数：

参数	类型	是否必传	说明	备注
outerUserNo	String	是	用户ID
cardNo	String	是	绑卡卡号

# 响应参数

参数	类型	是否必传	说明	备注
status	String	是	绑卡状态	1：需要绑卡 -1：无需绑卡

# 查询银行卡列表响应示例

{
  "msg": "success",
  "code": 0,
  "params": "{\"status\":\"1\"}"
  }

1
2
3
4
5

← 4.2 授信 4.4 借款 →