Skip to content

Commit

Permalink
增加回调接口
Browse files Browse the repository at this point in the history
  • Loading branch information
DannyGe committed Jan 17, 2018
1 parent bbaed1c commit 2a50bc3
Show file tree
Hide file tree
Showing 3 changed files with 46 additions and 1 deletion.
2 changes: 1 addition & 1 deletion 2.1/05_app_create.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ loan\_app:app:create
| contacts | JSON(List) || 联系人信息(企业专用),见[联系人信息](#联系人信息) |
| fac | JSON || 资金需求信息 (企业、个人共用), 见[资金需求信息](#资金需求信息) |
| col | JSON(List) || 担保信息 (企业、个人共用), 见[担保信息](#担保信息) |
| callbackURL | String || 授信状态变更后通知回调URL,见[授信状态变更通知回调](#授信状态变更通知回调)|
| callbackURL | String || 授信状态变更后通知回调URL(如http://api.xxxx.com/ljt/callback),见[授信状态变更通知回调](#授信状态变更通知回调)|

### 企业借款人信息
| 名称 | 类型 | 是否必须 | 最大长度 | 描述 | 示例值 |
Expand Down
44 changes: 44 additions & 0 deletions 2.1/07_app_sts_call_back.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,44 @@
#授信状态变更通知回调
## 描述
如果在调用 [融资申请创建API](05_app_create.md) 时填写了 callbackURL 参数,当资金方反馈审批结果时,会通过此接口下发回调通知。
此接口统一使用 POST 请求进行参数传递,body 内容为明文,只要返回的 HTTP 返回的状态码为200即认为回调成功,否则会最多重试3次,每次间隔3分钟。
某个申请一旦回调成功,或回调重试次数达到3次,则不会再次通知(但可以通过[申请状态查询](2.1/10_app_sts.md)接口进行主动查询)。

## 请求参数
| 名称 | 类型 | 是否必须 | 最大长度 | 描述 | 示例值 |
| --- | --- | --- | --- | --- | --- |
| app_id | String || 50 | 申请ID([融资申请创建API](05_app_create.md)返回的结果) | 0092728480d24f5d87bf63639b5cfe1c |
| mt_app_sts_cd | String | 20 |申请状态代码,详细规则见:[申请状态](#申请状态) | APPROVED |
| remark | String | 200| 备注:当申请被退回或被取消时,返回退回或取消原因 | 风控审核未通过 |
| finalLimit | Number || 30 (26,4) |资金方批准的额度:当申请状态为已批准时不为空 | 30000 |
| finalRate | Number || 9 (5,4) |资金方批准的年利率:当申请状态为已批准时不为空 | 5.2 |
| finalIntRateInSuspense | Number || 9 (5,4) | 资金方批准的罚息利率:当申请状态为已批准时不为空 | 8.1 |
| finalTenureAppr | Number || 6 | 资金方批准的业务期限 | 12 |
| finalMtTimeCd | String || 1 | 资金方批准的业务期限类型(D-天、M-月、Y-年) | M |


###申请状态说明
| 申请类型 | 代码 | 描述 |
| --- | --- | --- |
| 企业融资申请 | APPROVED | 已批准,资金提供方已批准该笔融资申请 |
| 企业融资申请 | CANCELLED | 已取消,申请已经被人为取消,后续不能做任何操作 |
| 企业融资申请 | CP_PUSH_APP_PUSHED | 已推送,申请已发送到资金提供方,待对方审核 |
| 企业融资申请 | CP_PUSH_APP_RETURNED | 被退回,申请不满足风控审核,已资金提供方被退回 |
| 企业融资申请 | CREATED | 录入中,可以调用上传申请材料等接口,然后推送融资申请到资金提供方 |
| 个人融资申请 | APPROVED | 已批准,规则同企业融资申请 |
| 个人融资申请 | CANCELLED | 已取消,规则同企业融资申请 |
| 个人融资申请 | CREATED | 录入中,规则同企业融资申请 |
| 个人融资申请 | CS_PUSH_APP_PUSHED | 已推送,规则同企业融资申请 |
| 个人融资申请 | CS_PUSH_APP_RETURNED | 被退回,规则同企业融资申请 |


## 示例
### 请求示例
```javascript
{
"app_id":"0092728480d24f5d87bf63639b5cfe1c",
"mt_app_sts_cd":"APPROVED"
}
```
## FAQ
关于此文档暂时还没有FAQ
1 change: 1 addition & 0 deletions SUMMARY.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@
* [助贷风控(平台方)-贷前](2.1/00_pre_disb.md)
* [借款预申请创建](2.1/03_cs_pre_app_create.md)
* [融资申请创建](2.1/05_app_create.md)
* [授信状态变更通知回调](2.1/07_app_sts_call_back.md)
* [申请状态查询](2.1/10_app_sts.md)
* [可上传申请材料](2.1/13_doc_can_upload.md)
* [融资申请推送](2.1/20_app_push.md)
Expand Down

0 comments on commit 2a50bc3

Please sign in to comment.