借款申请 - qianlongjinrong/Shoujidai-Yundaitong GitHub Wiki
- [接口说明]
合作机构在发起借款之前需要从手机贷拉取对应的产品配置信息，如借款金额、借款期限等来组织借款信息。方便合作机构精准化借贷。
- [技术要求]
接口采用HTTP POST方式，数据组织采用JSON传递。
- [服务名称] getProductTemplate
- [请求业务数据报文-reqData参数说明]
| 参数名称 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| userCode | String(32) | 是 | 手机贷分配的用户编号。 有调用同步用户信息接口生成返回。 |
| productType | Int（1） | 是 | 要获取的产品模板类型 1、单期 2、分期 3、单期和分期 |
- [响应业务数据报文-data参数说明]
| 参数名称 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| productTemplate | JSON Array | 是 | 对应借贷产品的模板信息此节点的数据格式为JSON Array封装,具体参数明细请参考下面的[响应业务数据报文- productTemplate参数说明] |
- [响应业务数据报文-productTemplate参数说明]
注意：本节点数据为JSON数组格式的，返回的产品模板信息以数组形式封装。
| 参数名称 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| periodMin | int | 是 | 允许最小借款天数或期限 单期为天，分期为期限。 |
| periodMax | int | 是 | 允许最大借款天数或期限 单期为天，分期为期限 |
| amountMin | Float | 是 | 允许的最小借款金额 |
| amountMax | Float | 是 | 允许的最大借款金额 |
| amountStep | int(10) | 是 | 借款上下限进阶额度。为100的倍数，不能出现小数位数。 例如：某个用户的信用额度为1600，那么他可以选择的金额为1100,1200,1300,1400，1500,1600。 默认100为进阶基数。 |
- 【请求报文示例】
{
"userCode": "20170629526131",
"productType": 1
}- 【响应报文示例】
{
"productTemplate": [
{
"periodMin": 7,
"periodMax": 40,
"amountMin": "1000",
"amountMax": "5000",
"amountStep": 100
}
]
}- [接口说明]
合作机构可根据用户的借贷信息，通过该接口计算出用户在手机贷平台上应收服务费、费率、实际到账金额、应还金额等信息。
该接口根据合作要求，会有差异化返回处理。
- [技术要求]
接口采用HTTP POST方式，数据组织采用JSON传递。
- [服务名称] getBorrowFee
- [请求业务数据报文-reqData参数说明]
| 参数名称 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| userCode | String(32) | 是 | 手机贷分配的用户编号。 有调用同步用户信息接口生成返回。 |
| productType | Int（1） | 是 | 借贷产品类型 1、单期 2、分期 |
| borrowAmount | String(30) | 是 | 借款金额 单位：元 |
| borrowPeriod | int（6） | 是 | 借款天数或者期数 单期单位为天数，分期单位为期数。 |
- [响应业务数据报文-data参数说明]
| 参数名称 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| totalFee | Double | 是 | 总费用 总费用=服务费+利息 保留小数点后两位 |
| receivable | Double | 否 | 实际到账金额 |
| fee | Double | 否 | 应收服务费 保留小数点后两位 |
| interest | Double | 否 | 应收利息 保留小数点后两位 |
| repayAmount | Double | 否 | 每期应还款额 分期产品才会返回。 |
| borrowFee | Double | 否 | 每期费用 分期产品才会返回。 |
- 【请求报文示例】
{
"userCode": "20170629526131",
"productType": 1,
"borrowAmount": "1000",
"borrowPeriod": 8
}- 【响应报文示例】
{
"totalFee": "26",
"receivable": "1000",
"fee": "26",
"interest": "",
"repayAmount ": "1026",
"borrowFee ": ""
}- [接口说明]
合作机构将用户进件下单数据同步至手机贷，发起借款申请，若进件成功则进入手机贷的订单流程。后续有订单状态变更则会实时通知合作机构，在绑卡后，手机贷通过绑卡结果异步回调接口，将绑卡结果和额度信息返回给合作机构，只有绑卡成功和有额度的情况下，方可执行该接口的调用。
本接口支持单期和多期产品借款申请
- [技术要求]
接口采用HTTP POST方式，数据组织采用JSON传递。
- [服务名称] applyBorrow
- [请求业务数据报文-reqData参数说明]
| 参数名称 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| userCode | String(32) | 是 | 手机贷分配的用户编号。 有调用同步用户信息接口生成返回。 |
| userPhone | String（11） | 是 | 用户移动手机号码 有效长度为11位，不要带+86。 借款申请手机号码必须保证和初始化用户接口中的认证过的手机号保持一致。 |
| productType | Int（1） | 是 | 手机贷产品类型标记 1、现金单期 2、现金分期 |
| borrowAmount | String(20) | 是 | 借款金额 单位（元） 借款金额不能超过用户的信用额度以及在单期和分期产品模板中的上下限额度范围内。 |
| borrowPeriod | int(6) | 是 | 借款周期 单期：单位（天） 分期：单位（期数） 在手机贷产品模板配置信息中的上下限范围内。 |
| bankNo | String(32) | 是 | 借记卡号 经过绑卡认证过的用户借记卡。 |
| orderId | String(50) | 否 | 合作机构订单号有合作机构生成维护，做订单关联。 |
- [响应业务数据报文-data参数说明]
| 参数名称 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| borrowId | String(32) | 是 | 手机贷生成的匹配订单号 |
- 【请求报文示例】
{
"userCode": "20170629526131",
"userPhone": "15326578512",
"productType": 1,
"borrowAmount": "1000",
"borrowPeriod": 8,
"bankNo": " 6217880800005176559",
"orderId": "1704011445906302"
}- 【响应报文示例】
{
"borrowId": "201703270000000008"
}