ストアをゲームに統合する

アドミンページでグッズ （仮想アイテム、仮想通貨、バンドル、キー）を作成して構成したら、インゲームストアをゲームに追加します：

1. アイテムカタログの表示を実装します。
2. アイテムを販売するためのロジックを実装します。

商品カタログの表示

In-Game Store APIコールでアイテムカタログの表示を実装します：

アイテムの販売

以下の方法でアイテムを販売することができます：

1. 1つの商品を迅速で購入することができます。この場合、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 と決済トークンがレスポンスに渡されます。作成された注文は新規注文ステータスを受け取ります。
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と決済トークンがレスポンスに渡されます。作成された注文は新規注文ステータスを受け取ります。
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が注文が作成されたときに受け取る。
• ウィジェット経由。エクソーラ決済ステーションウィジェットスクリプトを使用します (READMEファイルには説明が含まれています)。

支払いプロセスのテスト

支払いフローはサンドボックスモードでテストできます。テスト銀行カードと任意の口座を使用できます。

ユーザーの注文状況を取得

ユーザーの注文状況を取得するには、以下の方法を使用します：

1. サーバー側でウェブフックを利用する。
2. クライアント側でWebSocket APIまたはIGS APIを使用する。

ウェブフックを利用してサーバーサイドでユーザーの注文状況を取得する

WebSocket APIまたはIGS APIを経由して、クライアント側でユーザーの注文状況を取得する

1. WebSocket API。
2. Short-polling。

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を呼び出します。