---
title: App Store Server Notifications
framework: App Store Server Notifications
role: collection
role_heading: Web Service
platforms: [app store server notifications 1.0+]
path: appstoreservernotifications
---

# App Store Server Notifications

Monitor In-App Purchase events in real time and learn of unreported external purchase tokens, with server notifications from the App Store.

## Mentioned in

Enabling App Store Server Notifications

## Overview

Overview App Store Server Notifications is a server-to-server service that sends real-time notifications for In-App Purchase events, and notifications for unreported external purchase tokens. Use the data in the notifications to update your user-account database, and to monitor and respond to in-app purchase refunds. For notifications related to the External Purchase API, see externalPurchaseToken. important: The App Store Server Notifications V1 endpoint and version 1 notifications, notification_type, are deprecated. Implement the App Store Server Notifications V2 endpoint on your server to receive version 2 notifications instead. To receive server notifications from the App Store, provide your server’s HTTPS URL in App Store Connect. Opt in to receive notifications for the production environment and the sandbox environment. For more information, see Enabling App Store Server Notifications. Your server is responsible for parsing, interpreting, and responding to all server-to-server notification posts. For more information, see Receiving App Store Server Notifications and Responding to App Store Server Notifications. Process in-app purchase notifications Notifications cover events in the in-app purchase life cycle, including purchases, subscription renewals, offer redemptions, refunds, and more. For a complete list of notification types, see notificationType for App Store Server Notifications V2. Use the notification type, along with the transaction and subscription renewal information, to update a customer’s service or to present promotional offers according to your business logic. Process external purchase token notifications A notificationType of EXTERNAL_PURCHASE_TOKEN with an UNREPORTED subtype indicates that Apple generated an external purchase token for your app but hasn’t received a report for the token. The notification includes the token in the externalPurchaseToken field of the responseBodyV2DecodedPayload. Use the token information to report it to Apple, including if you don’t recognize the token in your system. To report tokens, with or without associated transactions, call the External Purchase Server API’s Send External Purchase Report endpoint. For more information about token reporting requirements in the EU, Brazil, and Japan, see Using alternative payment options on the App Store in the European Union, Using alternative payment options on the App Store in Brazil, and Using alternative payment options on the App Store in Japan. Test your server setup To determine whether your server is receiving notifications, call the Request a Test Notification endpoint in the App Store Server API to ask the App Store server to send a notification with the notificationType TEST. Use the testNotificationToken you receive to call the Get Test Notification Status endpoint to learn how your server responds to the test notification. The App Store server sends the TEST notification in the version 2 notification format, however, it sends it to your server regardless of whether you configure a version 1 or version 2 notification URL in App Store Connect. For more information about configuring your URL in App Store Connect, see Enter a URL for App Store server notifications.

## Topics

### Essentials

- [Enabling App Store Server Notifications](appstoreservernotifications/enabling-app-store-server-notifications.md)
- [Receiving App Store Server Notifications](appstoreservernotifications/receiving-app-store-server-notifications.md)
- [Responding to App Store Server Notifications](appstoreservernotifications/responding-to-app-store-server-notifications.md)
- [App Store Server Notifications changelog](appstoreservernotifications/app-store-server-notifications-changelog.md)

### Server notifications version 2

- [App Store Server Notifications V2](appstoreservernotifications/app-store-server-notifications-v2.md)
- [responseBodyV2](appstoreservernotifications/responsebodyv2.md)
- [responseBodyV2DecodedPayload](appstoreservernotifications/responsebodyv2decodedpayload.md)
- [notificationType](appstoreservernotifications/notificationtype.md)
- [subtype](appstoreservernotifications/subtype.md)

### Deprecated

- [App Store Server Notifications Version 1](appstoreservernotifications/app-store-server-notifications-version-1.md)

## See Also

### Related Documentation

- [Apple In-App Purchase](storekit/in-app-purchase.md)
- [App Store Server API](appstoreserverapi.md)
- [App Store Receipts](appstorereceipts.md)