サーバーがない場合、またはクライアント側で購入処理のロジックを実装している場合は、次のメソッドを使用できます：

1. WebSocket API。
2. ショートポーリング。

3. エクソーライベントAPI。

WebSocket APIを使用してクライアント側で注文状況の取得

このソリューションでは、websocketを使用して、注文の詳細情報を取得せずに注文状況を取得します。このメソッドが推奨されます：クライアント（例えば、ウェブサイトやモバイルアプリケーション）とエクソーラサーバー間には1つの接続しか作成されないため、クライアントやサーバーへの追加の負荷は発生しません。

以下の手順を完了してください：

1. エクソーラのwebsocketサーバーとクライアントが注文状況メッセージを識別できるようにするために、接続を作成します：

 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分です。
• 決済UIを開くときに接続を確立する必要があります。
• 最終的な注文ステータスがCanceledまたはDoneになったら、接続を中止する必要があります。
• WebSocketの寿命が切れた場合、または接続に問題がある場合は、ショートポーリングを使用します。

ショートポーリング

ステータスを切り替えた後のオーダーのアイテムの詳細情報を取得するには、注文を取得するAPIを呼び出します。

エクソーライベントAPI

概要

エクソーライベントAPIを使用すると、GetUpdatesサービスを利用して、サーバー上でウェブフックを使用せずに、アプリケーションクライアントから直接支払い情報を受信および処理できます。支払いウェブフックを処理するために独自のサーバーをセットアップおよび維持する必要性をなくし、統合を迅速化および簡素化したい場合は、この統合オプションを使用してください。

ゲームとエクソーラの間のインタラクション：

設定方法

APIを介してエクソーラからイベントを受信するには：

1. プロジェクトのパブリッシャーアカウントで、プロジェクト設定 > ウェブフックセクションに移動します。
2. 「APIを使用する」をクリックします。設定は自動的に保存されます。

3. アプリケーションクライアントから、支払い情報を取得するためにhttps://getupdate.xsolla.com/eventsにリクエストを送信してください。詳細については、APIリファレンスを参照してください。応答として、決済ウェブフックと同じ形式で支払いデータを受け取ります。
4. 支払いが成功した場合、ユーザーに購入を許可します。

APIリファレンス

ユーザーの未処理イベントリストを取得する

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

セキュリティ：Bearerユーザー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ユーザーJWTトークン

XsollaCatalog.Purchaseメソッドは、注文状況を追跡するためのいくつかのメソッドをカプセル化しています。追跡メカニズムは、Unity（PC、ウェブ）向けのSDKに関するドキュメントに詳しく記載されています。

さらに、購入メソッドのonSuccessコールバック関数に渡される注文状況と内容の処理を実装することができます。

CheckPendingOrder SDKメソッドを使用して注文状況を追跡することができます。メソッドに以下のパラメータを渡します：

• AccessToken — 商品を購入する時に受け取った支払いトークン。
• OrderId — 商品を購入する時に受け取った注文ID。
• SuccessCallback — 決済成功時のコールバック。
• ErrorCallback — リクエストエラー時のコールバック。
• bIsUserInvolvedToPayment — ユーザーが支払いプロセスに関与しているかどうか。実際通貨で購入する場合はtrueを、無料アイテム購入と仮想通貨で購入する場合はfalseを渡します。

追跡メカニズムは、Unreal Engine向けエンタープライズレベルSDKに関するドキュメントに詳しく記載されています。

注文状況と内容をリクエストするには、CheckOrder SDKメソッドを呼び出し、次のパラメータを渡します：

• AccessToken — 商品を購入する時に受け取った支払いトークン。
• OrderId — 商品を購入する時に受け取った注文ID。
• SuccessCallback — 注文確認成功時のコールバック。応答には注文状況が含まれます。
• ErrorCallback — リクエストエラー時のコールバック。