Submit IAP Apps

You can create in-app purchasable items for your IAP-integrated apps in the Appstore Developer Console. After you create the in-app items, you can download a JSON file that contains information about these IAP items. Use this JSON file to test your app with the Vega App Tester.

• Create New In-App Items
• Add Description and Images
• Add Subscription Terms
• Add Pricing (For Consumables and Entitlements)
• Download IAP data for testing

Create New In-App Items

To create an in-app item:

1. Navigate to your in-progress app on the Developer Console:

   1. Log in to your developer account on the Developer Console.
   2. Navigate to the Apps & Services tab to see your apps.
   3. Click the link to your app to view the app detail page.
2. Click the In-App Items tab to view, add, or edit In-App items for the app.

   

3. Use the Add Single IAP selector to choose the type of In-App Item that you want to create:
   • Consumable
   • Entitlement
   • Subscription

   A New Consumable/Entitlement/Subscription dialog opens. For example, here is how the CREATE NEW SUBSCRIPTION dialog looks like:

   

4. Enter values for the following fields:
   • Title: String containing the title of your item. (Max length = 128 characters)
   • SKU: A unique string that becomes the ID for the item. For example, the IAP consumable sample app creates an IAP with a SKU value of "com.amazon.example.iap.consumable".
     
     The SKU must be unique across all IAP items in all of your apps.
     
     The SKUs used by your app must match the SKUs that you submit to the Amazon Appstore. SKUs are case-sensitive. The SKU has a max length of 150 characters and can contain the characters a-z, A-Z, 0-9, underscores, periods, and dashes. If you are creating a subscription item, this SKU becomes the parent SKU for the subscription term SKUs that you will create later.

5. Click Add Consumable/Entitlement/Subscription to create the item, and the associated detail sections for the item appear. For example, here is how this looks like for a new subscription:

   

   The item Details page now displays additional sections, where you can configure additional data and information about your in-app items:

   • Description & Images: Enter a display name and description images for the item.
   • Subscription Terms (Subscriptions only): Specify subscription length and free trial information for the item.
   • Pricing (Consumables and Entitlements only): Set the price for the item.

Add Description and Images

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

1. Under Description & Images, add a Display Title and a Description for English (US).

   

2. (Optional) Click Update localization.

3. (Optional) Use the check boxes to select every language your app has been localized into (and for which you submit a localized APK).

   

4. (Optional) Click Update localization.

   You can now see new tabs for all the chosen languages.

5. (Optional) Enter a Display Title and a Description for every language.

   

6. (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.
   • Small icon (114px x 114px): A 32-bit 114x114 pixel icon for this purchasable item with a transparent background. Your app can display this icon to the user. This icon must be the same as the large icon.
   • Large icon (512px x 512px): A 32-bit 512x512 pixel icon for this purchasable item with a transparent background. This icon must be the same as the small icon.

Add Subscription Terms

You must create new terms for your subscriptions. Terms are defined as the subscription periods provided to your customers. Every term has a unique Title and SKU. Here is a summary of what you need to know:

• Subscription Term: Subscription terms start on the date of purchase. Valid values are Weekly, Bi-Weekly (every two weeks), Monthly, Bi-Monthly (every two months), Quarterly, Semi-Annually (every six months), or Annually (every twelve months).
• SKU: Enter an SKU (using the same guidelines as the item SKU) that corresponds to this subscription term. For example, "com.amazon.example.iap.subscription.weekly". This SKU is a child SKU of the SKU that you entered on the item detail page.
• Free Trial: Specify an optional free trial period for the subscription. Valid values are No (no free trial), 7 days, 14 days, 1 month, 2 months, and 3 months.
• Are you charging for this subscription?: Yes, if you are charging for the subscription, No, if you intend the subscription to be free.
• If you specify that Yes, you are charging for the item, a field displays allowing you to set the base price and currency for the item. After you set the base price, you will have the option of either manually setting the price for other currencies, or allowing the Amazon Appstore to set those prices for you, based on conversion rates and taxes. Valid prices (in USD) can either be $0.00 or range from $0.99 to $299.99.

For example, you can add new Weekly and Monthly terms.

1. Under Subscription terms, click Add New Term.

2. Choose a Term Period, enter a Term SKU, and click Create Term.

   

3. Set up pricing for your term. If this is a free trial, just click Yes, and select the duration of the trial.

   

4. Repeat steps 1-3 for all the terms your app provides, such as Monthly, Annually, and so on.

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

5. Click Submit IAP when you are ready.

Add Pricing (For Consumables and Entitlements)

If your item is a consumable or an entitlement, go to the Pricing section to enter a price for your item. For example, if you create a consumable this is how it looks like:

• Are you charging for this consumable/entitlement?: Select Yes if you are charging for the item, or No if you intend the item to be free.
• If you select Yes, the system displays a field to set the base price and currency for the item. After you set the base price, you will have the option of either manually setting the price for other currencies, or allowing the Amazon Appstore to set those prices for you, based on conversion rates from the base price. Valid prices (in USD) can either be $0.00 or range from $0.99 to $400.

Note: the price that you set for each marketplace is your suggested list price, which includes any VAT or similar taxes that apply in that marketplace. The system displays this list price to end users (along with a note that all prices include VAT). Any VAT or similar taxes are deducted from the list price when calculating Royalties.

Download IAP data for testing

When you have entered your in-app items, you can download a JSON-formatted data file containing all of the data for your items. Use this file when you test your app using the Amazon App Tester.

To create the JSON file:

1. Navigate to the In-App Items tab of your app.
2. Click the Export Multiple IAPs button, and select JSON as the format.

---

Last updated: Sep 30, 2025