サーバー側の統合

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

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

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 > Xsolla Content > Mapsディレクトリからデモマップを起動します。デモマップは、プラグインの機能を示し、アプリケーションロジックの可能な実装を表します。

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

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

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

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

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

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

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

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

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

• プロジェクト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に設定します。

このページを評価する

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

答えたくない

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