ウェブフックの設定

ウェブフックは、パラメータとそれに対応する値で構成されるプログラムコードです。特定のイベントが発生すると、パラメータの値が更新されたHTTPリクエストがアプリケーションに送信されます。これは通常、JSON形式のPOSTリクエストです。

イベントの例：ユーザーによるアイテムカタログの操作、決済、注文のキャンセル。

ウェブフックのリスト

イベント通知を受け取りたい場合は、ウェブフック処理を実装してください：

• 決済 — 注文が支払われたときに送信され、決済データおよび取引の詳細が含まれます。
• ご注文の決済が完了した — 決済ウェブフックが正常に処理されたときに送信され、購入したアイテムに関する情報とトランザクションIDが含まれます。
• 返金 — 注文がキャンセルされたときに送信され、キャンセルされた決済データと取引の詳細が含まれます。
• 注文キャンセル — 返金ウェブフックが正常に処理されたときに送信され、購入したアイテムに関する情報とキャンセルされたトランザクションのIDが含まれています。
• ユーザー検証 — ユーザーがゲームに登録されていることを確認するために、支払いプロセスのさまざまな段階で送信されます。ゲームキーを購入したユーザーに関する情報が含まれています。

アイテムカタログのパーソナライゼーションがアプリケーション側で実装されている場合は、パートナー側でカタログのパーソナライゼーションの処理を設定します。

external ID（システム上のトランザクションID）を使用していて、エクソーラ側でトランザクションIDと関連付けたり、ユーザー検証時に追加パラメータを渡したい場合は、トランザクションのIDをリンクするウェブフックを実装します。

アドミンページでのウェブフックの設定

ウェブフックをセットアップするには：

1. アドミンページであなたのプロジェクトを開きます。
2. サイドメニューで「プロジェクト設定」をクリックし、「ウェブフック」に移動します。
3. 「ウェブフック」トグルを「オン」に設定します。
4. https://example.com形式でウェブフックを受信したいURLを指定します。
5. プロジェクトのウェブフックに署名するための秘密鍵は、デフォルトで生成されます。新しい秘密鍵を生成したい場合は、更新アイコンをクリックします。
6. 「設定を保存」をクリックします。

アドミンページでのウェブフックのテスト

external ID（システム上のトランザクションID）を使用していて、エクソーラ側でトランザクションIDと関連付けたり、ユーザー検証時に追加パラメータを渡したい場合は、トランザクションのIDをリンクするウェブフックを実装します。

ウェブフックが正常にセットアップされると、ウェブフックセットアップブロックの下にウェブフックテストブロックが表示されます。

• 「ご注文の決済が完了した」と「注文のキャンセル」
• 決済とユーザー検証

お知らせ

テストには、少なくとも1つのゲームキーパッケージを作成する必要があります。

「ご注文の決済が完了した」と「注文キャンセル」のウェブフックをテストするには：

1. ウェブフックテストブロックで、「ストア」タブに移動します。
2. ドロップダウンメニューで、「ゲームキー」を選択します。ゲームキーパッケージがアドミンページで設定されていない場合、次のいずれかのボタンが表示されます：
   • 接続する – 「ゲームキー」モジュールが接続されていない場合
   • 構成する – 以前にモジュールを接続したが、セットアップを完了していない場合

3. 「エクソーラ注文ID」フィールドに任意の値を入力します。
4. ドロップダウンリストからゲームキーパッケージを選択します。
5. ゲームパブリッシングプラットフォームを指定します。
6. 「金額」フィールドにゲームキーの任意の値を指定します。
7. 注文の支払い通貨を選択します。
8. 「テスト」をクリックします。

指定されたデータを含む「ご注文の決済が完了した」と「注文キャンセル」のウェブフックが指定されたURLに送信されます。各ウェブフックタイプのテスト結果は、「テスト」ボタンの下に表示されます。

お知らせ

テストに合格しなかったことを示すエラーメッセージがテストブロックに表示された場合は、ウェブフックリスナーのウェブフック応答設定を確認してください。これらのエラーに関する情報は、テスト結果に記載されています。

決済とユーザー検証のウェブフックをテストするには：

1. ウェブフックのテストブロックで、「決済ソリューション」タブに移動します。
2. 必要なフィールドを入力してください：
   • ユーザーID
   • エクソーラ請求書ID — エクソーラ側のトランザクションID
   • 金額
   • 通貨 — ドロップダウンリストから通貨を選択します
   • 請求書ID — ゲーム側のトランザクションID

1. テストには任意の値を使用できます。

1. ユーザーIDフィールドの値は、ゲーム内にユーザーが存在するかどうかを確認するために使用されます。テスト中に成功した応答を受け取りたい場合は、サーバーで正常に検証できる値を「ユーザーID」フィールドに入力してください。

3. 「テスト」をクリックします。

指定されたデータを含む「決済」と「ユーザー検証」のウェブフックが指定されたURLに送信されます。各ウェブフックタイプのテスト結果は、「テスト」ボタンの下に表示されます。

お知らせ

テストに合格しなかったことを示すエラーメッセージがテストブロックに表示された場合は、ウェブフックリスナーのウェブフック応答設定を確認してください。これらのエラーに関する情報は、テスト結果に記載されています。

ウェブフックリスナー

ウェブフックリスナーは、指定されたURLアドレスで受信したウェブフックを受信し、署名を生成し、エクソーラウェブフックサーバーに応答を送信できるようにするプログラムコードです。

署名の生成

ウェブフックを受信する場合、データ伝送のセキュリティを確保する必要があります。そのためには、ウェブフックのデータから署名を生成し、それがHTTPリクエストヘッダで送信された署名と一致することを検証する必要があります。

署名を生成するには：

1. リクエスト本文のJSONとプロジェクトの秘密鍵を連結します。
2. 最初のステップで取得した文字列にSHA-1暗号化ハッシュ関数を適用します。

ウェブフックへの応答の送信

ウェブフックの受信を確認するには、サーバーが以下のことを返す必要があります：

• 応答が成功した場合のメッセージ本文のない204 HTTPコード。
• 指定されたユーザーが見つからなかったり、無効な署名が渡された場合、問題に関する説明が記載された400 HTTPコードが表示されます。

ウェブフックハンドラーは、サーバーに一時的な問題が発生した場合に5xxコードを返すこともあります。

「ご注文の決済が完了した」と「注文キャンセル」のウェブフックで応答を受信しなかった場合、または5xxコードの応答を受信した場合、以下のスケジュールでウェブフックを再送信します：

• 5分間隔で2回再試行
• 15分間隔で7回再試行
• 60分間隔で10回再試行

ウェブフックの送信は、最初の試行から12時間以内に最大20回まで試行されます。

決済ウェブフックの応答が受信されなかった場合、または5xxコードを含む応答を受け取った場合は、ウェブフックも時間間隔を空けて再送信されます。12時間以内に最大12回の試行が行われます。

ユーザー検証ウェブフックに対する応答が受信されなかった場合、400または5xxのコードを含む応答が受信された場合、ユーザー検証ウェブフックは再送信されません。

この場合、ユーザーにはエラーが表示され、「決済」と「ご注文の決済が完了した」のウェブフックは送信されません。

このページを評価する

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

答えたくない

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

続きを読む