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

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

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

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

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

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

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 — 注文がキャンセルされ、代金がユーザーに返金される

ウェブソケット経由の応答に必要な時間は5分です。その後、またはウェブソケットに問題がある場合は、ショートポーリングを使用することが推奨されます。

ショートポーリング

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

XsollaCatalog.Purchaseメソッドは、注文状況を追跡するためのいくつかのメソッドをカプセル化しています。追跡メカニズムは、Unity向けエンタープライズレベルSDKのドキュメンテーションに詳しく記載されています。

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

SDKを使用する場合、以下の方法で注文状況を追跡することができます：

• 注文状況の変更を購読する
• 注文状況をリクエストする

注文ステータスの変更をサブスクライブする

注文状況の変更をサブスクライブするには、ストアライブラリのgetOrderStatus SDKメソッドを使用し、以下のパラメータをメソッドに渡します：

• listener — OrderStatusListenerタイプのリスナーオブジェクト。
• orderId — ショッピングカートでの購入、ワンクリック購入、または仮想通貨での購入で受け取った注文IDをパラメータとします。

SDK参照ドキュメンテーション

SDKメソッドとそのパラメータの詳細については、こちらをご覧ください。

XStore.getOrderStatusメソッドの呼び出し例：

XStore.getOrderStatus(object : OrderStatusListener() {

               override fun  onStatusUpdate(status: OrderResponse.Status) {

                   if(status == OrderResponse.Status.DONE) {

                       Log.d("MainActivity", "Success")

                   }

               }

               override fun  onFailure() {

                   Log.d("MainActivity", "Failure")

               }

           }, orderId)

決済UIを開く際にXStore.getOrderStatusメソッドを呼び出すことをお勧めします。

購入メソッドは、注文ステータスを追跡するためのいくつかのメソッドをカプセル化します。追跡は、以下のアルゴリズムに従って行われます：

1. ウェブソケット接続が確立されます。
2. ウェブソケット接続が正常に確立され、注文ステータスがdoneまたはcancelに変更された場合、トラッキングは停止します。ウェブソケット接続が失敗した場合、またはレスポンスに不正なデータが含まれている場合、注文ステータスはショートポーリングを使用して追跡されます。
3. 注文ステータスの追跡はショートポーリングで継続されます。シンプルなHTTPオーダーステータスリクエストが3秒に1回送信されます。注文ステータスがdoneまたはcancelに変更された場合、追跡は停止します。

注文状況をリクエストする

支払いトランザクションの現在のステータスを要求するには、ストアライブラリのgetOrderメソッドを呼び出し、次のパラメータを渡します：

• orderId — 商品を購入する時に受け取った注文ID。

• callback — 注文情報を正常に取得するコールバック。コールバックを実装する場合は、GetStatusCallbackインターフェイスを使用し、onSuccessとonErrorメソッドを実装します。

• callback — 注文情報を正常に取得するコールバック。コールバックを実装する場合は、GetStatusCallbackインターフェイスを使用し、onSuccessとonErrorメソッドを実装します。

例：

XPayments.getStatus(<token>, <isSandbox>, object : GetStatusCallback {
            override fun onSuccess(data: InvoicesDataResponse?) {
                Log.d(TAG, "onSuccess is fired. Result data = $data")
            }

           override fun onError(throwable: Throwable?, errorMessage: String?) {
                Log.d(TAG, "onError is fired. ErrorMessage = $errorMessage")
            }

})

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

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

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

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

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