设置游戏密钥销售

Buy Button可让您在游戏网站上以真实货币或虚拟货币的形式来销售游戏密钥，从而实现游戏的变现。

您可以向未授权和授权用户销售游戏密钥。

对于未授权用户

用户进行购买时受以下条件限制：

• 不能使用权利系统。
• 支付方式和艾克索拉余额不会在艾克索拉支付中心保存。

对于授权用户

要管理用户对您的应用程序以及艾克索拉产品功能的访问权限，请设置用户认证系统。对此，您可以使用艾克索拉登录管理器或实现自有认证系统。

如果您已实现了自有认证系统而仅需要支付UI，可以生成支付中心访问令牌并在您的服务器上设置Webhook。

如果没有自己的服务器或希望使用现成解决方案，可为您的游戏内商店使用艾克索拉登录管理器。以下功能在艾克索拉侧执行：

• 存储及管理目录
• 管理结果
• 存储区域价格的数据
• 认证用户
• 处理交易

通过艾克索拉登录管理器进行认证

艾克索拉登录管理器支持用于用户注册和认证的OAuth 2.0标准协议。标准OAuth 2.0协议有助于简化客户端侧应用程序的开发。OAuth 2.0可让您在无需用户参与的情况下更新访问令牌。

已授权用户的数据可存储在以下地方：

• 艾克索拉存储中。请参阅艾克索拉登录管理器入门指南进行设置。
• PlayFab数据库中。请参阅PlayFab存储方法详解进行设置。
• 自定义存储中。请参阅自定义存储方法详解进行设置。

通过支付中心访问令牌认证

您的客户端与艾克索拉服务器间的交互过程如下：

1. 您的客户端向您的服务器发送认证请求。
2. 您的服务器向艾克索拉服务器请求认证令牌并向其发送包含project_id/merchant_id和api_key参数的头。
3. 艾克索拉服务器返回支付中心访问令牌。
4. 您的服务器将支付中心访问令牌传入您的客户端。
5. 返回的支付中心访问令牌在游戏内商店和Buy Button API及生成商店界面中用作进行认证的授权令牌。

获取支付中心访问令牌

在应用程序后端，请实现通过HTTP POST请求来获取支付中心访问令牌的方法。

艾克索拉API使用基本HTTP 认证。请求必须包含Authorization: Basic <your_authorization_basic_key>头，其中<your_authorization_basic_key>是按照Base64标准加密的商户ID: API密钥对。请前往发布商帐户找到这些参数：

• 商户ID在以下位置显示：
  • 在项目设置 > Webhooks部分。
  • 在公司设置 > 公司部分。
  • 在发布商帐户任意页面的浏览器地址栏的URL中。URL的格式如下：https://publisher.xsolla.com/​商户ID/发布商帐户部分。

• API密钥仅在创建它时在发布商帐户中显示一次，必须存储在己侧。您可以在以下部分中创建新的密钥：
  • 公司设置 > API密钥
  • 项目设置 > API密钥

HTTP请求：

POST https://api.xsolla.com/merchant/v2/merchants/{merchant_id}/token

要获取令牌，请将以下参数传入请求正文：

请求和响应示例见API参考。

与游戏内商店和物品库交互时支付中心访问令牌的有效期是距上次调用艾克索拉API之后1小时。如要更改支付中心访问令牌的有效期，请联系您的帐户经理。

实现令牌过期后重新获取支付中心访问令牌的逻辑。建议在后台获取新令牌，这样用户就无须重新登录应用程序。

您可以通过直接链接、商店UI或小组件销售游戏密钥。

通过直接链接销售

以下链接将打开支付UI：

https://purchase.xsolla.com/pages/buy?type={YOUR-ITEM-TYPE}&project_id={YOUR_PROJECT_ID}&sku={YOUR-ITEM-SKU}

将以下数据添加到链接：

• YOUR-ITEM-TYPE — 商品类型：
  • game — 游戏；game_key — 指定平台上的游戏。
  • bundle — 捆绑包。
• YOUR-PROJECT-ID — 您在发布商帐户中项目设置 > 常规设置 > 项目ID部分的项目ID。
• YOUR-ITEM-SKU — 游戏密钥套餐SKU。要在指定平台上销售游戏，请用获取游戏列表（该SKU一般类似于unit_name_drm_sku）来获取SKU。

• 支付UI样式：主题（深色或默认的浅色主题）、大小及其他参数。在URL中指定ui_settings参数并传入Base64编码的settings.ui JSON对象作为值。以下为包含UI设置的URL示例：

https://purchase.xsolla.com/pages/buy?type={YOUR-ITEM-TYPE}&project_id={YOUR_PROJECT_ID}&sku={YOUR-ITEM-SKU}&ui_settings=ewoJCQkic2l6ZSI6ICJzbWFsbCIsCgkJCSJ0aGVtZSI6ICJkYXJrIgoJCX0=

• 用于传递用户数据的令牌。仅当向通过认证的用户销售游戏密钥时使用。此令牌取决于认证方式。包含令牌的URL示例：

