需合作机构方提供的接口 - 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"
}

  • 【响应报文示例】
待补充