回调即为平台主动向业务方发起提现/充值的通知请求,收到通知后,业务方再做相应的业务逻辑处理。 业务方需充分知悉回调的规则,根据回调内容做出正确的处理,如需了解详细的回调机制,点击 这里 了解更多。

回调请求

  • 平台回调的请求与商户主动请求接口中的签名方式和数据结构保持一致。
  • 如果你需要对回调接口进行鉴权及签名验证,可在商户后台生成回调的API key/Secret。
  • 可通过回调参数中的 webhookType 判断是提现还是充值回调,不同类型回调的内容不同。
  • 不管是收款还是付款,一笔订单通常会有两次回调,根据回调参数中的 status 进行判断:
    • statusAwaitingConfirmation 时,为第一次回调。
    • statusSuccessFailed 时,为第二次回调。
如果业务中不需要显示订单的AwaitingConfirmation的状态,那么您可以忽略第一次回调,因为它只是一笔订单中可变的中间状态。

回调响应

对于回调,您需要使用不带正文的 HTTP 状态码 200 进行响应。如果服务器暂时不可用或者响应状态不是 200,我们将随着延迟时间的增加多次重新发送回调;重新发送次数是有限的。超过一定次数后回调将失败,如果需要重发,您需要在商户后台的“交易回调”中进行手动推送。
您可以使用 requestcatcher.com 工具方便地进行回调测试.