介绍


关于webhook 商家如果想要收到waaslite系统的webhook通知,需先调用 /open/webhook/set接口来创建webhook相关的配置。 本系统有多种webhook推送类型,均以 type 的值作为事件的区分:

  • deposit: 钱包地址充值事件
  • withdraw:商户风险钱包地址提现事件
  • gas: 钱包地址收到gas 充值事件
  • gather_order: 钱包归集事件
  • gathering:在钱包归集过程中,被归集的钱包地址的转账事件
  • one_time_payment_order_callback: 一次性支付订单事件
  • transfer_gathering: 一次性支付订单的收款地址向商户风险钱包地址转账的提现事件
  • user_kyc: 用户kyc 事件
  • screening_report:钱包评估报告事件

关于webhook签名和请求: 参考webhook 签名和请求 文章。

关于webhook重试

  • success :当请求webhook url 时,waas lite 系统只会根据webhook url返回的内容 success 进行判断,只要返回的内容是 success 字符串,系统将不会再进行重试操作,其他字符串将会触发重试机制。
  • 其他字符串:其他字符串将会触发重试机制。

当触发重试webhook时,系统将会根据触发的次数依次延长重发时间:

  • 第一次:将会3秒后重发
  • 第二次:将会5秒后重发
  • 第三次:将会10秒后重发
  • 第四次:将会15秒后重发
  • 第五次:将会15秒后重发 第五次后,将不会再次重发,也就是说触发重试只有5次。

注意:

1、如果商户没设置webhook,系统将不会向商户进行任何的推送

2、one time payment订单完成时,为了兼容原来的callback处理,系统将会使用原来的方式和webhook机制同时向商户进行推送,请商户尽快完成切换。

3、请注意,one time payment 订单完成时的callback处理,原来的方式使用api_secret_key进行签名,webhook机制则使用webhook_secret_key 进行签名,如混淆了则签名验证将会失败。