充值Webhook
接口描述
当充值订单完成后,如果提交订单时填写了通知地址(notifyUrl),平台会向该地址发送通知请求。
- 接口地址:由订单接口中的
notifyUrl参数决定 - 请求方式:POST
- Content-Type:application/json
请求参数
| 参数名称 | 必填 | 示例 | 说明 |
|---|---|---|---|
| orderNo | 是 | 1448538596381429760 | 平台订单号 |
| merOrderNo | 是 | 1448535323381429760 | 商户订单号 |
| status | 是 | 3 | 订单状态:1-处理中,2-成功,3-失败 |
| failReason | 否 | 处理失败 | 失败原因,仅在status=3时可能有 |
| completeTime | 是 | 20220331121212 | 订单完成时间 |
| createTime | 是 | 20220331121212 | 订单创建时间 |
| settleAmount | 是 | 20 | 结算金额 |
| appKey | 是 | edy2378eh23gf29w2 | appKey |
| sign | 是 | a87694dbd3be64a356a42be95e123360 | 接口签名 |
| ext | 否 | “” | 订单额外信息,预留字段 |
响应示例
接口返回内容需为字符串:ok
ok
注意事项
- 如果接口未按要求返回
ok,平台会认定为推送失败。 - 推送失败时,采用指数退避重试机制:
- 首次失败后,每隔 1分钟 重试一次,连续重试最多 5次 (即共6次)。
- 如果仍未收到正确响应,则在最后一次失败后 10分钟 后再次进行推送。
- 若依然失败,平台会停止进一步自动推送,请及时排查并手动处理相关通知。