Switching App Store Server Notifications from V1 → V2 — what happens to existing subscriptions?

Question

Created 9h

Replies 1

Boosts 0

Participants 2

Hello — quick question about App Store Server Notifications migration. We have a live app using Production V1 notifications for recurring in-app subscriptions. We plan to switch the Production webhook to V2. After the switch: Will notifications for existing subscriptions be delivered in V1 format, V2 format, or will it depend (e.g., queued V1 retries vs new V2 deliveries)? If V1 retries are queued, how long should we expect overlap/retries to continue? Any recommended cutover best practices (support both formats, revert process, etc.)?

Happy to share additional details. Thanks.

Boost

Answer 1

App Store Commerce Engineer OP

Apple

2h

Shortly after you switch to V2 in App Store Connect, all new notifications generated for your app will be in V2 format, regardless of what subscription they may apply to. If any V1 notifications are in the retry process, you will continue to receive these in V1 format until they are successfully received or they complete the final retry. The final possible retry of a V1 notification would be ~78h (6+24+48) after the switch to V2. For more information on retry timing, see here: https://developer.apple.com/documentation/appstoreservernotifications/responding-to-app-store-server-notifications

In this transition period, I recommend having your server handle both V1 and V2 notifications gracefully; the formats are quite different so it should be easy to quickly check the format of each notification when you receive it. To help with the transition, you can start by switching only sandbox notifications to V2 in App Store Connect.

0