サーバー側の統合

このタイプの統合は、認証、ゲーム内ストア、プレイヤーのインベントリなどのゲームロジックをすでに自社サーバーに実装しており、エクソラ決済ステーションを利用したいと考えているパートナーに適しています。決済ステーションアクセストークンを取得し、ウェブフックの取り扱いを設定する必要があります。

サーバー統合時には、以下のような決済処理ロジックが実装されています：

1. クライアントは、アプリケーションサーバーにリクエストを送信して、決済インターフェースを開きます。
2. アプリケーションサーバーは、エクソラサーバーに決済通貨と金額に関する情報を送信します。
3. エクソラサーバーは、購入詳細と決済ステーションのパラメータを含むトークンを返します。
4. アプリケーションサーバは、受信したトークンをクライアントに送信します。
5. クライアントは、SDKを使用してブラウザで決済ステーションを開きます。
6. 購入代金を支払った後、決済状況が記載されたウェブフックがアプリケーションサーバーに送信されます。

統合フロー

Game Commerceアセットを使用してエクソラ製品をサーバーに統合するには：

1. アセットをインストールします。
2. あなたのパブリッシャーアカウントでプロジェクトを設定します。
3. サーバーにゲーム内ストアと商品カタログを設定します。
4. Unityプロジェクトを設定します。
5. トークンを取得します。
6. 決済UIを開きます。
7. ウェブフック処理を設定します。

統合が完了したら、決済プロセスをテストできます。

統合チームにお問い合わせください

右下のチャットアイコンをクリックし、メッセンジャーで統合チームまでお問い合わせください。私たちはリアルタイムで回答し、問題解決をお手伝いします。

アセットをインストールする

1. Unityのダウンロード。
2. あなたの好みに合わせて、個人用またはプロフェッショナル用のUnityライセンスをお選びください。
3. Unityのプロジェクトを新規に作成します。
4. アセットのダウンロード。
5. パッケージを解凍してください。
6. UnityのエディタでAssets > Import Package > Custom Packageクリックし、アセットを選択します。
7. ゲームビルドの作成にMonoコンパイラーが使用されていることを確認してください（スタンドアロンビルドの場合のみ）。これを行うには:

1. 1. クリックEdit > Project Settingsメインメニューに表示します。
   2. そこに行ってみてOther Settings > Configurationセクションをご覧ください。
   3. 確認することはMono選択Scripting Backendフィールド。

アセットをインストールした後、Assets > Xsolla > DemoCommon > SceneディレクトリからXsollusデモシーンを起動します。デモシーンは、アセットの機能を表示し、アプリケーションロジックの可能な実装を表します。

デモシーンでは、パブリッシャーアカウントのプロジェクトがプリセットされ、ゲーム内ストアが完全に設定されています。

Xsollusデモシーンのデフォルト値：

デモシーンは2つの方法で使用することができます：

• 例えば
• ログインシステム、インベントリ、ゲーム内ストアの初期バージョンとして、迅速な結果を得て、必要に応じて機能を拡張することができます

デモシーンやそのパーツをアプリケーションで使用するには、ビルド設定で追加します：

1. Assets > Xsolla > DemoCommon > Sceneに移動して、Xsollusシーンを起動します。
2. File > Build settingsを開き、Add Open Scenesをクリックします。

アドミンページでプロジェクトを作成する

1. パブリッシャーアカウントにサインアップします。
2. プロジェクトを構成します：
   1. ゲームデータを自動的に入力するには、任意のプラットフォームでゲームへのリンクを入力します。その結果、ゲームの画像、名前、説明がプロジェクト設定に追加されます。
   2. ゲームデータを手動で入力するには、リンクがありませんで、手動でセットアップしますをクリックし、以下のことを指定してください：
      • プロジェクト言語（既定では英語が設定されています）
      • 指定されたすべての言語のプロジェクト名
      • ゲームウェブサイト（任意）
   3. プロジェクトを作成するをクリックします。

統合には以下のパラメータが必要です：

• プロジェクト設定>ウェブフックでのマーチャントID。

• 会社設定 > APIキーセクションでのAPIキー。

• プロジェクトIDは、プロジェクト名の横にあるパブリッシャーアカウントで確認できます。

• プロジェクト設定 > ウェブフックセクションでの秘密鍵。

Unityプロジェクトをセットアップする

1. Unityプロジェクトを開きます。
2. メインメニューのWindow > Xsolla > Edit Settingsをクリックします。をクリックします。
3. サンドボックスモードを有効にするには、InspectorパネルのEnable sandbox?ボックスをチェックします。

4. アプリケーションのログインシステム、ゲーム内ストア、その他のページのインターフェイスをデザインします。Unity説明に従って、独自のソリューションを作成することができます。
5. SDKメソッドを使って、アプリケーションロジックに応じたイベント処理を設定します。

トークンを取得する

トークンを取得するには、Create payment token by server APIコールを使用します。サーバーは、以下のデータを含むリクエストをエクソラサーバーに送信する必要があります：

• 購入したユーザーのID
• 支払い額
• 決済通貨
• 購入明細（任意）
• 決済ステーションパラメータ（任意）

以下のいずれかの方法で購入情報を渡すことができます：

• itemパラメータを介してアイテムのリストとして
• descriptionパラメータを介して購入の説明として

決済ステーションンのパラメータ（例：ローカライゼーション言語、インターフェースのプロパティ、テーマ）は、settingsオブジェクトに渡されます。サンドボックスモードを有効/無効にするには、トークンを受信するリクエストのsandboxパラメータの値を変更し、SDKの設定を変更する必要があります。決済ステーションのインターフェースの残りの設定を変更するには、トークンの要求のパラメータを変更する必要があります。

決済UIを開く

決済UIを開くには、前のステップで取得したトークンをOpenPurchaseUiSDKメソッドに渡します。

ウェブフックの設定

1. パブリッシャーアカウントに移動します。
2. プロジェクト設定>ウェブフックに移動し、ウェブフックURLを指定し、秘密鍵を生成してプロジェクトウェブフックにサインします。

3. 設定を保存します。
4. 決済ステーションに次のウェブフックを実装します：
   • ユーザー検証
   • 決済
   • 返金

5. チェックアウトタブに移動し、接続をクリックします。

6. ウェブフックハンドラをテストします。

7. サイドメニューの決済ステーション をクリックして、設定に移動します。
8. チェックアウトトグル をオンに設定します。

9. 保存をクリックします。

支払処理をテストする

アセットの設定が完了した後、決済プロセスをテストします。デフォルトでは、どのユーザーに対しても、すべてのはサンドボックスモードで行われます。テスト用の銀行カードを使って、決済の成功をシミュレーションします。

実際の決済を行って支払処理をテストするには：

1. エクソラと契約を結んでいることを確認してください。
2. Unityプロジェクトで、InspectorパネルのEnable sandbox?チェックボックスからチェックを外します。
3. トークンのリクエストで、sandboxパラメータをfalseに設定します。