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

1. WebSocket API。
2. 短轮询。

3. 艾克索拉事件API。

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

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

完成以下步骤：

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

 1const client = new Centrifuge(
 2connectionURL,
 3{
 4data: {
 5  user_external_id: user_external_id,
 6  auth: auth,
 7  project_id: project_id
 8}
 9}
10)
11connectionURL - wss://ws-store.xsolla.com/connection/websocket
12auth - user JWT token

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

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

3. 触发建立实际连接：

1client.connect()

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

 1client.on('subscribed', function (ctx) {
 2   client.history(ctx.channel, { limit: -1, since: { offset: 0 }, reverse: false }).then(function (resp) {
 3resp.publications.forEach((ctx) => {
 4   /handle the status
 5});
 6
 7   }, function (err) {
 8       //handle the status
 9   });
10});

消息正文示例：

1{
2order_id: 59614241,
3status: 'new'
4}

可能出现以下订单状态：

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

Websocket使用建议：

• 通过websocket接收响应的最大等待时间为5分钟。
• 应在打开支付界面时建立连接。
• 一旦收到最终订单状态，无论是Canceled或Done，都应中止连接。
• 如果websocket的生命周期到期或连接出现任何问题，请使用短轮询。

短轮询

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

艾克索拉事件API

概览

艾克索拉事件API让您能够使用GetUpdates服务直接在应用程序客户端接收和处理支付信息，而无需在服务器上使用Webhook。如果您希望加快和简化集成过程，无需配置和维护服务器来处理支付Webhook，建议使用此集成方案。

游戏与艾克索拉的交互流程：

如何设置

要通过API从艾克索拉接收事件：

1. 在您的发布商帐户项目中，前往项目设置 > Webhooks部分。
2. 单击使用API。设置将自动保存。

3. 从应用程序客户端向https://getupdate.xsolla.com/events发送请求以获取支付信息。有关详细信息，请参阅API参考。在响应中，您将收到与支付Webhook格式相同的支付数据。
4. 如果支付成功，向用户发放购买的商品。

API参考

获取用户未处理的事件列表

1GET https://getupdate.xsolla.com/events

安全认证：Bearer User JWT令牌

响应示例：

 1{
 2  "events": [
 3   {
 4     "id": 49, // event_id
 5     "status": 0,
 6     "created_at": "2025-04-03T21:21:27Z",
 7     "data": {
 8       "notification_type": "payment",
 9       "purchase": {
10         "order": {
11           "id": 000000001,
12           "lineitems": [
13             {
14               "quantity": 1,
15               "sku": "skill"
16             }
17           ]
18         }
19       },
20       ...
21     }
22   }
23 ]
24}

标记事件为已处理

1POST https://getupdate.xsolla.com/events/<event_id>/processed

event_id是从获取用户未处理的事件列表API调用响应中获取的events.id参数。

安全认证：Bearer User JWT令牌

XsollaCatalog.Purchase方法封装了若干跟踪订单状态的方法。关于跟踪机制的详细信息，请参阅Unity专用SDK（PC、网页端）。

此外，您可以实现对订单状态和内容的处理，这些在购买方法的onSuccess回调函数中传入。

您可以使用CheckPendingOrder SDK方法跟踪订单状态。请向该方法传入以下参数：

• AccessToken — 购买商品时收到的支付令牌。
• OrderId — 购买商品时收到的订单ID。
• SuccessCallback — 支付成功回调。
• ErrorCallback — 请求错误回调。
• bIsUserInvolvedToPayment — 用户在付款过程中是否参与。如使用真是货币购买，传入true；如购买免费商品或使用虚拟货币购买，传入false。

关于跟踪机制的详细信息，请参阅虚幻引擎专用企业级SDK。

要请求订单的状态和内容，请调用CheckOrder SDK方法，并传入以下参数：

• AccessToken — 购买商品时收到的支付令牌。
• OrderId — 购买商品时收到的订单ID。
• SuccessCallback — 检查订单成功的回调。响应包含订单状态。
• ErrorCallback — 请求错误回调。