跳至主要内容

如何使用阿哈利姆通过游戏客户端购买商品

本指南提供了使用阿哈利姆 API 通过游戏客户端从游戏枢纽购买商品的详细步骤。

前提条件

  • API Key：用于验证您的 API 请求。
  • 集成 item.add Webhook：确保已集成 item.add Webhook 以处理已购买的商品。

第 1 步：在游戏服务器上创建订单

当玩家在游戏客户端中点击“购买”按钮时，客户端应向游戏后端后端发送消息创建订单。 这通过使用服务器到服务器 (S2S) API 向 Create Order 端点发送POST 请求来实现。

Request Schema

POST 请求的数据负载必须包含以下字段：

字段名类型描述必填项
player_idstring进行购买的玩家唯一 ID。是
itemsItem[]玩家想要购买的商品列表。是
ip_addressstring进行购买的玩家 IP 地址。否
user_agentstring进行购买的玩家玩家代理信息。否
localestring进行购买的玩家区域设置。否
countrystring进行购买的玩家所在国家/地区。否

Item Object Schema

items 数组中的每个商品都应符合以下 Schema：

字段名类型描述必填项
idstring商品的唯一 ID。是
skustring商品的库存单位 (SKU)。是
namestring商品的名称。是
pricenumber商品价格（以小额货币单位表示）。是
currencystring商品价格的货币类型。是
image_urlstring商品图片的 URL。否
descriptionstring商品的描述信息。否
quantitynumber要购买的商品数量。否
discount_percentnumber应用于商品的折扣百分比。否
bonus_percentnumber应用于商品的额外奖励百分比。否

请求示例

以下是使用 curl 发送 POST 请求创建订单的示例：

curl -X POST https://api.aghanim.com/s2s/v1/orders \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <YOUR_API_KEY>' \
  -d '{
        "player_id": "2D2R-OP3C",
        "items": [
          {
            "id": "093431513412",
            "sku": "crystals",
            "name": "水晶",
            "price": 9499,
            "currency": "USD",
            "image_url": "https://example.com/crystals.png",
            "description": "拿下这款豪华水晶宝藏，主宰游戏世界。",
            "quantity": 480000
          }
        ]
    }'

响应示例

订单创建成功后，服务器将返回一个 order_id：

{"order_id": "ord_eCacpFwavzi"}

第 2 步：在游戏客户端中打开支付对话框

创建订单后，您可以在游戏客户端中调用 JavaScript 函数 aghanim.purchase(orderId) 来打开购买对话框。

函数调用示例

aghanim.purchase('ord_eCacpFwavzi');

该函数会触发游戏内购买流程，让玩家能够完成交易。

需要技术支持？
联系我们的集成技术团队： [email protected]

On this page