Tiered Subscriptions Overview
With the Appstore SDK, you can add tiered subscription functionality to your apps. To set up tiered subscriptions, your HAQM representative must enable the feature for you in the Developer Console.
Introduction
The following is an example of a typical tiered subscription structure.
A subscription is an In-App Purchasing (IAP) item that lasts for a predefined period, auto-renews at the end of this period, and is available across different devices registered to the customer's account. You must use the Developer Console to specify the period duration and pricing options that you want to offer to your customers.
Every subscription contains at least one tier. Tiers might refer to different sets of features, levels of access to a service, ongoing access to an app, regular updates to content, and so on. You can create up to five tiers under a subscription.
Terms refer to duration and pricing. Every tier must have at least one term, and every term belongs to a single tier. Even if two terms have the same duration, such as Gold Monthly and Silver Monthly, or price (for example, Gold Weekly and Bronze Monthly might have the same price), these terms are different because they belong to different tiers.
There is no nested tier structure or hierarchy boundaries to the system. You are free to provide your customers with any path, and move them from any plan to another one.
Customers can't have simultaneous access to more than one tier or term.
When setting up subscriptions, tiers, and terms in the Developer Console, you can include translations of the titles and descriptions of these in-app items in all the languages you localize your app into (as you would do with any other in-app item).
Key features
The following table summarizes all the supported features.
| Feature | Definition |
|---|---|
| Tier | A group of plans offering specific pricing and duration options |
| Term | Duration and pricing plans belonging to a single tier |
| Pricing Options | Customer plans (which can be different across countries) |
| Term switch | Customers moving to a different plan within the same tier |
| Tier switch | Customers moving to a different plan across tiers |
| Auto-renewal | At the time of renewal, customers retain access to the same plan if they have set auto-renewal to on, and discontinue access if it's off |
| Immediate modified subscription | Customers moving from one term to another effective immediately |
| Deferred modified subscription | Customers moving from one term to another effective at the time of renewal |
Use cases
You might choose to use tiered subscriptions in the following scenarios:
- A customer moves from Silver Monthly to Gold Annually, or the other way around.
- A customer moves from Gold Monthly to Silver Monthly, or the other way around.
- A customer moves from Bronze Monthly to Bronze Annually, or the other way around.
- A customer gets a Bronze free trial for a month and starts using a paid Bronze Monthly plan after the trial period ends.
If customers turn off auto-renew, their subscription will end at the time of renewal.
Appstore SDK versions
The tiered subscription feature is available to only select partners and must be enabled by an HAQM representative. Prior to release of Appstore SDK 3.0.7, you needed to obtain a custom Appstore SDK from your HAQM representative to implement tiered subscriptions.
The following table lists the equivalent versions of the Appstore SDK that support tiered subscriptions. For older releases, contact your HAQM representative to obtain the correct version of the Appstore SDK.
| Generally available Appstore SDK version | Equivalent custom Appstore SDK version |
|---|---|
| Appstore SDK 3.0.7 | No custom SDK required |
| Appstore SDK 3.0.6 | Appstore SDK 3.0.6.1 |
| Appstore SDK 3.0.5 | Appstore SDK 3.0.5.1 |
| Appstore SDK 3.0.4 | Appstore SDK 3.0.4.1 |
| Appstore SDK 3.0.3 | Appstore SDK 3.0.3.1 |
Related topics
Last updated: Apr 07, 2025