如何使用新Commerce API方法

运行机制

如有以下需求，可连接Commerce API：

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

主要功能：

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

适用对象

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

如何获取

要连接Commerce API至应用程序：

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

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

认证设置

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

• 通过艾克索拉登录管理器。如果未实现服务器与艾克索拉的集成，请使用此选项。
• 通过支付中心访问令牌。如果实现了服务器与艾克索拉的集成，请使用此选项。

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

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

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

• 注册（JWT或OAuth 2.0）
• 认证（以下任一）：
  • 通过用户名和密码（JWT或OAuth 2.0）
  • 通过社交网络（JWT或OAuth 2.0）
• 重置密码

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

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

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

认证过程：

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

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

商店管理方法

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

获取商品列表管理

• Get virtual items list — 显示添加到商店的完整虚拟物品列表
• Get item groups list — 显示添加到商店的完整虚拟物品组列表
• Get bundles — 用于创建目录：
  • Get list of bundles — 显示用于创建目录的完整捆绑包列表
  • Get specified bundle — 按指定SKU显示捆绑包

购物车和订单管理

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

• Creates item purchase using virtual currency — 用虚拟货币购买虚拟物品
• Create order with all items — 实现以下API方法之一：
  • Create order with all items from particular cart — 如果按ID获取了购物车
  • Create order with all items from current cart — 如果已获取当前购物车
  • Create order with specified item — 如果获取了快速商品购买项（不创建购物车）

创建的订单将为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. 使用用于测试的银行卡列表。

用户物品库管理

• Get user’s inventory — 获取购买后添加到物品库的物品列表
• Get current user virtual balance — 获取当前用户虚拟余额信息
• Get current user subscription — 获取当前用户订阅信息

为此页面评分

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

不想回答

感谢您的反馈！