Appearance
融资申请结果通知
接口说明
系统异步通知融资申请审批结果
接口地址
由第三方提供(与 channel 对应)
请求方法
POST
请求加密说明
重要:系统发送的通知请求同样会进行加密,加密方式与第三方调用粒粒通接口时的加密规范完全一致。
请求结构(加密后)
第三方收到的完整请求结构(data 字段已加密):
json
{
"channel": "CHANNEL_CODE",
"requestTime": 1766729397120,
"key": "SM2加密的SM4密钥",
"salt": "SM2加密的SM4 IV",
"sign": "请求签名",
"data": "SM4加密后的业务数据"
}解密流程
第三方收到通知后,需要按以下步骤解密:
- 验证签名:验证
sign字段,确保请求来自粒粒通系统 - 解密密钥:使用自己的 SM2 私钥解密
key字段,得到 SM4 密钥 - 解密 IV:使用自己的 SM2 私钥解密
salt字段,得到 SM4 IV - 解密业务数据:使用 SM4 密钥和 IV 解密
data字段,得到业务数据
请求参数 (data 解密后)
json
{
"action": 20001,
"transactionId": "通知幂等ID",
"data": {
"loanOrderId": 3000001,
"memberId": 1000001,
"projectId": 1,
"orderStatus": 2,
"loanAmount": 10000000,
"outerBusinessId": "LOAN20250111001",
"rejectReason": null
}
}请求字段说明
| 字段名 | 类型 | 说明 |
|---|---|---|
| action | Integer | 通知类型:20001-融资申请结果通知 |
| transactionId | String | 通知幂等ID |
| data.loanOrderId | Long | 融资订单ID |
| data.memberId | Long | 成员ID |
| data.projectId | Long | 项目ID |
| data.orderStatus | Integer | 订单状态:1-待审批,2-审批通过,3-审批拒绝,4-已放款,5-已撤销,6-还款中,7-已结清 |
| data.loanAmount | Long | 融资金额(分) |
| data.outerBusinessId | String | 外部流水号 |
| data.rejectReason | String | 拒绝原因(审批拒绝时返回) |
响应参数
重要:第三方回调接口必须返回成功响应,格式如下:
json
{
"code": 0
}| 字段名 | 类型 | 说明 |
|---|---|---|
| code | Integer | 必须为 0,表示接收成功 |
说明:
- 响应报文使用明文返回,无需加密
- 响应必须返回
{"code": 0},否则系统会认为通知失败并触发重试 - 不需要返回其他字段(message、data 等)
- 第三方需要做好幂等处理,相同 transactionId 的通知可能重复接收