Webhook

Webhook 是关于系统中发生事件的通知。当发生特定事件时，艾克索拉会发送一个 HTTP 请求，将事件数据传递到您的游戏服务器。这些 Webhook 对于游戏客户端和/或服务器接收成功和失败支付以及用户身份验证尝试的通知至关重要。

在发布商帐户中设置 Webhook

启用 Webhook

1. 在发布商帐户中打开您的项目。
2. 点击侧边菜单中的项目设置，并导航到 Webhook 标签。
3. 在 Webhook 服务器 字段中，指定您希望接收 Webhooks 的服务器 URL，格式为 https://example.com。您还可以指定在 Webhook 测试工具中找到的 URL。
4. 项目 Webhook 的密钥会默认生成。如果您想生成新的密钥，请点击刷新图标。
5. 点击启用 Webhook。

禁用 Webhook

1. 在发布商帐户中打开您的项目。
2. 点击侧边菜单中的项目设置，并导航到 Webhook 标签。
3. 点击禁用 Webhook。

支付 Webhook

提示

有关所有 Webhook 的更多信息，请参阅此处。

在支付标签中，您可以测试以下 Webhook：

用户验证（user_validation）

curl -v 'https://your.hostname/your/uri' \
-X POST \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-H 'Authorization: Signature 13342703ccaca5064ad33ba451d800c5e823db8f' \
-d '{
    "notification_type":"user_validation",
    "settings": {
      "project_id": 18404,
      "merchant_id": 2340
    },
    "user": {
        "ip": "127.0.0.1",
        "phone": "18777976552",
        "email": "email@example.com",
        "id": "1234567",
        "name": "John Smith",
        "country": "US"
    }
}'

支付（payment）

curl -v 'https://your.hostname/your/uri' \
-X POST \
-d '{
    "notification_type": "payment",
    "settings": {
      "project_id": 18404,
      "merchant_id": 2340
    },
    "purchase": {
        "subscription": {
            "plan_id": "b5dac9c8",
            "subscription_id": "10",
            "product_id": "Demo Product",
            "date_create": "2014-09-22T19:25:25+04:00",
            "date_next_charge": "2014-10-22T19:25:25+04:00",
            "currency": "USD",
            "amount": 9.99
        },
        "checkout": {
            "currency": "USD",
            "amount": 50
        },
        "total": {
            "currency": "USD",
            "amount": 200
        },
        "promotions": [{
            "technical_name": "Demo Promotion",
            "id": 853
        }],
        "coupon": {
            "coupon_code": "ICvj45S4FUOyy",
            "campaign_code": "1507"
        },
        "order": {
          "id": 1234
          "lineitems": [
              {
                "sku": "test_1",
                "quantity": 1,
                "price": {
                  "currency": "EUR",
                  "amount": 6.5
                  }
              }
          ]
        }
    },
    "user": {
        "ip": "127.0.0.1",
        "phone": "18777976552",
        "email": "email@example.com",
        "id": "1234567",
        "name": "John Smith",
        "country": "US"
    },
    "transaction": {
        "id": 1,
        "external_id": 1,
        "payment_date": "2014-09-24T20:38:16+04:00",
        "payment_method": 1,
        "payment_method_name": "PayPal",
        "payment_method_order_id": 1234567890123456789,
        "dry_run": 1,
        "agreement": 1
    },
    "payment_details": {
        "payment": {
            "currency": "USD",
            "amount": 230
        },
        "vat": {
            "currency": "USD",
            "amount": 0,
            "percent": 20
        },
        "sales_tax": {
            "currency": "USD",
            "amount": 0,
            "percent": 0
        },
        "direct_wht": {
            "currency": "USD",
            "amount": 0,
            "percent": 0
        },
        "payout_currency_rate": "1",
        "payout": {
            "currency": "USD",
            "amount": 200
        },
        "xsolla_fee": {
            "currency": "USD",
            "amount": 10
        },
        "payment_method_fee": {
            "currency": "USD",
            "amount": 20
        },
        "repatriation_commission": {
            "currency": "USD",
            "amount": 10
        }
    },
    "custom_parameters": {
        "parameter1": "value1",
        "parameter2": "value2"
    }
}'