Set Up Tiered Subscriptions in Developer Console

Important: At this time, tiered subscriptions is available to select partners only.

To use tiered subscriptions in your Android project, you must first manually create subscriptions, tiers, and terms in the Developer Console as IAP items. Enter data about these IAP items one at a time, and submit each subscription. In this way, you will be able to use them in your app. You can update your IAP items at any time.

Add new tiered subscription
Add description and images
Add tiers
Add subscription terms
Next steps

Add new tiered subscription

If you already have a published app and you would like to add tiered subscriptions to it, you must submit a new version of this existing app that integrates the version of the Appstore SDK shared by your Amazon representative. Otherwise, create a new app in the Developer Console.

Follow these steps to create a new tiered subscription in the Developer Console

Log in to your developer account in the Developer Console.
Under Apps & Services, click My Apps.
Click the title of your app.
Below the title in the first row of tabs, click In-App Items.

The In-App Purchasing page opens.
Click Add single IAP, and then Add a Subscription.
Enter a Subscription Title, a Subscription SKU, and click Add Subscription. For example:

Note: Title and SKU are strings that help you identify all the subscriptions offered by your app. Every SKU is a unique product ID within your app, and identifies specific in-app items. For details, see SKUs.

Your Subscription Details are ready now.

Add description and images

The Display Title and Description (for English, US) are mandatory fields. For multilingual support, you might also want to enter translations of the Display Title and the Description.

Note: The Amazon IAP purchase box (facilitated by the Appstore client present on the customers' devices) uses these translations. You need not manage this metadata within your app.

Under Description & Images, add a Display Title and a Description for English (US).
(Optional) Click Update localization.
(Optional) Use the check boxes to select every language your app has been localized into (and for which you submit a localized APK).
(Optional) Click Update localization.

You can now see new tabs for all the chosen languages.
(Optional) Enter a Display Title and a Description for every language.
(Optional) For every language you support, drag your icons and drop them under the Icon section.

Note: These icons will appear on the customer's purchase dialog boxes.

Add tiers

Every subscription forms a group of one or more tiers. For example, you can offer a Gold, a Silver, and a Bronze tier to your customers, as part of a the same subscription.

Note: Tiers help you organize and manage all the groups of terms you provide to your customers.

Initially, there is a No tier added indication under the Description & Images section. To add tiers:

Click Add New Tier.
Enter a Tier Title, a Tier SKU, and click Create tier.

Note: Name your subscription tiers in a Subscription name - Tier name format. For example, MyAppSubs - Bronze.

Your Tier Details should look like this:
(Optional) Under Tier Description & Images, click Add translation, and use the check boxes to select every alternative language supported by your app.
(Optional) Enter Display Title, Description, and upload icons for every language.

Note: These icons will appear on the customer's purchase dialog boxes.
Repeat steps 1-4 to add additional tiers linked to your subscription.

Add subscription terms

You must create new terms for your tiers. Every tier must have at least one term.

For example, under your Gold tier, you can add new WEEKLY and MONTHLY terms. Terms belonging to different tiers need different SKUs, even if these terms have the same duration. For example, Silver Monthly and Gold Monthly term SKUs are not the same.

Select your tier. For example, click Gold.
Under Subscription terms, click Add New Term.
Choose a Term Period, enter a Term SKU, and click Create Term.
Set up pricing for your term. If this is a free trial, just click Yes, and select the duration of the trial.
Repeat steps 1-4 for all terms of every tier you have, such as MONTHLY, ANNUALLY, and so on.

After you set pricing for all the terms, the Submit IAP button at the top of the screen, becomes active.
Click Submit IAP.

Next steps

See Integrate Tiered Subscriptions in Android apps.

Last updated: Dec 03, 2024