サーバー側の統合

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

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

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

ディスコードサーバー
エクソラチームおよびエクソラ製品を使用する開発者とつながります。

統合フロー

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

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

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

Note
このガイドでは、モジュールのクイックスタートに必要な最低限の設定について説明します。ご質問がある場合は、アカウントマネージャーにお問い合わせください。

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

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

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

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

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

KeyValue
ログインID026201e3-7e40-11ea-a85b-42010aa80004
プロジェクトID77640

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Note
アプリケーションの仕様に合わせてSDKを変更するには、SDKの変更手順に従ってください。

トークンを取得する

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

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

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

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

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

Note
custom_parametersパラメータを使用して追加情報を渡すことができます。この情報は、設定されたウェブフックにも渡されます。

決済UIを開く

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

ウェブフックの設定

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

  1. 設定を保存します。
  2. 決済ステーションに次のウェブフックを実装します:

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

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

Note
ウェブフックの受信を確認するには、サーバーが以下のことを応答しなければなりません:
  • メッセージ本文のないHTTPコード204
  • 指定されたユーザーが見つからなかった場合、または無効な署名が渡された場合の問題を記述するHTTPコード400
APIリファレンスでは、例を含むウェブフックの詳細を読むことができます。

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

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

支払処理をテストする

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

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

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

この記事は役に立ちましたか?
ありがとうございます!
改善できることはありますか? メッセージ
申し訳ありません
この記事が参考にならなかった理由を説明してください。 メッセージ
ご意見ありがとうございました!
あなたのメッセージを確認し、体験を向上させるために利用させていただきます。
このページを評価する
このページを評価する
改善できることはありますか?

答えたくない

ご意見ありがとうございました!
最終更新日: 2021年6月25日

誤字脱字などのテキストエラーを見つけましたか? テキストを選択し、Ctrl+Enterを押します。

問題を報告する
当社は常にコンテンツを見直しています。お客様のご意見は改善に役立ちます。
フォローアップ用のメールをご提供してください
ご意見ありがとうございました!