撞库接口

接口信息

需对方提供

• 地址：合作机构提供接口地址
• 请求方式：POST
• 接口说明：万利通调用机构撞库接口，传入统一标准用户资质

请求参数

参数	类型	必填	说明
mobileMask	String	是	手机号前8位，例如：13812345
mobileMd5	String	是	手机号 MD5
realName	String	是	用户姓名
gender	Integer	是	性别：1=男，0=女
city	String	是	城市名称
idCard	String	是	身份证号
age	Integer	是	年龄
education	Integer	是	学历，见参数字典
housingStatus	Integer	是	房产，见参数字典
hasCar	Integer	是	车辆，见参数字典
overdue	Integer	是	逾期情况
creditCard	Integer	是	信用卡
commercialInsurance	Integer	是	保险
occupation	Integer	是	职业
salaryOfMonth	Integer	是	月收入
hasProvidentFund	Integer	是	公积金
hasSocialSecurity	Integer	是	社保
zhimaScore	Integer	是	芝麻分等级，详见参数字典
weili	Integer	是	微粒贷
baiTiao	Integer	是	京东白条
huaBei	Integer	是	花呗
businessTime	Integer	否	营业执照时长（月）
loanAmount	Integer	是	贷款金额（万元）
loanTime	Integer	是	贷款期限（月）
purpose	Integer	是	贷款用途
paymentForm	Integer	是	工资发放
applyIp	String	是	用户 IP
authUrl	String	是	万利通回调地址
agreementUrl	String	否	万利通提供的个人信息授权协议链接，协议内容包含平台与合作机构双方公司名、产品名

响应参数

参数	类型	说明
code	Integer	0-成功
msg	String	响应消息
data	Object	响应数据

data 字段

参数	类型	说明
userId	String	用户标识
applyNo	String	机构申请号（如有）
channelId	String	机构分配给万利通的渠道标识（如有）
productName	String	产品名称
companyName	String	机构名称（如有）
logo	String	Logo URL
price	Float	单价（元）
discountPrice	Float	折后单价（如有，平台优先取该值）
protocols	Array	协议列表
url	String	授权 URL；撞库返有值，进件返可为空

请求示例

{
  "mobileMask": "13812345",
  "mobileMd5": "5d41402abc4b2a76b9719d911017c592",
  "realName": "张三",
  "gender": 1,
  "city": "成都市",
  "idCard": "510100199001011234",
  "age": 34,
  "education": 5,
  "housingStatus": 2,
  "hasCar": 0,
  "overdue": 0,
  "creditCard": 1,
  "commercialInsurance": 2,
  "occupation": 1,
  "salaryOfMonth": 3,
  "hasProvidentFund": 4,
  "hasSocialSecurity": 4,
  "zhimaScore": 1,
  "weili": 1,
  "baiTiao": 1,
  "huaBei": 1,
  "loanAmount": 5,
  "loanTime": 12,
  "purpose": 1,
  "paymentForm": 3,
  "applyIp": "114.114.114.114",
  "authUrl": "https://platform.example.com/api/platform/downstream/auth-callback",
  "agreementUrl": "https://platform.example.com/agreements/downstream-authorization?..."
}

响应示例

{
  "code": 0,
  "msg": "成功",
  "data": {
    "userId": "USER123456",
    "channelId": "CH001",
    "productName": "信用贷",
    "companyName": "示例机构",
    "logo": "https://example.com/logo.png",
    "price": 20.0,
    "discountPrice": 18.5,
    "protocols": [
      {
        "name": "用户协议",
        "url": "https://example.com/protocol.html"
      }
    ],
    "url": "https://institution.example.com/auth?userId=USER123456"
  }
}

注意事项

1. 撞库返模式需在 url 中返回授权页地址。
2. 进件返模式在撞库阶段可不返回 url，但需返回可用于后续进件的 userId 或 applyNo。
3. 平台优先读取 discountPrice，未返回时回退读取 price。
4. authUrl 为机构回调万利通地址，agreementUrl 为用户查看的授权协议链接，两者语义不同，不可混用。