回调说明
- 由平台通过HTTP的方式回到给开发者,在使用前请保证已经配置了应用的回调地址,或者接口中上送了回调地址。
- 发送POST请求,格式为 application/json
- 业务方需自行实现接受逻辑处理回调信息。
- 业务方在接受到回调请求后,需在 5秒 内返回。如果 5秒 内收不到响应会断掉连接,并重新发起请求。平台会在12小时内,通过一定的策略(通知频率为 0s/15s/15s/30s/3m/10m/20m/30m/30/30m/1h/3h/3h/3h )间接性重新发起通知,尽可能提高通知的成功率,但不保证通知最终能成功。
请求参数
| 名称 | 类型 | 签名 | 描述 |
|---|---|---|---|
| mchId | String | 是 | 开放平台分配的商户编号 |
| appId | String | 是 | 开放平台分配的应用ID |
| result | String | 是 | 通知参数的集合,经AES对称加密的base64格式字符串。解密后为接口响应返回的具体内容, json格式字符串。 |
| notifyType | String | 是 | 回调类型,见各业务接口 |
| sign | String | 否 | 签名 签名方法 |
| signType | String | 是 | 签名类型,默认填:SHA。(暂只支持SHA) |
响应参数
- 业务方接收到请求后,根据自身系统处理结果,返回平台纯字符串结果值,无需签名。
- 返回值如非"SUCCESS",平台将继续按策略重试发送通知。
| 返回结果 | 描述 |
|---|---|
| SUCCESS | 表示通知已经成功接收,无需再做处理。 |
| FAIL或其他字符 | 处理不成功,平台将重试发送通知。 |
请求示例
{
"mchId": "mchId_bb5ca28885aa",
"appId": "appId_04c670a31395",
"signType": "SHA",
"sign": "sign_5c7867132791",
"result": "result_0d82107ae719",
"notifyType": "GYAPIPAYRESULT"
}