クイックスタート

統合フロー

支払いソリューションを統合するためには、以下の手順を実行します：

1. パブリッシャーアカウントでプロジェクトを作成します。1つのプロジェクトは1つのゲームに対応します。複数のゲームがある場合、各ゲームごとにプロジェクトを追加します。
2. エクソーラ側のカタログに販売したいアイテムを追加します。
3. ユーザーが支払う注文を作成するテストを行います。
4. テスト購入を行い、通知の設定を行います。
5. 実際の支払い処理を開始するために、パブリッシャーアカウントでエクソーラとのライセンス契約に署名します。

カタログを作成する

仮想アイテムは、ユーザーが実際通貨や仮想通貨で購入できるゲーム内コンテンツです。エクソーラ側で仮想アイテムのカタログを作成することにより、地域別の価格設定や制限をカスタマイズし、エクソーラプロモーションシステムや定期的に追加・更新される他の機能を利用できます。

仮想アイテムを作成する

• アドミンページで構成
• API経由で構成

1. アドミンページでプロジェクトを開きます。
2. サイドメニューでストアをクリックします。
3. 仮想アイテムペインで、以下をクリックします：
   • 接続 — 以前に仮想アイテムを構成したことがない場合。
   • 構成 — 以前に仮想アイテムを構成した場合。
4. 「アイテムを作成する」をクリックします。

5. アイテムに関する情報を指定します。必須フィールド：
   • SKU — 一意のアイテムID
   • アイテム名
   • 説明
   • 実際通貨での価格
6. ストアにアイテムを表示するトグルをオンに設定します。
7. アイテムを作成するをクリックします。

次のステップでは、作成したアイテムのSKUが必要です。

仮想アイテムを設定するには、仮想アイテムと通貨グループの「管理者」サブセクションからAPIコールを使用します。

お知らせ

このAPIコールの使用方法の詳細については、統合ガイドを参照してください。

アイテムリストを取得する

アイテムのリストを取得するには、仮想アイテムのリストを取得するAPIメソッドを呼び出します。リクエストで、project_idパラメータ（パブリッシャーアカウントで確認できるプロジェクトID）を渡します：

リクエストでは、プロジェクトで作成された仮想アイテムに関する詳細情報を受け取ります。以降の注文の作成には、items.sku パラメータで渡されるアイテム SKU が必要です。

注文を作成する

注文は、ユーザーがストアで購入したい商品で構成されます。注文の支払いが完了すると、ユーザーはアイテムを受け取ることができます。決済を行うには、ユーザーがゲーム内で認証されている必要があります。

ゲームに合った統合方法を選択すると、設定方法が表示されます。

• サーバー側
• クライアント側

購入用の決済トークンを作成するAPIメソッドを呼び出し、このメソッドでユーザーとアイテムに関する情報を渡します。このAPIコールを使用して、単一のアイテムや複数のアイテムを販売できます。

サンドボックスモードを使用するには、トークンを取得するリクエスト本文に"sandbox": trueパラメータを渡します。

リクエストの例：

Copy

Full screen

Small screen

curl -i -X POST \
  -u 224575:MYAPIKEY \
  https://sandbox-secure.xsolla.com/api/v2/project/224575/admin/payment/token \
  -H 'Content-Type: application/json' \
  -d '{
    "user": {
      "id": {
        "value": "myUserID"
      }
    },
    "purchase": {
      "sandbox": true,
      "items": [
        {
          "sku": "mySKU",
          "quantity": 1
        }
      ]
    }
  }'

エクソーラログインを統合するには：

1. プロジェクトを作成します。
2. アドミンページでログインプロジェクトをセットアップします。
3. ユーザーデータストレージを接続します。
4. アプリケーション側でソリューションを統合します。

構成されたログイン方法を使用して、決済トークンを受け取るための認証トークンを作成して保存します。決済トークンは、決済UIを開いて支払いを行うために使用されます。

決済フローをテストするために、指定したアイテムで注文を作成するAPIコールを使用して注文を作成します：

1. APIドキュメンテーションウェブサイトでテストを実行する場合は、Try itをクリックしてリクエストを作成するためのインターフェイスを開きます。
2. SecurityブロックのBearer Tokenフィールドに、認証手続きの通過時に取得したトークンを入力します。
3. Bodyブロックには、注文の詳細（数量や品目数量など）を渡します。サンドボックスモードにアクセスするには、"sandbox": trueを渡します。
4. Parametersブロックで、以下を渡します：
   • project_id — アドミンページで確認できるプロジェクトID。
   • item_sku — アイテムSKU。

