2.1.1 借款预申请创建

优质
小牛编辑
130浏览
2023-12-01

描述

支持个人提交简单资料,进行贷款意向的收集。创建成功后,需要保存响应参数中的“申请ID”,作为后续交易的请求参数。

API代码

loan_app:cs_pre_app:create

请求参数

名称类型是否必须最大长度描述示例值
custIdString50借款人在平台方的客户ID或编号,能够唯一标识某一客户0092728480d24f5d8
nmString300借款人姓名(与身份证上相同)张三
idNoString50身份证号码
mtGenderCdString20性别
mtMaritalStsCdString20婚姻情况
mtEduLvlCdString20最高学历
mtResidenceStsCdString20本地居住情况
isFamilyString1是否自有房产
mtJobSectorCdString20职业
mtCityCdString20所在城市
mobileNoString20手机号
creditCardLinesNumber14 (12,2)信用卡额度
portraitJSON1000客户画像{"芝麻评分":"698"}
lmtApprNumber30 (26,4)申请额度
tenureApprNumber6业务期限
mtTimeCdString1业务期限类型(D-天、M-月、Y-年)
intRateNumber9 (5,4)年化利率

响应参数

名称类型描述示例值
app_idString申请ID0092728480d24f5d87bf63639b5cfe1c

错误码

描述HTTP状态码语义
nm不能为空400请检查nm字段是否传值
存在在途申请405客户的前一笔融资请求尚未批准或取消,无法发起新融资申请

示例

请求示例(个人)

{

    "custId": "77f392388c2e410684", 
    "idNo": "1867fc918fdc4e349e", 
    "isFamily": "Y", 
    "mobileNo": "18888888888", 
    "creditCardLines":10000
    "mtCityCd": "110100", 
    "mtEduLvlCd": "01", 
    "mtGenderCd": "M", 
    "mtJobSectorCd": "10000", 
    "mtMaritalStsCd": "02", 
    "mtResidenceStsCd": "01", 
    "nm": "张三", 
    "intRate": 123, 
    "lmtAppr": 123, 
    "mtTimeCd": "M", 
    "tenureAppr": "12",
    "portrait": "{\"芝麻信用分\":\"750\"}"
}

返回示例(正常)

{
    "appId":"0092728480d24f5d87bf63639b5cfe1c"
}

返回示例(异常)

{
  "error": "500",
  "message": "没有获取到用户身份信息",
  "timestamp": "2016-12-29 15:10:32"
}