ユーザーに購入権限を付与する

トランザクションステータスに関するエクソーラからの情報を使用して、アプリケーション内でユーザーへの購入権限付与を実装します。次の方法で情報を取得できます：

• APIを使用して情報を要求する
• ウェブフックを使用して自動的に情報を受け取る

APIを使用して情報を要求する

ユーザーが購入した仮想アイテム、仮想通貨、またはバンドルに関する情報は、エクソーラ側のプレイヤーのインベントリから入手できます。ウェブショップでの購入と、購入を許可する際に他の方法による購入の両方を考慮するには、アプリケーション側とエクソーラ側でプレイヤーのインベントリに関する情報を同期します。

インベントリを管理するためのAPIコールには、次のグループが含まれます：

• サーバー側のコール：
  • アイテムをユーザーに付与する
  • インベントリアイテムを取り消す
  • 購入したアイテムをユーザーに付与する

• クライアント側のコール：
  • 現在のユーザーインベントリーを取得する
  • 現在のユーザーの仮想残高を取得
  • アイテムを消費する

基本HTTP認証

リクエストにはAuthorization: Basic <your_authorization_basic_key>ヘッダーが含まれている必要があります。<your_authorization_basic_key>はマーチャントID：APIキーのペアで、Base64の基準に従ってエンコードしています。アドミンページに移動して、次のパラメータを見つけます：

• マーチャントIDは以下の場所で表示されます：
  • プロジェクト設定 > ウェブフックセクション。
  • 会社設定 > 会社セクション。
  • アドミンページページのブラウザーアドレスバーのURL。URLは以下の形式があります：https://publisher.xsolla.com/​マーチャントID/アドミンページセクション。

• APIキーは、作成時に一度だけアドミンページに表示され、お客様側で保存する必要があります。次のセクションで新しいキーを作成できます：
  • 会社設定 > APIキー
  • プロジェクト設定 > APIキー

サーバー OAuth 2.0認証

リクエストにはAuthorization: Bearer <user_JWT>ヘッダーを含める必要があります。<user_JWT>はユーザーJWTです。

ユーザーJWTを取得するには、以下の手順で行います：

1. サーバーOAuth 2.0クライアントを作成するには：
   1. アドミンページであなたのプロジェクトを開きます。ログイン > あなたのログインプロジェクトに移動して構成をクリックします。
   2. セキュリティブロックで、OAuth 2.0をクリックします。
   3. OAuth 2.0を追加するをクリックして以下のことを指定します：
      • クライアント名。
      • OAuth 2.0のリダイレクトURI（必須）。
      • 認証タイプ — サーバー。
      • プロジェクトID。
   4. 接続をクリックします。さらに統合するには、生成されたクライアントIDと秘密鍵が必要になります。

2. サーバーJWTを取得します。これを行うには、JWTを生成するAPIメソッドを呼び出して、以下のパラメータを渡します：
   • grant_type — JWTタイプ。client_credentialsの値を指定します。
   • client_secret — サーバー OAuth 2.0クライアント秘密鍵です。
   • client_id — サーバー OAuth 2.0クライアントID。

3. ユーザーJWTを取得します。これを行うには、Auth by custom ID APIメソッドを呼び出します。リクエストにはX-Server-Authorization: <server_JWT>ヘッダーを含める必要があります。<server_JWT>はステップ2で取得したサーバーJWTです。

ウェブフックを使用して情報を受け取る

1. ウェブフックを受信するためのパラメータを構成します：
   1. アドミンページでプロジェクトを開きます。
   2. サイドメニューのプロジェクト設定をクリックします。
   3. ウェブフックセクションに移動します。
   4. ウェブフックトグルをオンに設定します。
   5. ウェブフックURLフィールドで、ウェブフックを受信するURLを指定します。
   6. プロジェクトウェブフックにサインするための秘密鍵がデフォルトで生成されます。新しい秘密鍵を生成する場合は、更新アイコンをクリックします。
   7. 設定を保存するをクリックします。

2. 以下のタイプのウェブフック処理をアプリケーションに実装します：

1. • 仮想アイテム、仮想通貨、仮想通貨パッケージ、バンドルを付与するには：
     • ユーザー検証
     • 支払い
     • 注文支払い成功

1. • 購入をキャンセルするには：
     • 払い戻し
     • 注文のキャンセル

ウェブフックが受信されたことを確認するには、サーバーは次のように応答する必要があります：

• メッセージ本文なしでHTTPコード204。
• 指定されたユーザーが見つからないか、無効な署名が渡された場合、問題を記述したHTTPコード400が表示されます。

アドミンページのプロジェクト設定 > ウェブフック > ストアセクションのユーザー検証と決済ウェブフックをテストできます。

実数値がない場合は、任意の値を入力できます。

サンドボックスモードまたはライブモードで購入する際にウェブフックをテストすることもできます。返金をテストする機能はライブモードでのみ利用できます。

次のステップ

1. Iサブスクリプション情報の取得を実装します。
2. ユーザー認証をセットアップします。

お役立ちリンク

統合フロー

このページを評価する

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

答えたくない

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