查询相关 - qianlongjinrong/Shoujidai-Yundaitong GitHub Wiki

1、查询用户授信额度接口

  • [接口说明]

合作平台可以根据需要查询用户在手机贷的授信额度，根据用户的授信额度，匹配用户可借贷金额的上下限。

说明：该接口和返回的数据信息根据合作需要做定制化开放。

  • [技术要求]

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

  • [服务名称] getUserAmount
  • [请求业务数据报文-reqData参数说明]
参数名称 类型 是否必填 说明
userCode String(32) 是 手机贷分配的用户编号。
有调用同步用户信息接口生成返回。
  • [响应业务数据报文-data参数说明]
参数名称 类型 是否必填 说明
userAmount JSON Array 是 用户的不同产品的授信额度信息。
此节点的数据格式为JSON Array封装,具体参数明细请参考下面的[响应业务数据报文- userAmount参数说明]
  • [响应业务数据报文- userAmount参数说明]

注意：本节点数据为JSON数组格式的，返回的用户额度信息以数组形式封装。

参数名称 类型 是否必填 说明
productType Int（1） 是 手机贷产品类型标记
1、现金单期
2、现金分期
amountFlag int(1) 是 额度标记
0：未计算
1：已计算
2：计算中
productAmount Float 否 授信额度
  • 【请求报文示例】
{
    "userCode": "20170629526131"
}
  • 【响应报文示例】
{
    "userAmount": [
        {
            "productType": 1,
            "amountFlag": 1,
            "productAmount": "1000"
        },
        {
            "productType": 2,
            "amountFlag": 1,
            "productAmount": "8000"
        }
    ]
}

2、查询用户订单信息接口

  • [接口说明]

本接口提供给合作机构查询用户订单基本信息（借贷信息、状态信息、费用信息），不包含贷后信息，贷后信息请对接还款计划接口。

说明：该接口和返回的数据信息根据合作需要做定制化开放。

  • [技术要求]

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

  • [服务名称] getBorrowInfo
  • [请求业务数据报文-reqData参数说明]
参数名称 类型 是否必填 说明
userCode String(32) 是 手机贷分配的用户编号。
有调用同步用户信息接口生成返回。
borrowId String(32) 是 手机贷生成的匹配订单号
  • [响应业务数据报文-data参数说明]
参数名称 类型 是否必填 说明
borrowAmount Double 否 借款金额
productType Int（1） 否 手机贷产品类型标记
1、现金单期
2、现金分期
borrowPeriod int(6) 是 借款周期
单期：单位（天）
分期：单位（期数）
borrowTime String（18） 否 借款申请时间
格式（年-月-日 时：分：秒）
例如：
2017-07-30 12:23:23
status int（1） 否 手机贷产品订单状态
0：申请中
1：申请审核成功
2：申请审核失败
3：放款成功
4：放款失败
5：还款成功
注意：该状态信息根据合作需要定制化返回。
totalFee Double 否 总费用
总费用=服务费+利息+逾期费用-减免费用。
保留小数点后两位
  • 【请求报文示例】
{
    "userCode": "20170629526131",
    "borrowId": "201703220000000006"
}
  • 【响应报文示例】
{
    "borrowAmount": "1000",
    "productType": 1,
    "borrowPeriod": 8,
    "borrowTime": "2017-07-30 12:23:23",
    "status": 1,
    "totalFee": "26"
}

3、查询用户还款计划接口

  • [接口说明]

用户在合作机构平台发起借款，手机贷成功放款后，会提供订单还款计划明细给合作机构进行查询，以便合作机构引导用户做还款操作。

说明：该接口和返回的数据信息根据合作需要做定制化开放。

  • [技术要求]

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

  • [服务名称] getRepayInfo
  • [请求业务数据报文-reqData参数说明]
参数名称 类型 是否必填 说明
userCode String(32) 是 手机贷分配的用户编号。
有调用同步用户信息接口生成返回。
borrowId String(32) 是 手机贷生成的匹配订单号
  • [响应业务数据报文-data参数说明]
参数名称 类型 是否必填 说明
productType Int（1） 否 手机贷产品类型标记
1、现金单期
2、现金分期
borrowTime String（18） 否 借款申请时间
格式（年-月-日 时：分：秒）
例如：
2017-07-30 12:23:23
borrowAmount double 否 借款金额
单位：元
repayTotalAmount Double 否 应还款总金额
该订单所有账期到目前为止已发生的账单总金额，包含本金、费用及其它。
单位：元
borrowPeriod int(6) 否 借款周期
单期：单位（天）
分期：单位（期数）
repayInfoList JSON Array 否 订单每期还款计划明细
单期仅会生成一条记录，分期会有多笔记录。
此节点的数据格式为JSON Array封装,具体参数明细请参考下面的[响应业务数据报文- repayInfoList参数说明]
  • [响应业务数据报文-repayInfoList参数说明]

