概览

如果使用 webhook,您会收到艾克索拉交易事件的通知。可以使用 webhook 自动化后台及管理功能,例如提供状态和其他交易相关信息。

我们为支付操作使用Webhook,包括购买虚拟货币、虚拟物品、游戏、实体商品等。

很多情况下,触发 webhook 的操作是在您的网站上发生的用户操作。不过,其他操作也可以触发 webhook。例如,您的网站的后台流程可能调用会退回付款的 API 方法,或者支付系统可能会发送存在争议付款的通知。

您接收到 webhook 并使用监听器(有时也称作处理器,它是您编写的一个程序)处理它们。该程序等待 webhook 并(通常)将其传递到恰当响应的管理流程。

例如,收到Webhook后您可以执行以下操作:

  • 充值用户余额
  • 向用户解锁新物品
  • 向用户配送实体商品

您应接受来自以下IP地址的webhook:185.30.20.0/24185.30.21.0/24185.30.23.0/24

Notice: 数据库中不得同时包含两个具有相同ID的成功交易。如果收到的Webhook的交易ID在数据库中已存在,则监听器应返回该次交易的上次处理结果。请避免向用户重复扣款或在数据库中创建重复记录。

不能保证监听器能百分之百收到发送的所有Webhook。由于网络连接无法100%可靠,Webhook可能会丢失或延迟。此外,对于您服务器上的暂时错误,监听器可能返回HTTP响应代码5xx。例如,如果用户成功购买了一件虚拟物品但该物品未添加至用户的物品库,则监听器返回HTTP响应代码500。

为减少消息丢失的风险,艾克索拉提醒服务采用重试机制。对于未送达的消息,服务将按照以下频率重新发送:

  • 2次间隔5分钟发送
  • 7次间隔15分钟发送
  • 10次间隔60分钟发送
重发的Webhook可能在上一个Webhook发送后的12小时内发送。重试的最大次数是20次。

Note: 请注意,尽管网络连接可能导致出错,但最有可能导致丢失、延迟或重复Webhook的原因是监听器本身存在逻辑问题。
本文对您的有帮助吗?
谢谢!
我们还有其他可改进之处吗? 留言
非常抱歉
请说明为何本文没有帮助到您。 留言
感谢您的反馈!
我们会查看您的留言并运用它改进用户体验。
为此页面评分
为此页面评分
我们还有其他可改进之处吗?

不想回答

感谢您的反馈!
上次更新时间: 2021年8月4日

发现了错别字或其他内容错误? 请选择文本,然后按Ctrl+Enter。

报告问题
我们非常重视内容质量。您的反馈将帮助我们做得更好。
请留下邮箱以便我们后续跟进
感谢您的反馈!