已淘汰
上次更新时间:
2020年9月15日
如何使用新Commerce API方法
运行机制
如有以下需求,可连接
- 已实现服务器与艾克索拉的集成(通过令牌),但希望切换为新Commerce API方法
- 希望重新开始实现商店的服务器部分
主要功能:
- 通过艾克索拉登录管理器进行认证
- 通过支付中心访问令牌进行认证
- 虚拟物品管理
- 用户物品库管理
- 购物车和订单管理
适用对象
- 开发了商店界面、并希望使用第三方解决方案实现服务器侧的合作伙伴。
- 已实现服务器与艾克索拉的集成、并希望使用新的
Commerce API 方法连接到商店的合作伙伴。
如何获取
要连接
集成过程中需要用到项目ID或商户ID,可在项目设置 > Webhooks中找到。
认证设置
有以下用户认证选项可用:
通过艾克索拉登录管理器进行认证
- 在发布商帐户中设置项目。
- 通过JSON Web令牌或OAuth 2.0协议实现授权方法的调用。
如果用户数据保存在艾克索拉数据存储中,请实现以下方法的调用:
如果用户数据保存在PlayFab数据存储中,请参阅PlayFab方法详解。
如果用户数据保存在您自己一侧,请参阅自定义存储方法详解。
通过支付中心访问令牌认证
认证过程:
- 应用程序(客户端)发送认证请求至您的服务器。
- 您的服务器请求认证令牌并将包含project_id/merchant_id和api_key参数的头发送至艾克索拉服务器。
- 艾克索拉服务器将认证令牌放在access_token参数中发送至您的服务器。
- 您的服务器发送access_token参数至客户端。
返回的access_token用作授权令牌,用于在
商店管理方法
应实现基本商店管理方法:
获取商品列表管理
- 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
是订单创建时收到的令牌。
要测试支付过程:
- 使用下列URL:
https://sandbox-secure.xsolla.com/paystation3/?access_token=ACCESS_TOKEN
。 - 将请求中的sandbox参数设置为true。
- 使用用于测试的银行卡列表。
用户物品库管理
- Get user’s inventory — 获取购买后添加到物品库的物品列表
- Get current user virtual balance — 获取当前用户虚拟余额信息
- Get current user subscription — 获取当前用户订阅信息
本文对您的有帮助吗?
感谢您的反馈!
我们会查看您的留言并运用它改进用户体验。为此页面评分
为此页面评分
不想回答
感谢您的反馈!
发现了错别字或其他内容错误? 请选择文本,然后按Ctrl+Enter。