项目移除Webhook
Aghanim提供了一个集中的Webhook,提醒您的游戏从玩家账户中移除项目。
在以下情况下触发此Webhook:
- 银行或支付系统在游戏中心撤销了玩家的交易
- 通过Aghanim仪表板的交易部分请求交易退款
每个事件都包含一个reason字段,解释项目移除的理由。

要求
要使用Aghanim的item.remove Webhook,您应该按以下方式配置Webhook服务器:
- HTTPS端点,接受POST Webhook请求。
- 监听由Aghanim生成和签名的事件。
- 处理Webhook负载中包含的
idempotency_key,以防止重复Webhook处理。 - 根据情况从玩家账户中移除被撤回或退款订单的项目,或执行其他所需的操作。
- 以2xx状态码响应以表示处理成功,若拒绝或出错则使用4xx或5xx。
配置
以下是处理Aghanim Webhook的端点函数模板,提醒您的游戏移除项目:
一旦您的功能准备好:
- 使您的端点可用。
- 在Aghanim账户中注册您的端点 → 游戏 → Webhooks → New Webhook,选择相应的事件类型。
或者,您可以使用创建Webhook API方法在Aghanim中注册您的端点。
事件数据模式
| 键 | 类型 | 描述 |
|---|---|---|
player_id | string | 用于玩家身份验证选择的唯一玩家ID。 |
items | Item[] | 从玩家账户中移除的一组项目。 |
reason | string | 触发Webhook的可读理由。 示例:订单退款 ord_eCacAulggpY。 |
item_id | string | [已弃用] Aghanim生成的项目ID。 |
sku | string | [已弃用] 在游戏和Aghanim端匹配的项目SKU。 |
需要帮助吗?
联系我们的集成团队 integration@aghanim.com