Web サービス

App Store サーバー通知

App Store からのサーバー通知を使用して、アプリ内購入イベントをリアルタイムで監視し、報告されていない外部購入トークンを把握します。

App Store Server Notifications 1.0+

概観

App Store サーバー通知は、アプリ内購入イベントに関するリアルタイム通知と、報告されていない外部購入トークンに関する通知を送信するサーバー間サービスです。通知内のデータを使用して、ユーザーアカウントデータベースを更新し、アプリ内購入の払い戻しを監視して対応することができます。外部購入 (External Purchase) API に関連する通知については、externalPurchaseToken をご覧ください。

重要

App Store Server Notifications V1 廃止エンドポイントとバージョン 1 通知 notification_type 廃止は廃止となりました。代わりにバージョン 2 通知を受信するには、あなたのサーバーに App Store Server Notifications V2 エンドポイントを実装してください。

App Store からのサーバー通知を受け取るには、App Store Connect であなたのサーバーの HTTPS URL を提供してください。製品環境とサンドボックス環境で通知を受け取るように設定してください。詳しくは、App Store サーバー通知の有効化をご覧ください。

あなたのサーバーは、サーバー間のすべての通知投稿を解析、解釈し、応答する役割を担っています。詳しくは、App Store サーバー通知の受信および App Store サーバー通知への応答をご覧ください。

アプリ内購入通知を処理

通知は、購入、サブスクリプションの更新、オファーの利用、払い戻しなど、アプリ内購入ライフサイクルにおけるイベントをカバーします。通知の型の完全なリストについては、App Store Server Notifications V2 の notificationType をご覧ください。

通知の型を取引およびサブスクリプション更新情報とともに使用して、顧客のサービスを更新したり、ビジネスロジックに従って販売促進オファーを提示したりします。

外部購入トークン通知を処理

notificationType が EXTERNAL_PURCHASE_TOKEN で subtype が UNREPORTED の場合、Apple があなたのアプリ用に外部購入トークンを生成したものの、そのトークンの報告を受け取っていないことを示します。通知には、responseBodyV2DecodedPayload の externalPurchaseToken フィールドにトークンが含まれます。トークン情報を使用して、あなたのシステムでトークンを認識していない場合も含め、Apple に報告してください。トークンを報告するには、関連する取引の有無にかかわらず、外部購入サーバー API (External Purchase Server API) の 外部購入報告の送信 (Send External Purchase Report エンドポイントを呼び出します。

トークン報告の要件の詳細については、欧州連合の App Store で代替支払いオプションを使用するを参照してください。

あなたのサーバーの設定をテストする

あなたのサーバーが通知を受信しているかどうかを確認するには、App Store Server API のテスト通知の要求エンドポイントを呼び出して、App Store サーバーに notificationType が TEST の通知を送信するよう要求します。受信した testNotificationToken を使用してテスト通知状況の取得エンドポイントを呼び出し、あなたのサーバーがテスト通知にどのように応答するかを確認します。

App Store サーバーは TEST 通知をバージョン 2 の通知形式で送信しますが、App Store Connect でバージョン 1 またはバージョン 2 の通知 URL を構成したかどうかに関係なく、あなたのサーバーに送信されます。App Store Connect での URL の構成方法について詳しくは、App Storeサーバー通知の URL を入力するをご覧ください。