用户验证接口 - qianlongjinrong/Shoujidai-Yundaitong GitHub Wiki

1、用户排重验证接口

  • [接口说明]

合作机构方需要先将用户的关键用户信息（可根据需要做掩码）推送给手机贷做有效验证处理，只有手机贷认证为有效的用户，方可进行后续的服务接入，验证无效的用户请不要在做后续的推送。目前手机贷支持四种方式组合规则进行验证，如果选中了某种规则，则对应的信息不可为空。

1、手机号+姓名

2、手机号+身份证号

3、身份证+姓名

4、手机号+身份证号+姓名

如若需要做掩码处理，其中手机号和身份证号均可做掩码处理，只可掩码数据后部分，不可掩码中间或者前部分，掩码位数不允许超过4位，否则匹配精度过低，姓名必须为明文。若非合作特殊要求，建议全部明文传递。

说明：在商务允许的前提下，根据产品合作要求，可以不调用该接口。

  • [技术要求]

接口采用HTTP POST方式，数据组织采用JSON传递。

  • [服务名称]

approveUser

  • [请求业务数据报文-reqData参数说明]
参数名称 类型 是否必填 说明
idCard String(18) 否 用户身份证号码
如若需要做掩码，请从后部掩码，掩码位数不要超过4个。
若规则为2、3、4时必填。
maskIdCard Int(1) 否 身份证掩码位数
如若不需要身份证号码掩码请填写0。
userPhone String(18) 否 用户手机号
如若需要做掩码，请从后部掩码，掩码位数不要超过4个。
若规则为1、2、4时则必填
maskPhone Int(1) 否 手机号掩码位数
如若不需要手机号码掩码请填写0。
userName String(20) 否 用户真实姓名
不可做掩码处理。若规则为1、3、4时必填
  • [响应业务数据报文-data参数说明]
参数名称 类型 是否必填 说明
flag Int（1） 是 手机贷用户验证标记
0：无效
1：有效
若是无效用户不用再继续后续的流程推送。
producInfo JSON ARRAY 否 可对接的产品信息列表
此节点的数据格式为JSON ARRAY封装,具体参数明细请参考下面的
[响应业务数据报文-productInfo参数说明]
说明：该节点数据根据合作需要定制化开放。
  • [响应业务数据报文-productInfo参数说明]
参数名称 类型 是否必填 说明
productType Int（1） 是 手机贷云贷通平台产品类型标记
1、现金单期
2、现金分期
amountMin Double(6,2) 否 该用户在手机贷产品下可借贷的最小额度。不同的productType对应的范围不同。
amountMax Double(6,2) 否 该用户在手机贷产品下可借贷的最大额度。不同的productType对应的范围不同。
period String(20) 否 允许的借款期数或天数。
如果productType为1，则period的单位是天，如果productType为2，则period的单位为期数。
如果为单期，则格式为：“7-40”,7代表借款天数下限，40代表借款天数上限，用“-”分割。
如果为分期，则格式为：“3,6,9,12”,其中的每个数字代表可允许的借贷期数，使用逗号“,”分割。
  • 【请求报文示例-有掩码】
{
    "idCard": "3120221983031****",
    "maskIdCard": "4",
    "userPhone": "1368888****",
    "maskPhone": "4",
    "userName": "张三丰"
}
  • 【请求报文示例-无掩码】
{
    "idCard": "31202219830318888",
    "maskIdCard": "0",
    "userPhone": "13688888888",
    "maskPhone": "0",
    "userName": "张三丰"
}
  • 【响应报文示例】
{
    "flag": "1",
    "productInfos": [
        {
            "productType": "1",
            "amountMin": "1000",
            "amountMax": "5000",
            "period": "7-40"
        },
        {
            "productType": "2",
            "amountMin": "3000",
            "amountMax": "10000",
            "period": "3,6,9,12"
        }
    ]
}

2初始化用户接口

  • [接口说明]

合作机构平台将借贷用户明文的三要素信息（手机号、身份证号、姓名）同步给手机贷，经过手机贷验证过三要素信息的用户，创建手机贷用户账户，并分配一个全局唯一userCode信息，后续大部分接口调用都依赖该userCode。

注意：该接口是除用户排重验证接口外必须要依赖的。

  • [技术要求]

接口采用HTTP POST方式，数据组织采用JSON传递。

  • [服务名称]

initUser

  • [请求业务数据报文-reqData参数说明]
参数名称 类型 是否必填 说明
userPhone String（11） 是 用户移动手机号码
有效长度为11位，不要带+86。
realName String（10） 是 用户姓名
不可出现特殊字符
cardId String（18） 是 用户身份证号
15至18位有效的身份证号。
  • [响应业务数据报文-data参数说明]
参数名称 类型 是否必填 说明
userCode String(32) 是 手机贷分配的用户编号
其它的接口调用都依赖该参数。
正常处理后会分配userCode。
该userCode长期有效。
  • 【请求报文示例】
{
    "userPhone": "13688888888",
    "realName": "张三丰",
    "idCard": "31202219830318888"
}
  • 【响应报文示例】
{
    "userCode": "20170629526131"
}
⚠️ **GitHub.com Fallback** ⚠️