レスポンスでは、今後の作業に必要なデータを受け取ります：

• token — 決済トークン

リクエストの例：

Copy

Full screen

Small screen

curl -i -X POST \
  'https://store.xsolla.com/api/v2/project/{project_id}/payment/item/{item_sku}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "sandbox": true,
    "quantity": 5,
    "settings": {
      "ui": {
        "theme": "63295a9a2e47fab76f7708e1",
      }
    },
    "custom_parameters": {
      "character_id": "ingameUsername"
    }
  }'

お知らせ

エクソーラAPIを呼び出すには、ゲームエンジンやプラットフォームに対応したSDKの既成のメソッドを利用することができます。

• Unity
• Unreal Engine
• Cocos Creator
• Android

テスト購入を行う

サンドボックスモードで決済UIを開く

決済UIを新しいウィンドウで開くには、以下のURLをご利用ください：https://sandbox-secure.xsolla.com/paystation4/?token=TOKEN。TOKENは注文を作成する時に取得したトークンです。

他の方法を使用して決済UIを開く場合は、ドキュメンテーションを参照してください。

テスト支払いを行う

1. サンドボックスモードで決済UIを開きます。
2. 決済方法の「クレジットカード」を選択します。
3. クレジットカードの詳細を入力します。他のフィルドで（例えば、名前または住所）、いずれかのデータを入力できます。間違った内容（カード番号や有効期限）を指定して、エラーが発生するかどうかをテストすることもできます。
4. 支払うをクリックします。

テストカード一覧

テストバンクカードの一覧を参照してください。

ウェブフックのセットアップ

サーバー側での統合を設定した場合、作成された注文をウェブフックへの応答として送信することによって検証する必要があります。クライアント側で統合を設定した場合、ウェブフックにより、設定されたイベント（例：支払いステータスの変更）に関する通知を受け取ることができます。

PHP SDK

ウェブフック処理には既製のクラスを使用します。

エクソーラ側でウェブフックをセットアップにするには：

1. アドミンページであなたのプロジェクトを開きます。
2. サイドメニューでプロジェクト設定をクリックしてウェブフックに移動します。
3. ウェブフックトグルをオンにします。
4. ウェブフックURLを指定します。
5. プロジェクトのウェブフックに署名するための秘密鍵は、デフォルトで生成されます。新しい秘密鍵を生成する場合は、更新アイコンをクリックします。
6. 設定を保存するをクリックします。

ユーザーの検証および成功した支払いに関する通知を受け取るために、以下のウェブフックを設定してください：

• ユーザー検証 — ゲームに登録されたユーザーを確認するための通知用。
• 支払い — 支払いが行われたことを通知するための通知用。

ウェブフックリスナーを構成する

ウェブフックリスナーは、指定されたURLアドレスで受信したウェブフックを受信し、署名を生成し、エクソーラウェブフックサーバーに応答を送信できるようにするプログラムコードです。

起動

ライセンス契約に署名する

ライセンス契約に署名すると、エクソーラがサポートする任意の支払い方法で実際の支払いを受け取ることができます。ライセンス契約に署名するには：

1. アドミンページを開きます。
2. サイドメニューで契約と税金 > 契約セクションに移動します。
3. ライセンス契約タブでアプリケーションフォームに記入するをクリックします。
4. 該当するフィールドに情報を入力します。

アプリケーションは3営業日以内に審査されます。確認作業中に不明な点があった場合、エクソーラはアプリケーションに記載された連絡先に通知します。エクソーラ側での確認手続きが完了すると、契約書のステータスが署名済みに変更されます。

本番環境へ切り替える

上記の手順を完了すると、実際の支払いの受け取りを開始できます：

1. エクソーラとのライセンス契約に署名していることを確認してください。
2. トークンを取得するときは、リクエスト本文から"sandbox": trueパラメータを削除します。
3. 次のリンクを使用して決済UIを開きます：https://secure.xsolla.com/paystation4/?token=TOKEN。

このページを評価する

改善できることはありますか？ 送信

答えたくない

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