インベントリ。期間限定アイテム

どのように動作するか

期間限定アイテムは、1回限りの購入であるプレミアムボーナスです。したがって、ユーザーは期限切れになったときに再度購入する必要があります。

主な特徴：

期間限定アイテムは無限の回数で販売できます。
ユーザーがアイテムを再度購入しても、インベントリー内のアイテムの数は変化しませんが、アイテムの有効期限が切れるまでの時間が増加します。
アドミンページでアイテムの有効期限を設定できます。

制限：

期間限定アイテムは、ゲームが提供される側からのみ管理できます。

ストア内のアイテムの表示時間を制限する場合は、「ストア内のアイテムの表示時間を制限する設定方法」を使用してください。

使用に適した方

インゲームストアを統合し、新しいアイテムタイプ–期間限定アイテムをセットアップしたいパートナー。
Season Pass、Battle Pass、または限定期間でユーザーに有益点または追加コンテンツ（ゲーム内アイテムやタスクなど）を提供するさまざまな種類のアイテムを販売したいパートナー。

入手方法

前提条件

エクソーラストアをまだ統合していない場合は、次の手順を実行します：

エクソーラストアアドミンページを作成します。
プロジェクトに移動し、プロジェクトを作成するボタンをクリックします。
プロジェクト名を追加し、作成するをクリックします。
ストアをプロジェクトに接続します。
仮想アイテムモジュールを接続します。

統合フロー

アイテムのグループを作成します。
アイテムを作成します：

新しいアイテムを作成するには、アイテムプロパティメニューで期間限定アイテムを選択します。
有効期限を指定します。

カタログでカタログでの期間限定アイテムを取得するを実装します。
サブスクリプションを期間限定アイテムを購入するを実装します。

カタログでの期間限定アイテムを取得する

ストアに追加された仮想アイテムの完全リストを表示するには、仮想アイテムリストを取得 APIメソッドを実装します。

例

Copy

Full screen

Small screen

var data = null;

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://store.xsolla.com/api/v2/project/44056/items/virtual_items?locale=en");

xhr.send(data);

//RESPONSE