https://purchase.xsolla.com/pages/buy?type={YOUR-ITEM-TYPE}&project_id={YOUR_PROJECT_ID}&sku={YOUR_ITEM_SKU}&xsolla_login_token={ACCESS_TOKEN}

• 用于支付测试的mode=sandbox参数。可使用测试银行卡完成支付。

1. 测试URL的示例：

https://purchase.xsolla.com/pages/buy?type={YOUR-ITEM-TYPE}&project_id={YOUR_PROJECT_ID}&sku={YOUR-ITEM-SKU}&mode=sandbox

通过商店UI销售

您可以通过商店界面销售游戏密钥。要创建商店，可以：

• 使用建站器
• 创建自己版本的商店，然后集成In-Game Store & Buy Button API

如要创建自己版本的商店，可使用商店演示版本作为基础，添加发布在GitHub上的代码段。

要销售游戏密钥套餐，请集成In-Game Store & Buy Button API：

1. 要显示目录，请使用获取游戏列表方法。
2. 实现游戏密钥的购买：
   • 对于快速购买一个密钥，可使用使用指定商品创建订单方法。在该方法的响应中，您将收到一个打开支付界面所必需的令牌。
   • 对于购买多个游戏密钥，可使用以下购物车管理方法：
     • 更新当前购物车的商品方法，以向购物车添加游戏密钥。
     • 获取当前用户的购物车方法，以获取购物车中的游戏密钥列表。
     • 使用当前购物车中的所有商品创建订单方法，以支付购物车中的游戏密钥。在该方法的响应中，您将收到一个打开支付界面所必需的令牌。

选择合适的认证方式以便方法正常工作。

通过小组件销售

有以下几种开发按钮并与艾克索拉API集成的方法：

• 在发布商帐户中通过按钮自定义进行
• 使用支付中心小组件

按钮自定义

1. 在发布商帐户中打开您的项目。
2. 在侧边栏中单击商店。
3. 在游戏密钥窗格中，单击配置。
4. 选择游戏密钥，然后前往小组件自定义选项卡。

5. 在自定义区块中，选择浅色作为背景颜色。

6. 将小组件代码添加到页面时，它包含了继承的样式。请添加下方的样式来覆盖这些样式。

/* This should be used for button positioning but note this technically repositions the entire widget */
#xsolla-buy-button-widget {
  /* place code for button positioning here */
}

/* Styles the button itself */
.x-buy-button-widget.x-buy-button-widget__tiny
  .x-buy-button-widget-payment-button {
  background-color: #ff005b;
  color: black;
}

/* Button on hover */
.x-buy-button-widget.x-buy-button-widget__tiny
  .x-buy-button-widget-payment-button:hover {
  background-color: #ff005b;
}

/* The following are style overrides to leave you with just the button */

/* space immediately surrounding button */
.x-buy-button-widget-button-block.x-buy-button-widget-button-block__light {
  background-color: white;
}

/* space above button (including game title area) */
.x-buy-button-widget.x-buy-button-widget__tiny
  .x-buy-button-widget-game-logo {
  height: 200px;
  background-image: none !important;
  background-color: white;
}

 /* Game title (located right above button) */
.x-buy-button-widget-game-name.x-buy-button-widget-game-name__light {
  display: none !important;
}

如何创建多个按钮或SKU

关于如何使用Pay2Play小组件来实现的代码示例，请参阅Xsolla Pay2Play Widget Simple Integration 4 buttons。

该结构类似于Buy Button小组件代码。迁移示例：

<div id="xsolla-buy-button-widget"></div>
<div id="xsolla-buy-button-widget-2"></div>
    <script>
      var options = {
        project_id: "191204",
        sku: "789",
        item_type: "unit",
        api_settings: {
          sandbox: false,
        },
        widget_ui: {
          target_element: "#xsolla-buy-button-widget",
          theme: {
            foreground: "gold",
            background: "",
          },
        },
        payment_widget_ui: {
          lightbox: {
            height: "700px",
            spinner: "round",
          },
        },
      };
      // options for second buy button - note the different SKU and target_element
      var options2 = {
        project_id: "191204",
        sku: "123",
        item_type: "unit",
        api_settings: {
          sandbox: false,
        },
        widget_ui: {
          target_element: "#xsolla-buy-button-widget-2",
          theme: {
            foreground: "gold",
            background: "",
          },
        },
        payment_widget_ui: {
          lightbox: {
            height: "700px",
            spinner: "round",
          },
        },
      };
      var s = document.createElement("script");
      s.type = "text/javascript";
      s.async = true;
      s.src = "https://cdn.xsolla.net/embed/buy-button/3.1.4/widget.min.js";

// one event listener per widget instance. repeat for more buttons, passing in different SKUs
      s.addEventListener(
        "load",
        function (e) {
          var widgetInstance = XBuyButtonWidget.create(options);
        },
        false
      );
      s.addEventListener(
        "load",
        function (e) {
          var widgetInstance2 = XBuyButtonWidget.create(options2);
        },
        false
      );
      var head = document.getElementsByTagName("head")[0];
      head.appendChild(s);
    </script>

为此页面评分

我们还有其他可改进之处吗？ 发送

不想回答

感谢您的反馈！

继续阅读