# 4.3 绑卡

# 4.3.1 绑卡申请

# 接口说明：

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

# 接口地址：

card.bind

# 请求参数：

参数	类型	是否必传	说明	备注
openId	String	是	用户ID
transNo	String	是	绑卡流水号	响应参数中 status=1 即绑卡失败时会重新生成流水号
cardNo	String	是	绑卡卡号
cardType	Integer	是	卡类型	1: 借记卡 2: 信用卡目前只支持借记卡
bankCode	String	否	银行卡开户行代码	银行代码，见枚举项 5.11 银行代码
userName	String	是	用户姓名	广告主方应当校验用户两要素是否与注册时相同，保证用户绑的是本人的卡
idCard	String	是	用户身份证号
phone	String	是	手机号	银行卡预留手机号
bizType	String	是	场景类型	借款:loan 还款:repay
bizNo	String	否	业务流水号	根据bizType传对应的业务单号，现都是借款单号还款场景必填
orderNo	String	否	授信单号	授信单号(如在授信前绑卡则无授信单号)
behaviorType	Integer	否	发送短信的行为类型	0:系统触发 1:用户主动触发
pageSource	Integer	否	页面来源	0:绑卡页触发, 1:非绑卡页触发
batchNo	String	否	增验流水号	合作渠道产生

# 响应参数：

参数	类型	是否必传	说明	备注
bindCardId	String	否	绑卡id	建议广告主返回可唯一标识卡数据的字段，如表的主键，便于与绑卡短信验证接口及后续相关接口关联
status	String	是	绑卡状态码	如：0000
desc	String	否	绑卡信息	错误描述，如：绑卡成功可透传真实错误信息或转为用户友好的信息，根据业务需求决定

# 绑卡申请响应示例

 {
 "msg": "success",
 "code": 0,
 "data": "{\"bindCardId\":\"234051213805486090\",\"status\":\"0002\",\"desc\":\"验证码发送成功\"}"
 }

1
2
3
4
5

# status枚举

status	desc
0000	绑卡成功（针对卡已绑定的情况）
0001	处理中（针对绑卡异步返回结果的情况）
0002	发送验证码成功
0003	输入手机号与预留手机号不一致
0004	签约身份证已过期
0005	输入信息与签约信息不符
0006	该卡状态异常
0007	银行交易出错
0008	发送短信验证码失败
9999	其他

# 4.3.2 绑卡短信验证

# 接口说明：

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

# 接口地址：

card.verify

# 请求参数：

参数	类型	是否必传	说明	备注
openId	String	是	用户ID
transNo	String	是绑卡流水号	多次调用绑卡流水号不变
bindCardId	String	否	绑卡id	绑卡申请响应参数
verifyCode	String	是	短信验证码	目前支持6位验证码
orderNo	String	否	授信单号	授信单号(如在授信前绑卡则无授信单号)
batchNo	String	否	增验流水号	合作渠道产生

# 响应参数：

参数	类型	是否必传	说明	备注
status	String	是	状态	如：0002
desc	String	否	错误描述	如：验证码错误
bindCardId	String	否	绑卡id	短信验证成功时必填

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

{
  "msg": "success",
  "code": 0,
  "data": "{\"status\":\"0000\",\"desc\":\"绑卡成功\",\"bindCardId\":\"111111\"}"
  }

1
2
3
4
5

# status枚举

status	desc
0000	绑卡成功
0001	处理中（针对绑卡异步返回结果的情况）
0002	验证码错误
0003	验证码已过期
0004	签约身份证已过期
0005	输入信息与签约信息不符
0006	该卡状态异常
0007	银行交易出错
1000	发送下一条验证码（若需要多次绑卡，广告主在宜信调用此接口时自行发送验证码，返回此状态，宜信方会再次调用此接口，直到返回终态（成功或失败等））【已废弃，参照4.7.1接口】
9999	其他

# 4.3.3 银行卡解绑（2025年起无需对接）

# 接口说明：接口由广告主提供，宜信调用。宜信传递用户四要素交由广告主鉴权通道进行解绑卡。

# 接口地址：

card.unbind

# 请求参数

参数	类型	是否必传	说明	备注
openId	String	是	用户ID
bindCardId	Long	是	绑卡id	绑卡申请响应参数

