サーバー側の統合
このタイプの統合は、認証、ゲーム内ストア、プレイヤーのインベントリなどのゲームロジックをすでに自社サーバーに実装しており、エクソラ決済ステーションを利用したいと考えているパートナーに適しています。決済ステーションアクセストークンを取得し、ウェブフックの取り扱いを設定する必要があります。
サーバー統合時には、以下のような決済処理ロジックが実装されています:
- クライアントは、アプリケーションサーバーにリクエストを送信して、決済インターフェースを開きます。
- アプリケーションサーバーは、エクソラサーバーに決済通貨と金額に関する情報を送信します。
- エクソラサーバーは、購入詳細と決済ステーションのパラメータを含むトークンを返します。
- アプリケーションサーバは、受信したトークンをクライアントに送信します。
- クライアントは、SDKを使用してブラウザで決済ステーションを開きます。
- 購入代金を支払った後、決済状況が記載されたウェブフックがアプリケーションサーバーに送信されます。
統合フロー
Game Commerceプラグインを使用してエクソラ製品をサーバーに統合するには:
- プラグインをインストールします。
- あなたのパブリッシャーアカウントでプロジェクトを設定します。
- サーバーにゲーム内ストアと商品カタログを設定します。
- UE4プロジェクトを設定します。
- トークンを取得します。
- 決済UIを開きます。
- ウェブフック処理を設定します。
統合が完了したら、決済プロセスをテストできます。
プラグインをインストールする
- Epic Gameランチャーをダウンロードします。
- 新しいUE4プロジェクトを作成します。
- Unreal EngineマーケットプレイスまたはGitHubからプラグインをダウンロードします。
プラグインをインストールした後、
デモマップでは、パブリッシャーアカウントのプロジェクトがプリセットされ、ゲーム内ストアが完全に設定されています。
デモマップのデフォルト値:
Key | Value |
---|---|
ログインID | 026201e3-7e40-11ea-a85b-42010aa80004 |
プロジェクトID | 77640 |
デモマップは2つの方法で使用することができます:
- 例えば
- ログインシステム、インベントリ、ゲーム内ストアの初期バージョンとして、迅速な結果を得て、必要に応じて機能を拡張することができます
パブリッシャーアカウントでプロジェクトを作成する
- パブリッシャーアカウントに登録します。
- プロジェクトを構成します:
- ゲームデータを自動的に入力するには、任意のプラットフォームでゲームへのリンクを提供してください。プロジェクトの設定に、ゲームの画像、名前、説明文を追加します。
- ゲームデータを手動で入力するには、リンクがありませんので、手動でセットアップしますをクリックし、以下のことを指定してください:
- プロジェクト言語(デフォルト:英語)
- 指定されたすべての言語のプロジェクト名
- ゲームウェブサイト(任意)
- プロジェクトを作成するをクリックします。
統合には以下のパラメータが必要です:
- プロジェクト設定>ウェブフックでのマーチャントID。

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

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

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

UE4プロジェクトをセットアップする
- Unreal EditorでUE4プロジェクトを開きます。
- ブループリントプロジェクトの場合のみ:
- UE4プロジェクトをコンパイルします。
Content Browser に移動してNew C++ Class をNone の親ノードに追加します。
Settings > Plugins > Installed > Xsolla Store SDK に移動します。Enabled ボックスをチェックして、Restart Now ボタンをクリックして設定を保存し、Unreal Editorをリロードします。
Content Browser > View Options に移動し、Show Engine Content とShow Plugin Content ボックスをチェックに入れます。

- アプリケーションのログインシステム、ゲーム内ストア、その他のページのインターフェイスをデザインします。UMG UI説明書に従って、独自のソリューションを作成することができます。
- SDKメソッドを使って、アプリケーションロジックに応じたイベント処理を設定します。
トークンを取得する
トークンを取得するには、
- 購入したユーザーのID
- 支払い額
- 決済通貨
- 購入明細(任意)
- 決済ステーションパラメータ(任意)
以下のいずれかの方法で購入情報を渡すことができます:
item
パラメータを介してアイテムのリストとしてdescription
パラメータを介して購入の説明として
決済ステーションンのパラメータ(例:ローカライゼーション言語、インターフェースのプロパティ、テーマ)は、settings
オブジェクトに渡されます。サンドボックスモードを有効/無効にするには、トークンを受信するリクエストのsandbox
パラメータの値を変更し、SDKの設定を変更する必要があります。決済ステーションのインターフェースの残りの設定を変更するには、トークンの要求のパラメータを変更する必要があります。
custom_parameters
パラメータを使用して追加情報を渡すことができます。この情報は、設定されたウェブフックにも渡されます。決済UIを開く
決済UIを開くには、前のステップで取得したトークンをLaunchPaymentConsoleWithAccessToken
SDKメソッドに渡します。
ウェブフックの設定
- パブリッシャーアカウントに移動します。
- プロジェクト設定>ウェブフックに移動し、ウェブフックURLを指定し、秘密鍵を生成してプロジェクトウェブフックにサインします。

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

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

- メッセージ本文のないHTTPコード204
- 指定されたユーザーが見つからなかった場合、または無効な署名が渡された場合の問題を記述するHTTPコード400
- サイドメニューの決済ステーション をクリックして、設定に移動します。
- チェックアウトトグル をオンに設定します。

- 保存をクリックします。
支払処理をテストする
プラグインの設定が完了した後、決済プロセスをテストします。デフォルトでは、すべての決済はサンドボックスモードになっており、テスト用の銀行カードを使って、決済プロセスの成功をシミュレートすることができます。
実際の決済を行って支払処理をテストするには:
- エクソラと契約したことを確認してください。
- UE4プロジェクトで、
Settings > Project Settings > Plugins > Xsolla Payments のSandbox チェックボックスからチェックを外します。 - トークンのリクエストで、
sandbox
パラメータをfalse
に設定します。
この記事は役に立ちましたか?
このページを評価する
答えたくない
ご意見ありがとうございました!
誤字脱字などのテキストエラーを見つけましたか? テキストを選択し、Ctrl+Enterを押します。