审核异步通知 - 星富通科技有限公司

功能说明

进件审核进入终态（SUCCESS/REJECTED）时，平台主动以 HTTP POST 方式通知进件提交时上送的 back_url。中间态（AUDITING/PROCESSING）不下发通知，请通过进件状态查询获取。

通知时机

触发条件	说明
SUCCESS	渠道进件完成、微信/支付宝子商户号（`sub_merchant_code`）就绪后下发
REJECTED	平台审核驳回后下发，`reject_reason` 非空

通知报文

请求头（平台 → 渠道商，与请求签名同一机制）：

Header	说明
`Content-Type`	`application/json`
`Client-Id`	平台侧 app_key（与渠道商凭据配对）
`Signature-Type`	固定 `HmacSHA256`
`Timestamp`	通知时间，秒级时间戳
`Nonce-Str`	随机串
`Signature`	通知签名，验签方式见签名验签说明

请求体：

字段	是否必选	字段类型	字段说明
`out_apply_no`	是	String	申请单号
`merchant_code`	否	String	平台商户号，通过后下发
`sub_merchant_code`	否	String	微信/支付宝子商户号，渠道进件成功后下发
`apply_status`	是	String	终态：`SUCCESS` / `REJECTED`
`reject_reason`	否	String	驳回原因，驳回时非空（标注平台驳回/渠道驳回）
`channel_ret_code`	否	String	渠道侧原始返回码，透传，可为空
`timestamp`	是	int64	通知时间，秒级时间戳

应答要求

项	约定
成功	返回 HTTP 2xx 即视为通知送达，body 任意
失败	非 2xx 或超时，平台按指数退避重试：1min → 5min → 30min → 2h → 6h，最多 5 次
最终失败	通知落库，渠道商可联系平台人工补发

幂等：平台可能重发通知（网络原因），渠道商按 out_apply_no + apply_status 去重，重复通知不重复处理。

示例

通知请求（平台 → 渠道商）

{
  "out_apply_no": "P20260815001",
  "merchant_code": "M202608150001",
  "sub_merchant_code": "1900000101",
  "apply_status": "SUCCESS",
  "reject_reason": "",
  "channel_ret_code": "",
  "timestamp": 1755320400
}

通知请求（驳回）

{
  "out_apply_no": "P20260815001",
  "merchant_code": "",
  "sub_merchant_code": "",
  "apply_status": "REJECTED",
  "reject_reason": "营业执照信息与工商登记不一致",
  "channel_ret_code": "",
  "timestamp": 1755312000
}

渠道商应答

HTTP/1.1 200 OK

通知地址 back_url 必须为 HTTPS 且长期可达；收到通知后建议先落库，再应答 2xx，避免处理失败导致平台重试产生重复业务。

​功能说明

​通知时机

​通知报文

​应答要求

​示例

功能说明

通知时机

通知报文

应答要求

示例