注意：本节点数据为JSON数组格式的，返回的订单还款计划信息以数组形式封装。

参数名称 类型 是否必填 说明
repayPeriod int(6) 否 还款期数序列号
序号从1开始，如果是单期则就只有1，多期则会按照期数枚举序号
repayAllMoney Double 否 本期应还款总金额
包含本金、利息、已发生的金额等。
单位：元
repayTime String(12) 否 本期应还时间
格式（年-月-日）
例如：2017-07-30
repayRealTime String(12) 否 本期实际还款时间
格式（年-月-日）
例如：2017-07-30
repayStatus String(30) 否 本期账单状态
0、未还款
1、已还款
  • 【请求报文示例】
{
    "userCode": "20170629526131",
    "borrowId": "201703220000000006"
}
  • 【响应报文示例】
{
    "productType": 1,
    "borrowTime": "2017-07-30 12:23:23",
    "borrowAmount": "1000",
    "repayTotalAmount": "1026",
    "borrowPeriod": 8,
    "repayInfoList": [
        {
            "repayPeriod": 1,
            "repayAllMoney": "1026",
            "repayTime": "2017-07-30",
            "repayRealTime": "2017-07-30",
            "repayStatus": 1
        }
    ]
}

4、查询协议接口

  • [接口说明]

合作机构平台若需要显示手机贷的注册、借贷协议，通过该接口返回手机贷对应协议模板页面URL,合作机构引导用户跳转到该协议页面并呈现。

**说明：手机贷协议页面上有回退按钮控制，如果是合作机构平台采用iframe框架嵌入的手机贷协议页面，需要在手机贷返回的协议页面URL后面添加一个target参数，参数值为合作机构平台方的回退页面URI地址，需要做encode编码。

例如：http(s)://{手机贷提现协议地址}?target=https%3A%2F%2Fjin.baidu.com%2Floan%2Fapply%2Fresult%3Forder_id%3D17041168033450043**

  • [技术要求]

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

  • [服务名称] getProtocol
  • [请求业务数据报文-reqData参数说明]
参数名称 类型 是否必填 说明
userCode String(32) 否 手机贷分配的用户编号。
有调用同步用户信息接口生成返回。
说明：如果是注册协议，则允许为空；若是借贷协议则为必填项。
potocolType String(1) 是 协议类型：
1、注册协议
2、借贷协议
  • [响应业务数据报文-data参数说明]
参数名称 类型 是否必填 说明
url String(255) 是 手机贷提供的WEB版协议地址
  • 【请求报文示例】
{
    "userCode": "20170629526131",
    "potocolType": 2
}
  • 【响应报文示例】
{
    "url": "http://116.228.32.182:7070/wap/borrow/agreementListPure"
}

5、查询支持的银行卡列表接口

  • [接口说明]

合作机构需要根据用户支持的银行卡列表，限制用户绑卡支持的范围。 该接口的数据可根据实际需要缓存，无需频繁调用，这部分数据变更极少。

  • [技术要求]

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

  • [服务名称] getSupportBankList
  • [请求业务数据报文-reqData参数说明]
参数名称 类型 是否必填 说明
userCode String(32) 否 手机贷分配的用户编号。
有调用同步用户信息接口生成返回。
  • [响应业务数据报文-data参数说明]
参数名称 类型 是否必填 说明
bankList JSON Array 是 手机贷支持的银行列表
此节点的数据格式为JSON Array封装,具体参数明细请参考下面的[响应业务数据报文- bankList参数说明]
  • [响应业务数据报文- bankList参数说明]

注意：本节点数据为JSON数组格式的，返回的支持的银行卡列表信息以数组形式封装。

参数名称 类型 是否必填 说明
bankName String(30) 是 银行名称
例如：中国建设银行
  • 【请求报文示例】
{
    "userCode": "20170629526131"
}
  • 【响应报文示例】
{
    "bankList": [
        {
            "bankName": "中国银行"
        },
        {
            "bankName": "中国农业银行"
        },
        {
            "bankName": "中国建设银行"
        },
        {
            "bankName": "中国工商银行"
        }
    ]
}
⚠️ **GitHub.com Fallback** ⚠️