Skip to content

融资申请结果通知

接口说明

系统异步通知融资申请审批结果

接口地址

由第三方提供(与 channel 对应)

请求方法

POST

请求加密说明

重要:系统发送的通知请求同样会进行加密,加密方式与第三方调用粒粒通接口时的加密规范完全一致。

请求结构(加密后)

第三方收到的完整请求结构(data 字段已加密):

json
{
  "channel": "CHANNEL_CODE",
  "requestTime": 1766729397120,
  "key": "SM2加密的SM4密钥",
  "salt": "SM2加密的SM4 IV",
  "sign": "请求签名",
  "data": "SM4加密后的业务数据"
}

解密流程

第三方收到通知后,需要按以下步骤解密:

  1. 验证签名:验证 sign 字段,确保请求来自粒粒通系统
  2. 解密密钥:使用自己的 SM2 私钥解密 key 字段,得到 SM4 密钥
  3. 解密 IV:使用自己的 SM2 私钥解密 salt 字段,得到 SM4 IV
  4. 解密业务数据:使用 SM4 密钥和 IV 解密 data 字段,得到业务数据

详细的加密规范请参考:接口加密规范接口鉴权说明

请求参数 (data 解密后)

json
{
  "action": 20001,
  "transactionId": "通知幂等ID",
  "data": {
    "loanOrderId": 3000001,
    "memberId": 1000001,
    "projectId": 1,
    "orderStatus": 2,
    "loanAmount": 10000000,
    "outerBusinessId": "LOAN20250111001",
    "rejectReason": null
  }
}

请求字段说明

字段名类型说明
actionInteger通知类型:20001-融资申请结果通知
transactionIdString通知幂等ID
data.loanOrderIdLong融资订单ID
data.memberIdLong成员ID
data.projectIdLong项目ID
data.orderStatusInteger订单状态:1-待审批,2-审批通过,3-审批拒绝,4-已放款,5-已撤销,6-还款中,7-已结清
data.loanAmountLong融资金额(分)
data.outerBusinessIdString外部流水号
data.rejectReasonString拒绝原因(审批拒绝时返回)

响应参数

重要:第三方回调接口必须返回成功响应,格式如下:

json
{
  "code": 0
}
字段名类型说明
codeInteger必须为 0,表示接收成功

说明

  • 响应报文使用明文返回,无需加密
  • 响应必须返回 {"code": 0},否则系统会认为通知失败并触发重试
  • 不需要返回其他字段(message、data 等)
  • 第三方需要做好幂等处理,相同 transactionId 的通知可能重复接收

粒粒通金融服务平台 API 文档