販売アイテムを設定する

アイテムの販売

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

1. 1つの商品を迅速で購入することができます。この場合、1つのSKUを任意の数量で販売することができます（例えば、100個の同じポーションや、カスタム量の仮想通貨など）。
2. カート購入。この場合、プレイヤーはあらかじめカートに商品を入れておき、その後、商品の追加や削除、数量の変更を行うことができます。

迅速な購入

カート購入

1. カートをセットアップしてトークンを取得するには：
   • クライアント上 — 自分でアプリケーションにカートを実装する場合。
   • サーバー上 — エクソーラのソリューション（In-Game Store APIコール）を使用してカートを管理する場合。
2. 決済UIを開くには。

クライアントでカートをセットアップして購入する

アイテムの追加と削除のロジックを自分で実装します。また、カートを設定するためのAPIを呼び出す前には、どのプロモーションが購入に適用されるかの情報がないことを考慮する必要があります。つまり、追加されたボーナスアイテムの合計金額と詳細は不明です。

1. プレイヤーがカートを満たした後、カートにアイテムを入れる APIを呼び出します。選択されたアイテムの現在の情報（割引前、割引後の価格、ボーナスアイテム）がレスポンスに渡されます。
2. 現在のカートの全アイテムを対象とした注文を作成する 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を開くためのトークンは、現在のカートの全アイテムを対象とした注文を作成する APIレスポンスに渡されます。

以下のいずれかの方法で支払い UI を開くように実装します：

• 新しいウィンドウで。新しいブラウザウィンドウで決済UIを開くには、次のリンクを使用します：https://secure.xsolla.com/paystation3/?access_token=ACCESS_TOKENでトークンACCESS_TOKENが注文が作成されたときに受け取る。
• ウィジェット経由。エクソーラ決済ステーションウィジェットスクリプトを使用します (READMEファイルには説明が含まれています)。