已淘汰

如何使用新Commerce API方法

运行机制

如有以下需求,可连接Commerce API

  • 已实现服务器与艾克索拉的集成(通过令牌),但希望切换为新Commerce API方法
  • 希望重新开始实现商店的服务器部分

主要功能:

  • 通过艾克索拉登录管理器进行认证
  • 通过支付中心访问令牌进行认证
  • 虚拟物品管理
  • 用户物品库管理
  • 购物车和订单管理

适用对象

  • 开发了商店界面、并希望使用第三方解决方案实现服务器侧的合作伙伴。
  • 已实现服务器与艾克索拉的集成、并希望使用新的Commerce API方法连接到商店的合作伙伴。

如何获取

要连接Commerce API至应用程序:

  1. 发布商帐户中设置虚拟物品模块。
  2. 设置认证方式。
  3. 实现商店管理的方法。

集成过程中需要用到项目ID商户ID,可在项目设置 > Webhooks中找到。

认证设置

有以下用户认证选项可用:

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

  1. 在发布商帐户中设置项目
  2. 通过JSON Web令牌或OAuth 2.0协议实现授权方法的调用。

如果用户数据保存在艾克索拉数据存储中,请实现以下方法的调用:

如果用户数据保存在PlayFab数据存储中,请参阅PlayFab方法详解

如果用户数据保存在您自己一侧,请参阅自定义存储方法详解

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

认证过程:

  1. 应用程序(客户端)发送认证请求至您的服务器。
  2. 您的服务器请求认证令牌并将包含project_id/merchant_idapi_key参数的发送至艾克索拉服务器。
  3. 艾克索拉服务器将认证令牌放在access_token参数中发送至您的服务器。
  4. 您的服务器发送access_token参数至客户端。

返回的access_token用作授权令牌,用于在Commerce API中和生成商店界面时进行认证。

商店管理方法

应实现基本商店管理方法:

获取商品列表管理

购物车和订单管理

  • Get cart — 用于购买虚拟物品 — Get cart by IDGet current user’s cartcard_id参数用于添加或移除物品。
  • Get order — 判断购买是否已完成处理。存在以下几种状态:
    • New — 订单已创建但未付款
    • Paid — 订单已付款
    • Canceled — 订单已取消
    • Done — 订单已付款且物品已添加至物品库

Note
应以一定频率进行状态检查,因为一次性检查可能会错过订单的新状态。

创建的订单将为New订单状态。

要在新窗口中打开支付UI,请使用以下链接:https://secure.xsolla.com/paystation3/?access_token=ACCESS_TOKEN,其中ACCESS_TOKEN是订单创建时收到的令牌。

要测试支付过程:

  1. 使用下列URL:https://sandbox-secure.xsolla.com/paystation3/?access_token=ACCESS_TOKEN
  2. 将请求中的sandbox参数设置为true
  3. 使用用于测试的银行卡列表

用户物品库管理

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

不想回答

感谢您的反馈!
上次更新时间: 2020年9月15日

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

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