注文状況追跡のセットアップ

ユーザーにアイテムを付与するには、支払いが成功したことを確認する必要があります。

作成された注文のステータスを追跡して検証するには、アプリケーションのサーバー側でウェブフック処理を構成する必要があります。

インゲームストアを完全に操作するには、主要なウェブフックの処理を実装する必要があります：

ウェブフック処理には既製のクラスを使用します。

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

ウェブフックの完全なリストと、ウェブフックの操作に関する一般情報については、ウェブフックのドキュメンテーションを参照してください。

ウェブフックの送信を設定する

エクソーラ側でウェブフックを構成するには：

ウェブフックをテストするには、webhook.siteなどの専門サイトや、ngrokなどのプラットフォームを選択することもできます。実際のプロジェクトでは、購入検証ロジックを追加する必要があります。

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

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

署名を生成するには：

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

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

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

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

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

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

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

ウェブフックの完全なリストとメカニズム、およびその処理の詳細な事例については、ウェブフックドキュメンテーションに記載されています。

進捗状況

最終更新日: 2024年7月18日

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