Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

充值Webhook

接口描述

当充值订单完成后,如果提交订单时填写了通知地址(notifyUrl),平台会向该地址发送通知请求。

  • 接口地址:由订单接口中的 notifyUrl 参数决定
  • 请求方式:POST
  • Content-Type:application/json

请求参数

参数名称必填示例说明
orderNo1448538596381429760平台订单号
merOrderNo1448535323381429760商户订单号
status3订单状态:1-处理中,2-成功,3-失败
failReason处理失败失败原因,仅在status=3时可能有
completeTime20220331121212订单完成时间
createTime20220331121212订单创建时间
settleAmount20结算金额
appKeyedy2378eh23gf29w2appKey
signa87694dbd3be64a356a42be95e123360接口签名
ext“”订单额外信息,预留字段

响应示例

接口返回内容需为字符串:ok

ok

注意事项

  • 如果接口未按要求返回 ok,平台会认定为推送失败。
  • 推送失败时,采用指数退避重试机制:
    • 首次失败后,每隔 1分钟 重试一次,连续重试最多 5次 (即共6次)。
    • 如果仍未收到正确响应,则在最后一次失败后 10分钟 后再次进行推送。
    • 若依然失败,平台会停止进一步自动推送,请及时排查并手动处理相关通知。