"items": [
    {
      "attributes": [],
      "description": "Conquer your foes with vindication using the Basic Blaster! ",
      "groups": [
        "all",
        "featured",
        "Xsolla",
        "weapons"
      ],
      "image_url": "https://cdn.xsolla.net/img/misc/images/0c59a7698d4f66c1008b27ee752089b7.png",
      "is_free": false,
      "name": "Xsolla Basic Blaster 1",
      "order": 1,
      "price": {
        "amount": "0.9950000000000000",
        "amount_without_discount": "1.9900000000000000",
        "currency": "USD"
      },
      "sku": "gun_1",
      "type": "virtual_good"

期間限定アイテムを購入する

最初の購入後、期間限定アイテムがインベントリに追加されます。

2回目以降と将来の購入：

期間限定アイテムがアクティブな場合、アイテムの有効期限は残りの時間と合計されます。
期間限定アイテムがアクティブでない場合、アイテムの有効期限がデフォルトです。

期間限定アイテムを購入するには、次のメソッドを実装します。

Get cart

仮想アイテムの購入には、カーIDによるカートを取得するまたは現在のユーザーのカートを取得するAPIメソッドを実装します。カートIDはアイテムの追加/削除に使用されます。

例

Copy

Full screen

Small screen

var data = null;

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://store.xsolla.com/api/v2/project/44056/cart/custom_id?locale=en&currency=USD");
xhr.setRequestHeader("authorization", "Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE5NjIyMzQwNDgsImlzcyI6Imh0dHBzOi8vbG9naW4ueHNvbGxhLmNvbSIsImlhdCI6MTU2MjE0NzY0OCwidXNlcm5hbWUiOiJ4c29sbGEiLCJ4c29sbGFfbG9naW5fYWNjZXNzX2tleSI6IjA2SWF2ZHpDeEVHbm5aMTlpLUc5TmMxVWFfTWFZOXhTR3ZEVEY4OFE3RnMiLCJzdWIiOiJkMzQyZGFkMi05ZDU5LTExZTktYTM4NC00MjAxMGFhODAwM2YiLCJlbWFpbCI6InN1cHBvcnRAeHNvbGxhLmNvbSIsInR5cGUiOiJ4c29sbGFfbG9naW4iLCJ4c29sbGFfbG9naW5fcHJvamVjdF9pZCI6ImU2ZGZhYWM2LTc4YTgtMTFlOS05MjQ0LTQyMDEwYWE4MDAwNCIsInB1Ymxpc2hlcl9pZCI6MTU5MjR9.GCrW42OguZbLZTaoixCZgAeNLGH2xCeJHxl8u8Xn2aI");

xhr.send(data);

//RESPONSE

{
  "cart_id": "custom_id",
  "is_free": true,
  "items": [],
  "price": null
}

（カートを作成しないで）クイックアイテム購入を有効にする場合には、指定したアイテムで注文を作成する APIメソッドを使用します。

Create order with all items

APIメソッドの1つを実装します：
1. カートをIDで取得する場合には、特定のカートの全アイテムを対象とした注文を作成する。
2. 現在のカートを取得する場合には、現在のカートの全アイテムを対象とした注文を作成する。

作成された注文はNewオーダーステータスを受取ります。

新しいウィンドウで決済UIを開くには、次のリンクを使用してください：https://secure.xsolla.com/paystation3/?access_token=ACCESS_TOKEN。ACCESS_TOKENは注文が作成されたときに受け取ったトークンです。
決済プロセスをテストするには：
1. このURLを使用します：https://sandbox-secure.xsolla.com/paystation3/?access_token=ACCESS_TOKEN。
2. リクエストでサンドボックスパラメータをtrueに設定します。
3. テストのための銀行のカードのリストを使います。

例

Copy

Full screen

Small screen

var data = JSON.stringify({
  "currency": "USD",
  "locale": "en",
  "sandbox": false
});

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://store.xsolla.com/api/v2/project/44056/payment/cart/custom_id");
xhr.setRequestHeader("content-type", "application/json");
xhr.setRequestHeader("authorization", "Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE5NjIyMzQwNDgsImlzcyI6Imh0dHBzOi8vbG9naW4ueHNvbGxhLmNvbSIsImlhdCI6MTU2MjE0NzY0OCwidXNlcm5hbWUiOiJ4c29sbGEiLCJ4c29sbGFfbG9naW5fYWNjZXNzX2tleSI6IjA2SWF2ZHpDeEVHbm5aMTlpLUc5TmMxVWFfTWFZOXhTR3ZEVEY4OFE3RnMiLCJzdWIiOiJkMzQyZGFkMi05ZDU5LTExZTktYTM4NC00MjAxMGFhODAwM2YiLCJlbWFpbCI6InN1cHBvcnRAeHNvbGxhLmNvbSIsInR5cGUiOiJ4c29sbGFfbG9naW4iLCJ4c29sbGFfbG9naW5fcHJvamVjdF9pZCI6ImU2ZGZhYWM2LTc4YTgtMTFlOS05MjQ0LTQyMDEwYWE4MDAwNCIsInB1Ymxpc2hlcl9pZCI6MTU5MjR9.GCrW42OguZbLZTaoixCZgAeNLGH2xCeJHxl8u8Xn2aI");

xhr.send(data);

//RESPONSE  

{
  "order_id": 641,
  "token": "f4puMEFFDZcx9nv5HoNHIkPe9qghvBQo"
}

Get order

購入が既に処理されたかを判断するには注文する APIメソッドを実装します。以下の注文ステータスが利用できます。

New — 注文が作成されたものの、支払いはされていない。
Paid — 注文に対する支払い済み。
Cancelled — 注文はキャンセル済み。
Done — 注文は支払いが完了し、アイテムはインベントリに追加されました。

ステータスの確認は一定の頻度で実行されるべきです。1度だけの確認だと、注文に新しいステータスが付与される前に確認される可能性があるためです。

例

Copy

Full screen

Small screen

var data = null;

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://store.xsolla.com/api/v2/project/44056/order/656");
xhr.setRequestHeader("authorization", "Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE5NjIyMzQwNDgsImlzcyI6Imh0dHBzOi8vbG9naW4ueHNvbGxhLmNvbSIsImlhdCI6MTU2MjE0NzY0OCwidXNlcm5hbWUiOiJ4c29sbGEiLCJ4c29sbGFfbG9naW5fYWNjZXNzX2tleSI6IjA2SWF2ZHpDeEVHbm5aMTlpLUc5TmMxVWFfTWFZOXhTR3ZEVEY4OFE3RnMiLCJzdWIiOiJkMzQyZGFkMi05ZDU5LTExZTktYTM4NC00MjAxMGFhODAwM2YiLCJlbWFpbCI6InN1cHBvcnRAeHNvbGxhLmNvbSIsInR5cGUiOiJ4c29sbGFfbG9naW4iLCJ4c29sbGFfbG9naW5fcHJvamVjdF9pZCI6ImU2ZGZhYWM2LTc4YTgtMTFlOS05MjQ0LTQyMDEwYWE4MDAwNCIsInB1Ymxpc2hlcl9pZCI6MTU5MjR9.GCrW42OguZbLZTaoixCZgAeNLGH2xCeJHxl8u8Xn2aI");

xhr.send(data);

//RESPONSE

{
  "content": {
    "is_free": false,
    "items": [
      {
        "is_free": false,
        "price": {
          "amount": "0.9950",
          "amount_without_discount": "1.9900",
          "currency": "USD"
        },
        "quantity": 123,
        "sku": "gun_1"
      }
    ],
    "price": {
      "amount": "122.3850",
      "amount_without_discount": "122.3850",
      "currency": "USD"
    }
  },
  "order_id": 656,
  "status": "new"
}

ご意見ありがとうございました！

あなたのメッセージを確認し、体験を向上させるために利用させていただきます。

最終更新日: 2024年10月3日

誤字脱字などのテキストエラーを見つけましたか？テキストを選択し、Ctrl+Enterを押します。

Your browser is not supported. Please try a different browser

人気記事

またはよくある質問を選ぶ:

以下の出典に基づく回答:

ご意見・ご感想をお寄せください（任意）

ご意見・ご感想をお寄せください（任意）

インゲームストア

インベントリ。期間限定アイテム

どのように動作するか

使用に適した方

入手方法

前提条件

統合フロー

カタログでの期間限定アイテムを取得する

期間限定アイテムを購入する

Get cart

Create order with all items

Get order