App Store Server Notifications changelog
Learn about changes to the App Store Server Notifications service.
Overview
App Store Server Notifications has two versions of notifications. Version 1 notifications and the App Store Server Notifications V1 endpoint are deprecated. Instead, implement the App Store Server Notifications V2 endpoint on your server to receive version 2 notifications.
To set up your server to receive notifications, see Enabling App Store Server Notifications. Use this changelog to learn about feature updates, version information, deprecations, and removals for App Store Server Notifications.
November 4, 2026
New features
Added the value
5to offerType to indicate a retention offer.
November 3, 2026
New features
Added the
UNCLAIM_SEATSvalue to notificationType, and the unclaimInfo field to responseBodyV2DecodedPayload, with the unclaimSeatIds field, to support Group Purchases subscriptions with developer-hosted invitations.Added the
INCREASE_QUANTITYandDECREASE_QUANTITYvalues to subtype for theDID_CHANGE_RENEWAL_PREFnotification type, and theSEATSvalue for theREFUNDnotification type, to report changes to the number of seats in a multiseat purchase.Added the
multiSeatInfoand additionalTransactionReason fields to the JWSTransactionDecodedPayload, and themultiSeatInfoand renewalQuantity fields to the JWSRenewalInfoDecodedPayload, to describe the seats in a multiseat purchase.Added the TransactionMultiSeatInfo, RenewalMultiSeatInfo, and MultiSeatPriceTier data types, and the invitationManagement, tierPrice, tierQuantity, and revokedSeatQuantity fields.
The App Store also sends a
REVOKEnotification when a customer loses access to a subscription that they have through a group.
October 23, 2026
New features
The
ASSIGNEDvalue of inAppOwnershipType and theASSIGNMENT_REVOKEvalue of revocationType are now available in both the sandbox and production environments, for subscriptions that organizations assign to customers.
October 1, 2026
New features
Updated tokenType to include the
CORE_TECHNOLOGYtoken type.
September 28, 2026
New features
Added the
ASSIGNEDvalue to inAppOwnershipType, and theASSIGNMENT_REVOKEvalue to revocationType, to support multiseat purchases, which let organizations and groups buy your subscriptions in bulk. These values are only available in the sandbox environment.The App Store sends a
REVOKEnotification when an organization removes a subscription that it assigned to a customer. In this case, the revocationType in the transaction isASSIGNMENT_REVOKE.The quantity field also reports the number of seats for a subscription that a customer buys as a multiseat purchase.
April 27, 2026
New features
Added the following fields to support monthly subscriptions with a 12-month commitment: TransactionCommitmentInfo and billingPlanType in JWSTransactionDecodedPayload; RenewalCommitmentInfo and renewalBillingPlanType in JWSRenewalInfoDecodedPayload.
December 10, 2025
New features
Added the revocationType and revocationPercentage fields to the JWSTransactionDecodedPayload.
Added the advancedCommercePriceIncreaseInfo object, and advancedCommercePriceIncreaseInfoDependentSKU, advancedCommercePriceIncreaseInfoStatus, advancedCommercePriceIncreaseInfoPrice, fields to the JWSRenewalInfoDecodedPayload.
November 4, 2025
New features
Updated the responseBodyV2DecodedPayload to include the new payload object, appData.
Added the notification type
RESCIND_CONSENTto notificationType.
October 29, 2025
New features
Added the
ONE_TIMEvalue to offerDiscountType to indicate In-App Purchase offer codes.
June 26, 2025
New features
Added the
ACTIVE_TOKEN_REMINDERandCREATEDvalues to subtype, which can appear in notifications with anEXTERNAL_PURCHASE_TOKENnotificationType.Updated externalPurchaseToken to include the new fields tokenType and tokenExpirationDate.
May 27, 2025
New features
The
ONE_TIME_CHARGEnotificationType is now available in the production environment.
March 24, 2025
New features
Added the notification types
METADATA_UPDATEandMIGRATEto notificationType.Added the previousOriginalTransactionId field to the JWSTransactionDecodedPayload.
February 21, 2025
New features
Updated the JWSRenewalInfoDecodedPayload and JWSTransactionDecodedPayload to include the new appTransactionId and offerPeriod fields.
Updated the JWSRenewalInfoDecodedPayload to include the appAccountToken field.
January 17, 2025
New features
Added support for the Advanced Commerce API.
July 8, 2024
New features
Updated the JWSRenewalInfoDecodedPayload to include the new field eligibleWinBackOfferIds.
Added the win-back offer type to offerType.
June 10, 2024
New features
Added the notification type
ONE_TIME_CHARGEto notificationType. This notification type is currently available only in the sandbox environment.Added the fields renewalPrice, currency, and offerDiscountType to the JWSRenewalInfoDecodedPayload.
April 11, 2024
New features
Added the consumptionRequestReason to the data object.
The
CONSUMPTION_REQUESTnotificationType added notifications for refund requests for auto-renewable subscriptions.
March 12, 2024
New features
The type of the price field changed from
int32toint64.
February 29, 2024
New features
Added a new notificationType:
EXTERNAL_PURCHASE_TOKENand a subtype:UNREPORTED.Updated the responseBodyV2DecodedPayload to include the new payload object, externalPurchaseToken.
Added the types externalPurchaseId and tokenCreationDate.
January 23, 2024
New features
Changed the notification type the App Store server sends when a customer redeems a subscription offer for an inactive subscription to the
SUBSCRIBEDnotificationType. The App Store server only sends theOFFER_REDEEMEDnotification type when customers redeem an offer on an active subscription.
October 26, 2023
New features
Added new properties in the JWSTransactionDecodedPayload object: price, currency, and offerDiscountType.
June 5, 2023
New features
Added a new version 2 notificationType,
REFUND_REVERSED.Added the following new fields in the transaction decoded payload, JWSTransactionDecodedPayload: storefront, storefrontId, and transactionReason.
Added the
renewalDatefield in the renewal info decoded payload, JWSRenewalInfoDecodedPayload.Added a subscription status field in the data object of the responseBodyV2DecodedPayload.
The responseBodyV1 now includes a
deprecationfield.
Deprecations
The App Store Server Notifications V1 endpoint and version 1 notifications are deprecated. Implement the App Store Server Notifications V2 endpoint on your server to receive version 2 notifications instead.
January 30, 2023
New features
Added a new notification type for App Store Server Notifications 2 that consists of the notificationType value
RENEWAL_EXTENSIONand subtype values ofSUMMARYandFAILURE. This notification provides information when you extend the subscription renewal date for all active subscribers, based on a product identifier. For more information, see Extend Subscription Renewal Dates for All Active Subscribers in the App Store Server API.Updated the responseBodyV2DecodedPayload to include the new summary object, which appears in the payload for a
RENEWAL_EXTENSIONnotification with aSUMMARYsubtype.
November 7, 2022
New features
Added the
PRODUCT_NOT_FOR_SALEsubtype for theEXPIREDnotificationType.
June 6, 2022
New features
App Store Server Notifications 2 supports sending a
TESTnotification. For more information, see notificationType, and the endpoints Request a Test Notification and Get Test Notification Status in the App Store Server API.
May 12, 2022
New features
In App Store Server Notifications 2, the notification subtype
ACCEPTEDis now sent when the App Store notifies the customer of an auto-renewable subscription price increase that doesn’t require customer consent. This notification subtype is available only in version 2 notifications. For more information, see subtype.
October 21, 2021 - version 2
New features
App Store Server Notifications V2 is available, and version 1 is still supported. For information about the notifications sent in version 2, see notificationType,
substate, and responseBodyV2.For information about the notifications sent in version 1, see notification_type and responseBodyV1 (previously named
responseBody).
March 10, 2021
Deprecations
In App Store Server Notifications Version 1, the following notification type and top-level objects are deprecated and removed:
RENEWAL,latest_receipt,latest_receipt_info,latest_expired_receipt, andlatest_expired_receipt_info. For more information, see responseBodyV1 and notification_type.
November 21, 2019 - version 1
New features
App Store Server Notifications is available.