サーバー側の統合
このタイプの統合は、認証、ゲーム内ストア、プレイヤーのインベントリなどのゲームロジックをすでに自社サーバーに実装しており、エクソラ決済ステーションを利用したいと考えているパートナーに適しています。決済ステーションアクセストークンを取得し、ウェブフックの取り扱いを設定する必要があります。
サーバー統合時には、以下のような決済処理ロジックが実装されています：
- クライアントは、アプリケーションサーバーにリクエストを送信して、決済インターフェースを開きます。
- アプリケーションサーバーは、エクソラサーバーに決済通貨と金額に関する情報を送信します。
- エクソラサーバーは、購入詳細と決済ステーションのパラメータを含むトークンを返します。
- アプリケーションサーバは、受信したトークンをクライアントに送信します。
- クライアントは、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でのプロジェクト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を開くには、前のステップで取得したトークンをLaunchPaymentConsoleWithAccessTokenSDKメソッドに渡します。
ウェブフックの設定
- パブリッシャーアカウントに移動します。
- プロジェクト設定>ウェブフックに移動し、ウェブフックURLを指定し、秘密鍵を生成してプロジェクトウェブフックにサインします。
- チェックアウトタブに移動し、接続をクリックします。
- ウェブフックハンドラをテストします。
- メッセージ本文のないHTTPコード204
- 指定されたユーザーが見つからなかった場合、または無効な署名が渡された場合の問題を記述するHTTPコード400
- サイドメニューの決済ステーション をクリックして、設定に移動します。
- チェックアウトトグル をオンに設定します。
- 保存をクリックします。
支払処理をテストする
プラグインの設定が完了した後、決済プロセスをテストします。デフォルトでは、すべての決済はサンドボックスモードになっており、テスト用の銀行カードを使って、決済プロセスの成功をシミュレートすることができます。
実際の決済を行って支払処理をテストするには：
- エクソラと契約したことを確認してください。
- UE4プロジェクトで、
Settings > Project Settings > Plugins > Xsolla Payments のSandbox チェックボックスからチェックを外します。 - トークンのリクエストで、
sandboxパラメータをfalseに設定します。
この記事は役に立ちましたか？
このページを評価する
答えたくない
ご意見ありがとうございました！
誤字脱字などのテキストエラーを見つけましたか？ テキストを選択し、Ctrl+Enterを押します。
