# 4.1 初筛
# 4.1.1 初筛
# 接口说明:
WARNING
- 检测用户是否满足准入的条件,每次注册前调用。检测条件根据商务广告主式协定;
- 接口由广告主方提供,宜信调用。宜信将用户身份证号、姓名、手机号给到广告主,
由广告主返回该用户是否符合授信准入规则。
# 接口地址:
user.access
# 请求参数:
参数名称 | 类型 | 是否必须 | 说明 | 备注 |
---|---|---|---|---|
openId | String[100] | 是 | 用户 ID | |
phoneMD5 | String[100] | 是 | 手机号 MD5 | md5小写 |
identityIdMD5 | String[500] | 是 | 身份证号 MD5 | 身份证如含字母X用大写,加密后的md5是小写 |
identityIdPrefix | String | 是 | 身份证号 | 身份证如含字母X用大写(身份证号前6位) |
phoneAndIdentityIdMd5 | String | 是 | 手机号+身份证md5 |
# 响应参数:
参数名称 | 类型 | 是否必须 | 说明 | 备注 |
---|---|---|---|---|
status | String | 是 | 撞库状态 | 参考枚举 |
msgCode | String | 否 | 具体业务信息码 | |
msgDesc | String | 否 | 具体业务码对应的描述信息 |
# 准入响应示例
{
"msg": "success",
"code": 0,
"data": "{\"status\":\"10\",\"msgCode\":\"0000\"}"
}
1
2
3
4
5
2
3
4
5
# status枚举
code | desc |
---|---|
10 | 允许准入(可以注册授信,其他不允许准入) |
20 | 不允许准入 |
# msgCode 枚举
code | desc |
---|---|
0000 | 允许准入(可以注册授信,其他不允许准入) |
0002 | 已经在对方有进行中的贷款 |
0003 | 在对方有严重逾期订单记录 |
0004 | 未过锁定期(30天内被机构审批拒绝过) |
0005 | 在机构的额度为 0 |
0006 | 已获得授信额度可提现 |
0007 | 风控原因(指部署的风控相关的硬门槛,都可归类到该项) |
0008 | 已注销用户 |
0009 | 手机号和身份证号对应关系不一致 |
0010 | 机构已注册用户 |
9999 | 其他 |
# 4.1.2 注册(2025年起无需对接)
# 接口说明:
WARNING
- 发起合作方注册
- 由宜信返回该用户是否注册成功。
- 一般不用接入该接口,默认会在4.2.1广告主补充资料+注册。
- 只有在授信前需要部分信息的情况下才会调用该接口。
- 例如:乐享借
# 接口地址:
user.regist
# 请求参数:
参数名称 | 类型 | 是否必须 | 说明 | 备注 |
---|---|---|---|---|
phone | String | 是 | 手机号 | |
identityId | String | 是 | 身份证号 | 身份证如含字母X用大写 |
openId | String | 是 | 用户id | |
name | String | 是 | 用户姓名 | |
idCardFrontPhoto | String | 是 | 身份证正面 | base64 (图片大小:500KB内) |
idCardBackPhoto | String | 是 | 身份证背面 | base64 (图片大小:500KB内) |
ip | String | 是 | ip地址 | |
nation | String | 是 | 名族 | |
authority | String | 是 | 发证机关 | |
identifyInvalidDateStart | String | 是 | 身份证有效期起 | yyyy-MM-dd |
identifyInvalidDateEnd | String | 是 | 身份证有效期止 | yyyy-MM-dd |
idCardAddress | String | 是 | 身份证的户籍地址 | 户籍所在地 |
systemSource | String | 是 | 系统 | 参照枚举字段 |
# 响应参数:
参数名称 | 类型 | 是否必须 | 说明 | 备注 |
---|---|---|---|---|
status | String | 是 | 处理结果 | 0000:处理成功;0002:处理失败 |
msgDesc | String | 是 | 处理结果描述 | 成功 ;失败原因 |
status 0000: 处理成功 0002: 处理失败
# 准入响应示例
{
"msg": "success",
"code": 0,
"data": "{\"status\":\"0000\",\"msgDesc\":\"失败原因描述\"}"
}
1
2
3
4
5
2
3
4
5
# 4.1.3 获取用户准入后流程参数(2025年起无需对接)
# 接口说明:
由合作方提供接口,宜信方调用该接口获取流程中需要的参数 目前提供参数:
- 宜信方会在初筛准入通过后调用此接口获取后续流程需要的参数
- 只有需要合作方确定后续流程的情况下会需要实现此接口, 例如:乐享借
目前提供参数:
是否需要授信前绑卡-是否要在授信前补充资料阶段要求用户绑卡
# 接口地址:
user.extra
# 请求参数:
参数名称 | 类型 | 是否必须 | 说明 | 备注 |
---|---|---|---|---|
openId | String | 是 | 用户id |
# 响应参数:
参数名称 | 类型 | 是否必须 | 说明 | 备注 |
---|---|---|---|---|
needBindCardBeforeCredit | Integer | 是 | 是否需要授信前绑卡 | 0:不需要;1:需要 |
status | String | 是 | 处理结果 | 0000:处理成功;0002:处理失败 |
msgDesc | String | 是 | 处理结果描述 | 成功 ;失败原因 |
status 0000: 处理成功 0002: 处理失败