在游戏中集成商店

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

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

显示商品目录

通过游戏内商店和Buy Button API调用实现商品目录的显示：

销售商品

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

1. 快速购买单项商品。可以通过此方式销售任意数量的单个SKU，例如100瓶相同的魔法药水。
2. 购物车下单。通过此方式，用户可以先将商品加入购物车，并可以添加和删除不同商品以及更改商品数量。

快速购买

购物车下单

实现以下逻辑：

1. 设置购物车并获取令牌：
   • 在客户端上实现 — 如要自行在应用程序中实现购物车。
   • 在服务器上实现 — 如要使用艾克索拉解决方案（游戏内商店和Buy Button 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文件中有说明信息）。

测试支付流程

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

要启用/禁用沙盒模式，需更改快速购买和购物车下单请求中sandbox参数的值。默认禁用沙盒模式。

获取订单状态

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

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

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

在服务器侧配置Webhook后，可使用它们来获取订单详情和状态。

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

如没有服务器或您是在客户端侧实现购买处理逻辑，可使用以下方式：

1. WebSocket API。
2. Short-polling。

WebSocket API

此方法涉及使用Web socket来获取订单状态而不接收订单本身的详细信息。更推荐使用此方法，因为艾克索拉客户端和服务器之间只需建立一个连接，因此对客户端或服务器不会有额外负载。

请完成以下步骤：

1. 为了让WebSocket服务器和客户端识别包含订单状态的消息，请创建一个通道标识符（请注意参数顺序，不要弄错）：Channel_id: order_id=$orderId&project_id=$projectId。
2. 要订阅该通道，通过WebSocket协议连接URL：wss://store-ws.xsolla.com/sub/order/status?order_id=$orderId&project_id=$projectId。消息正文包含订单ID和订单状态：

{
"order_id": int,
"status": string
}

有以下订单状态可用：

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

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

短轮询

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