# 响应参数

参数	类型	是否必传	说明	备注
status	Integer	是	解绑状态	如：0000
desc	String	否	具体描述	如：解绑成功

# status枚举

status	desc
0000	解绑成功
0001	处理中（针对绑卡异步返回结果的情况）
0004	签约身份证已过期
0005	输入信息与签约信息不符
0006	该卡状态异常
0007	银行交易出错
9999	其他

# 4.3.4 用户绑卡列表

# 接口说明：

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

# 接口地址：

card.list

# 请求参数：

参数	类型	是否必传	说明	备注
openId	String	是	用户ID
bizType	String	否	场景类型	借款:loan 还款:repay
bizNo	String	否	业务流水号	根据bizType传对应的业务单号，现都是借款单号
orderNo	String	否	授信申请流水号	授信单号(如在授信前绑卡则无授信单号), 借款和还款类型时授信单号必传

# 响应参数：

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

# 用户绑卡列表响应示例

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

1
2
3
4
5

bankCardList:

参数	类型	是否必传	说明	备注
bindCardId	String	是	绑卡id	建议广告主返回可唯一标识卡数据的字段，如表的主键，便于与绑卡短信验证接口及后续相关接口关联
cardNo	String	是	卡号
cardType	Integer	是	卡类型	1: 借记卡 2: 信用卡目前只支持借记卡
bankCode	String	是	银行卡开户行代码	银行代码，见枚举项 5.11 银行代码
bankName	String	是	银行名称	见枚举项
phone	String	是	预留手机号	用户预留手机号。用来给用户发送短信

# 4.3.5 查询支持银行列表

# 接口说明：

接口由广告主提供，宜信调用。宜信查询用户在广告主所支持的银行；

# 接口地址：

bank.list

# 请求参数：

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

# 响应参数

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

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

{
  "msg": "success",
  "code": 0,
  "data": "{\"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

bankList:

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

# 4.3.6 是否绑卡回调通知（2025年起无需对接）

# 接口说明：接口由宜信提供，广告主调用，通知宜信是否需要绑卡

# 接口地址：

need.bind.card.callback

# 请求参数

参数	类型	是否必传	说明	备注
openId	String	是	用户ID
needBindCard	String	是	是否需要绑卡	如：1；参照：needBindCard枚举

# 响应参数

参数	类型	是否必传	说明	备注
status	String	是	受理状态	如：0000；参照：status枚举
desc	String	否	具体描述

# status枚举

status	desc
0000	受理成功
0001	用户不存在
9999	其他

# needBindCard枚举

needBindCard	desc
1	需要绑卡
0	不需要绑卡

# 4.3.7 H5绑卡

# 接口说明：

接口由广告主提供，宜信调用。

# 接口地址：

card.bind.h5

# 请求参数：

参数	类型	是否必传	说明	备注
openId	String	是	用户ID
cardType	Integer	是	卡类型	1: 借记卡 2: 信用卡目前只支持借记卡
userName	String	是	用户姓名	广告主方应当校验用户两要素是否与注册时相同，保证用户绑的是本人的卡
idCard	String	是	用户身份证号
returnUrl	String	是	h5后回调的地址	h5绑卡成功后回调的地址
orderNo	String	否	授信单号	授信单号(如在授信前绑卡则无授信单号)

# 响应参数：

参数	类型	是否必传	说明	备注
userName	String	是	用户姓名	广告主方应当校验用户两要素是否与注册时相同，保证用户绑的是本人的卡
idCard	String	是	用户身份证号
cardNo	String	否	银行卡号
phone	String	否	手机号
bindCardUrl	String	是	绑卡签约H5页面URL

# 绑卡申请响应示例

 {
 "msg": "success",
 "code": 0,
 "data": "{\"realName\":\"张三\",\"orderId\":\"DIVERSIONCREDIT_070f6818e1d441e6828877aa55b5e0e4\",\"idCard\":\"XXXXXXXXXXXXX\",\"returnUrl\":\"https://www.yxh2.cn/misc/back-to-before-open-external-url\"}",

 }

1
2
3
4
5
6

← 4.2 授信 4.4 借款 →