在游戏中集成商店

在发布商帐户中创建并配置商品（虚拟物品、虚拟货币、捆绑包、密钥）后，在您的游戏中添加一个游戏内商店：

1. 实现显示商品目录。
2. 实现商品销售逻辑。

显示商品目录

通过In-Game Store API调用实现商品目录的显示：

销售商品

您可以通过以下方式销售商品：

1. 快速购买单项商品。可以通过此方式销售任意数量的单个SKU（例如100瓶相同的魔法药水或自定义数量的虚拟货币）。
2. 购物车下单。通过此方式，用户可以将商品加入购物车、添加或删除商品以及更改商品数量。

快速购买

购物车下单

1. 设置购物车并获取令牌：
   • 在客户端上实现 — 如要自行在应用程序中实现购物车。
   • 在服务器上实现 — 如要使用艾克索拉解决方案（In-Game Store API调用）来管理购物车。
2. 打开支付UI。

在客户端上设置购物车和购物车下单

自行实现添加和删除商品的逻辑。另外还需要考虑一个情况，即在调用设置购物车的API之前，您没有订单会应用哪些促销活动的信息，也就是说，总价和添加的奖励品的详情不可知。

1. 玩家添加商品到购物车后，请调用Fill cart with items API。所选商品的当前信息（折扣前后的价格、奖励品）将传入响应中。
2. 调用Create order with all items from current cart API。订单ID和支付令牌将传入响应中。创建的订单将获得New的订单状态。
3. 打开支付UI。

在服务器上设置购物车和购物车下单

此方式下设置购物车的时间可能较长，因为每个购物车更改必须伴随API调用。

完成以下步骤：

1. 更改购物车：
   • 要添加商品或更改商品数量，请调用Update cart item by card ID API。
   • 要删除商品，请调用Delete cart item by card ID API。

2. 调用Create order with all items from the current cart API。订单ID和支付令牌将传入响应中。创建的订单将获得New的订单状态。
3. 打开支付UI。

打开支付界面

要进行商品支付，请打开支付UI。用于打开支付UI的令牌将传入Create order with all items from current cart API响应中。

通过以下方式之一实现支付UI的打开：

• 在新窗口中打开。要在新浏览器窗口中打开支付UI，请使用此链接：https://secure.xsolla.com/paystation3/?access_token=ACCESS_TOKEN，其中ACCESS_TOKEN是创建订单时收到的令牌。
• 通过小组件打开。请使用Xsolla PayStation Widget脚本（README文件中有说明信息）。

测试支付流程

您可以在沙盒模式下测试支付流程，可使用测试银行卡和任意帐户进行。

获取订单状态

您可以使用以下方法获取用户订单状态：

1. 在服务器侧通过Webhook。
2. 在客户端侧通过WebSocket API或IGS API。

在服务器侧通过Webhook获取用户订单状态

在客户端侧通过WebSocket API或IGS API获取用户订单状态

1. WebSocket API。
2. Short-polling。

使用WebSocket API在客户端侧获取订单状态

本解决方案使用websocket在不获取订单详细信息的情况下获取订单状态。该方法适用于：客户端（如您的网站或移动应用）和艾克索拉服务器间只创建了一个连接，因此客户端或服务器上都没有额外负载。

完成以下步骤：

1. 创建连接，以便艾克索拉服务器和您的客户端识别订单状态消息：

const client = new Centrifuge(
connectionURL,
{
data: {
  user_external_id: user_external_id,
  auth: auth,
  project_id: project_id
}
}
)
connectionURL - wss://ws-store.xsolla.com/connection/websocket
auth - user JWT token

2. 使用client.on函数来订阅事件，以便接收关于订单状态的新消息：

client.on('publication', (ctx) => {
   //handle the status
});

3. 触发建立实际连接：

client.connect()

4. 连接API历史记录方法，以便接收订单状态更改历史记录。

client.on('subscribed', function (ctx) {
   client.history(ctx.channel, { limit: -1, since: { offset: 0 }, reverse: false }).then(function (resp) {
resp.publications.forEach((ctx) => {
   /handle the status
});

   }, function (err) {
       //handle the status
   });
});

消息正文示例：

{
order_id: 59614241,
status: 'new'
}

可能出现以下订单状态：

• New — 已创建订单但未支付
• Paid — 订单已支付
• Done — 订单已交付（已发送所有支付凭证，交付在艾克索拉侧、外部平台等进行）
• Canceled — 订单已取消，付款已退给用户

通过Web socket响应所需的时间是5分钟。如超时或websocket存在问题，建议使用短轮询。

短轮询

要在状态切换后获取订单中商品的详细信息，请调用获取订单API。