サーバー側の統合

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

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

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

ディスコードサーバー

エクソラチームおよびエクソラ製品を使用する開発者とつながります。

統合フロー

Game Commerceプラグインを使用してエクソラ製品をサーバーに統合するには：

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

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

プラグインをインストールする

1. Epic Gameランチャーをダウンロードします。
2. 新しいUE4プロジェクトを作成します。
3. Unreal EngineマーケットプレイスまたはGitHubからプラグインをダウンロードします。

プラグインをインストールした後、Content Browser > Content > Mapsディレクトリからデモマップを起動します。デモマップは、プラグインの機能を示し、アプリケーションロジックの可能な実装を表します。

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

デモマップのデフォルト値：

デモマップは2つの方法で使用することができます：

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

パブリッシャーアカウントでプロジェクトをセットアップする

1. パブリッシャーアカウントにサインアップします。
2. パブリッシャーアカウントプロジェクトを構成します。アカウントにサインアップすると、最初のプロジェクトが自動的に作成されます：
   1. プロジェクトセクションで、プロジェクトを選択し、プロジェクト設定に移動します。
   2. 一般設定タブで、以下を追加します：
      • イメージ（任意）
      • プロジェクト言語（デフォルトでは英語が設定される）
      • 指定されたすべての言語のプロジェクト名
      • ゲームのウェブサイト（任意）
      • プロジェクトの説明（任意）
   3. 保存するをクリックします。

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

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

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

• プロジェクト設定 > プロジェクトIDでのプロジェクトID。

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

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

1. Unreal EditorでUE4プロジェクトを開きます。
2. ブループリントプロジェクトの場合のみ：
   1. UE4プロジェクトをコンパイルします。
   2. Content Browserに移動してNew C++ ClassをNoneの親ノードに追加します。

3. Settings > Plugins > Installed > Xsolla Store SDKに移動します。Enabledボックスをチェックして、Restart Nowボタンをクリックして設定を保存し、Unreal Editorをリロードします。

4. Content Browser > View Optionsに移動し、Show Engine ContentとShow Plugin Contentボックスをチェックに入れます。

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

トークンを取得する

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

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

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

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

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

決済UIを開く

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

ウェブフックの設定

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

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

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

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

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

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

支払処理をテストする

プラグインの設定が完了した後、決済プロセスをテストします。デフォルトでは、すべての決済はサンドボックスモードになっており、テスト用の銀行カードを使って、決済プロセスの成功をシミュレートすることができます。

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

1. エクソラと契約したことを確認してください。
2. UE4プロジェクトで、Settings > Project Settings > Plugins > Xsolla PaymentsのSandboxチェックボックスからチェックを外します。
3. トークンのリクエストで、sandboxパラメータをfalseに設定します。

このページを評価する

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

答えたくない

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