跳到主要内容

项目移除Webhook

Aghanim提供了一个集中的Webhook,提醒您的游戏从玩家账户中移除项目。

在以下情况下触发此Webhook:

  • 银行或支付系统在游戏中心撤销了玩家的交易
  • 通过Aghanim仪表板的交易部分请求交易退款

每个事件都包含一个reason字段,解释项目移除的理由。

兑换代码Webhook图片兑换代码Webhook图片

要求

要使用Aghanim的item.remove Webhook,您应该按以下方式配置Webhook服务器:

  • HTTPS端点,接受POST Webhook请求。
  • 监听由Aghanim生成和签名的事件。
  • 处理Webhook负载中包含的idempotency_key,以防止重复Webhook处理。
  • 根据情况从玩家账户中移除被撤回或退款订单的项目,或执行其他所需的操作。
  • 以2xx状态码响应以表示处理成功,若拒绝或出错则使用4xx或5xx。

配置

以下是处理Aghanim Webhook的端点函数模板,提醒您的游戏移除项目:

一旦您的功能准备好:

  1. 使您的端点可用。
  2. 在Aghanim账户中注册您的端点 → 游戏 → Webhooks → New Webhook,选择相应的事件类型。

或者,您可以使用创建Webhook API方法在Aghanim中注册您的端点。

事件数据模式

类型描述
player_idstring用于玩家身份验证选择的唯一玩家ID
itemsItem[]从玩家账户中移除的一组项目。
reasonstring触发Webhook的可读理由。 示例:订单退款 ord_eCacAulggpY
item_idstring[已弃用] Aghanim生成的项目ID。
skustring[已弃用] 在游戏和Aghanim端匹配的项目SKU。

需要帮助吗?
联系我们的集成团队 integration@aghanim.com