需合作机构方提供的接口 - qianlongjinrong/Shoujidai-Yundaitong GitHub Wiki
1、订单状态回调接口
- [接口说明]
合作机构推送给手机贷上的进件订单有变更时,手机贷会通过该接口实时通知。
本接口需要有合作机构提供,按照手机贷的格式要求开发
- [技术要求]
接口采用HTTP POST方式,数据组织采用JSON传递。
- [服务名称] 示例:oderStatusCallBack
- [请求业务数据报文-reqData参数说明]
参数名称 | 类型 | 是否必填 | 说明 |
---|---|---|---|
borrowId | String(32) | 是 | 手机贷分配的用户编号。有调用同步用户信息接口生成返回。 |
status | int(1) | 否 | 手机贷产品订单状态0:申请中1:申请审核成功2:申请审核失败3:放款成功4:放款失败5:还款成功注意:该状态信息根据合作需要定制化返回。 |
orderMsg | String(50) | 否 | 订单处理描述消息。 |
- [响应业务数据报文-data参数说明]
合作机构平台不返回响应业务报文数据,手机贷会根据公共响应报文体中的status做处理,status=1代表处理成功,如果status=0,则会返回具体错误原因的错误码和错误描述,data报文不出现。
- 【请求报文示例】
{
"borrowId": "201703220000000006",
"status": 1,
"orderMsg": ""
}
- 【响应报文示例】
待补充
2、绑卡结果回调接口
- [接口说明]
手机贷将绑卡认证结果、额度等信息返回给合作机构方,根据反馈结果做对应的业务处理。 本接口有合作机构提供,参考手机贷的接口定义。
说明:该接口的数据信息根据合作需要做定制化开放。
- [技术要求]
接口采用HTTP POST方式,数据组织采用JSON传递。
- [服务名称] 示例:bindCardCallBack
- [请求业务数据报文-reqData参数说明]
参数名称 | 类型 | 是否必填 | 说明 |
---|---|---|---|
bindStatus | int(1) | 是 | 绑卡状态0、绑定失败1、绑定成功 |
singleAmount | Float | 否 | 手机贷单期产品授信额度例如:5000说明:该字段根据合作要求做定制化开放。如果为额度为0,则不允许发起单期借款申请。 |
multiAmount | Float | 否 | 手机贷分期产品授信额度例如:10000说明:该字段根据合作要求做定制化开放。如果为额度为0,则不允许发起分期借款申请。 |
- [响应业务数据报文-data参数说明]
合作机构平台不返回响应业务报文数据,手机贷会根据公共响应报文体中的status做处理,status=1代表处理成功,如果status=0,则会返回具体错误原因的错误码和错误描述,data报文不出现。
- 【请求报文示例】
{
"bindStatus": 1,
"singleAmount": "5000",
"multiAmount": "10000"
}
- 【响应报文示例】
待补充