注文を履行する

ウェブフックのセットアップ

サーバー側での統合を設定した場合、作成された注文をウェブフックへの応答として送信することによって検証する必要があります。クライアント側で統合を設定した場合、ウェブフックにより、設定されたイベント（例：支払いステータスの変更）に関する通知を受け取ることができます。

PHP SDK

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

エクソーラ側でウェブフックをセットアップにするには：

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

以下のウェブフックを実装することを推奨します：

ウェブフックリスナー

ウェブフックリスナーは、指定された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のコードを含む応答が受信された場合、ユーザー検証ウェブフックは再送信されません。

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

ユーザーに購入を許可する

決済が成功した後、ゲーム内でユーザーに購入を許可することをお客様側で実装します。決済成功の通知や注文内容の通知を受け取るには、以下のウェブフックを設定します：

• 決済
• ご注文の決済が完了した