Lumina Digitale / Mobile Apps

iOS Subscriptions Step by Step: App Store Connect, StoreKit and Review

Auto-renewable subscriptions are among the most frequently rejected purchase types on the App Store. This guide follows the order we used to set up CarQR's iOS subscriptions and the subscription rules in Apple's guidelines that matter most.

Quick Answer

First complete the Paid Apps agreement, banking and tax in App Store Connect. Then create a subscription group with subscriptions of different durations, and enter a price, description, review screenshot and note for each. Test purchase, renewal and restore with StoreKit locally and in the sandbox. Make the price, period and what the user gets clear on the purchase screen, and submit the first subscriptions together with a new app version.

1) Agreements, banking and tax

In App Store Connect's Business section (formerly Agreements, Tax, and Banking), accept the Paid Apps agreement and complete your bank account and tax forms. Without it, in-app purchases do not work outside the sandbox.

2) Subscription group and products

Create subscriptions inside a subscription group. A user holds one subscription per group at a time, and upgrades and downgrades happen within the group. Apple states that users should not be able to inadvertently subscribe to multiple variations of the same thing (3.1.2(b)).

Give each subscription a permanent product ID (e.g. com.app.premium.monthly), a duration and a price. The period must be at least seven days (3.1.2(a)). In CarQR we keep monthly, 6-month and yearly options in the same group.

Write a display name and description for each product, and add a screenshot and a short note for App Review.

3) Price against the store's price points

Apple has you pick prices from fixed per-country price points. If the prices you show in the app or on your website do not match those points, users meet a different amount at checkout. We aligned CarQR's Turkish prices with App Store Turkey price points (amounts ending in ,99).

Rather than hard-coding prices, show the localized price StoreKit returns.

4) Test with StoreKit locally and in the sandbox

An Xcode StoreKit Configuration file lets you test products locally without App Store Connect, including accelerated renewals and cancellations.

Then create sandbox testers in App Store Connect and try purchase, renewal, cancellation and restore on a real device.

5) Purchase screen and restore

Apple asks that, before subscribing, users clearly see what they get for the price (3.1.2(c)). Price, period, auto-renewal and what is included should be clear on the same screen, with Terms of Use and Privacy Policy links in the app and in the store metadata.

Add a "Restore Purchases" button. Apple expects a restore mechanism for restorable purchases (3.1.1).

If the same subscription is sold on Android or the web, manage entitlements on your server; App Store Server Notifications and the App Store Server API let you track renewals and refunds.

6) Submitting for review

Submit your first subscription products together with a new app version, selecting them on the version page. In the review notes, say how to reach the subscription screen and include a test account if one is needed.

Source: App Review Guidelines 3.1.2 Subscriptions.

Frequently Asked Questions

What is the shortest allowed subscription period?

Apple's guidelines require auto-renewable subscriptions to last at least seven days.

Can I hard-code the price in the app?

Not recommended; it varies by country. Show the localized price StoreKit returns.

Is a restore button required?

Apple expects a restore mechanism for restorable purchases; a visible button makes review smoother.

Does an Android subscription carry over to iOS?

Not by itself; you need to verify purchases from both stores on your own server and attach them to the same account.

Next step

If you are stuck at one of these steps while shipping to the App Store or Google Play, we can run the store release with you. Apps we have published.

Request a Quote Mobile App Service