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

エクソーラから受け取ったトランザクションの詳細および購入したアイテムに関するウェブフックから受信した情報を使用して、アプリケーション内のユーザーに購入を付与する機能を実装します。

組み込みのウェブフックを受信する新しいオプションに切り替えるには、カスタマーサクセスマネージャーに連絡するか、csm@xsolla.comに電子メールを送信してください。

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

• 組み込みのウェブフックを受信した場合
• 個別のウェブフックを受け取った場合

ウェブフック名	説明
ユーザー検証 > ユーザー検証（user_validation）	ユーザーがゲームに登録されていることを確認するため、支払いプロセスのさまざまな段階で送信されます。
ゲームサービス > 組み込みのウェブフック > 注文支払い完了（order_paid）	支払いデータ、トランザクションの詳細、購入した商品に関する情報が含まれます。ウェブフックのデータを使用して、ユーザーにアイテムを追加します。
ゲームサービス > 組み込みのウェブフック > 注文のキャンセル（order_canceled）	キャンセルされた支払いのデータ、取引の詳細、購入した商品に関する情報が含まれます。ウェブフックのデータを使用して、購入したアイテムを削除します。

以下のスキームは、集約ウェブフックを使用してアイテムを購入して返品するプロセスを示しています。

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

以下のスキームは、別のウェブフックを使用してアイテムを購入して返品するプロセスを示しています。

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

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

1. アドミンページでプロジェクトを開きます。
2. サイドメニューの「プロジェクト設定」をクリックし、「ウェブフック」タブに移動します。
3. 「ウェブフックサーバー」フィールドに、https://example.com形式でウェブフックを受信したいサーバーのURLを指定します。ウェブフックをテストするツールで見つけたURLを指定することもできます。
4. プロジェクトのウェブフックに署名するための秘密鍵がデフォルトで生成されます。新しい秘密鍵を生成したい場合は、更新アイコンをクリックします。
5. 「ウェブフックを有効にする」をクリックします。

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

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

アドミンページのテストセクションは、ウェブフック受信オプションによって異なります。

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

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

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

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

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

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

次のステップ

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

お役立ちリンク

統合フロー