设置商品销售

您可以通过直接链接小组件商店UI销售商品。

以下链接用于打开支付UI:

Copy
Full screen
Small screen
https://store.xsolla.com/pages/buy.php?type={YOUR-ITEM-TYPE}&project_id={YOU_PROJECT_ID}&sku={YOUR-ITEM-SKU}

将以下数据添加至链接:

  • YOUR-ITEM-TYPE — 商品类型:
    • game — 游戏;game_key — 用于销售指定DRM游戏。
    • physical_item — 实体商品。
    • virtual_item — 虚拟物品。
    • virtual_currency — 虚拟货币。
    • bundle — 虚拟货币套餐或捆绑包。
  • YOUR-PROJECT-ID发布商帐户中的项目ID(您的项目 > 项目设置 > 常规设置 > 项目ID)。
  • YOUR-ITEM-SKU — 商品SKU。要销售指定DRM游戏,应通过Get games list获取添加至商店的虚拟商品完整列表中显示的DRM的SKU。该SKU的格式一般为unit_name_drm_sku

也可将以下额外参数传入链接:

  • 支付UI样式:例如主题(深色为dark参数,浅色为default参数)或大小。在URL中指定ui_settings参数并传入具有Base64编码值的settings.ui JSON对象。以下为包含UI设置的URL示例:

Copy
Full screen
Small screen
https://store.xsolla.com/pages/buy.php?type={YOUR-ITEM-TYPE}&project_id={YOU_PROJECT_ID}&sku={YOUR-ITEM-SKU}&ui_settings=ewoJCQkic2l6ZSI6ICJzbWFsbCIsCgkJCSJ0aGVtZSI6ICJkYXJrIgoJCX0=

  • 用于传递用户数据的令牌。仅当向通过认证的用户销售商品时使用,且对销售虚拟物品和虚拟货币为必需。此令牌取决于认证方式。包含令牌的URL示例:

Copy
Full screen
Small screen
https://store.xsolla.com/pages/buy.php?type={YOUR-ITEM-TYPE}&project_id={YOUR_PROJECT_ID}&sku={YOUR_ITEM_SKU}&xsolla_login_token={ACCESS_TOKEN}

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

Copy
Full screen
Small screen
https://store.xsolla.com/pages/buy.php?type={YOUR-ITEM-TYPE}&project_id={YOU_PROJECT_ID}&sku={YOUR-ITEM-SKU}&mode=sandbox

通过小组件销售

小组件是一个可在网站上实现的用于销售商品的脚本。您可在演示页面上查看小组件的示例。

小组件的实现代码:

Copy
Full screen
Small screen
<script>
    var options = {
        project_id: "YOUR-PROJECT-ID",
        item_type: "YOUR-ITEM-TYPE",
        sku: "YOUR-ITEM-SKU",
        user: "ACCESS_TOKEN",
        widget_ui: {
            target_element: '#widget-example-element'
        }
    };
    var s = document.createElement('script');
        s.type = "text/javascript";
        s.async = true;
        s.src = "https://cdn.xsolla.net/embed/buy-button/3.1.2/widget.min.js";
        s.addEventListener('load', function (e) {
          var widgetInstance = XBuyButtonWidget.create(options);
          }, false);
    var head = document.getElementsByTagName('head')[0];
    head.appendChild(s);
</script>

将以下数据加入上述代码:

  • YOUR-PROJECT-ID发布商帐户中的项目ID(您的项目 > 项目设置 > 常规设置 > 项目ID)。
  • YOUR-ITEM-TYPE — 商品类型:
    • game — 游戏;game_key用于销售指定DRM游戏。
    • physical_item — 实体商品。
    • virtual_item — 虚拟物品。
    • virtual_currency — 虚拟货币。
    • bundle — 虚拟货币套餐或捆绑包。
  • YOUR-ITEM-SKU — 商品SKU。要销售指定DRM游戏,应通过Get games list获取添加至商店的虚拟商品完整列表中显示的DRM的SKU。该SKU的格式一般为unit_name_drm_sku
  • ACCESS_TOKEN — 用于传递用户数据的令牌。仅当向通过认证的用户销售商品时使用,且对销售虚拟物品和虚拟货币为必需。此令牌取决于认证方式

关于小组件配置的详细信息,请访问我们的GitHub

通过商店UI销售

要通过商店UI销售游戏密钥、虚拟物品和虚拟货币,可实现一个独立的web应用程序或实现一个游戏内商店UI。应使用Commerce API或在演示版本的基础上创建自己的商店来获取商品列表并进行处理。

基于Commerce API

您可以通过集成Commerce API以下方法创建商店的前端部分:
  1. 获取虚拟物品虚拟货币套餐游戏
  2. 购买商品:

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

Note
要通过Commerce API方法销售游戏,应在前端侧实现DRM的选择。将从获取游戏请求获得的items.unit_items.sku参数值作为SKU传入。

基于演示版本

可使用商店演示版本检查API功能。该代码已上传至GitHub。您可以以它为基础创建自己的版本。

本文对您的有帮助吗?
谢谢!
我们还有其他可改进之处吗? 留言
非常抱歉
请说明为何本文没有帮助到您。 留言
感谢您的反馈!
我们会查看您的留言并运用它改进用户体验。
为此页面评分
为此页面评分
我们还有其他可改进之处吗?

不想回答

感谢您的反馈!

继续阅读

下一步

设置Webhook
上次更新时间: 2021年6月16日

发现了错别字或其他内容错误? 请选择文本,然后按Ctrl+Enter。

报告问题
我们非常重视内容质量。您的反馈将帮助我们做得更好。
请留下邮箱以便我们后续跟进
感谢您的反馈!