Create and Submit In-App Items

Create and submit the in-app items for your IAP-integrated app before you submit the app to the Appstore. Use the developer console to create in-app items one at a time.

After you create the in-app items, you can download a JSON file which contains information about these IAP items. Use this JSON file to test your app with the Amazon App Tester (see Testing In-App Purchasing).

Submit your in-app items before you start Live App Testing.

Create New In-App Purchasable Items

Before you submit your app to the Amazon Appstore, submit the in-app items that will be available for purchase in your app. The Amazon Appstore will not test your app until both the app and your in-app items have been submitted.

Note: You will need to have created an app on the Amazon Apps & Games Developer Portal before you can add In-App Purchase items to that app.

To create your purchasable items for IAP:

  1. Navigate to your in-progress app on the Amazon Apps & Games Developer Portal:

    1. Log in to your developer account on the Amazon Apps & Games Developer Portal.
    2. Scroll down to the Dashboard view 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.

    Note the JSON Data File download button. Once you have entered all of your in-app items (or at least all of the in-app items that you plan to use for testing), you can click this button to automatically create and download a JSON-formatted data file that is compatible with IAP’s testing tools, such as the App Tester.

  3. At the bottom of the list of existing In-App Items (if any), click the button corresponding to the type of In-App Item that you want to create:
    • Add a Consumable
    • Add an Entitlement
    • Add a Subscription

      A New Consumable/Entitlement/Subscription page opens:

  4. On the New Item page, enter values for the following fields:
    • Title: String containing the title of your item. (Max length = 128 characters)
    • SKU: A unique-to-your-app string that becomes the ID for the item, for example, “com.amazon.example.iap.consumable” is the consumable SKU used by the IAP consumable sample app. 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 period SKUs that you will create later.
    • Content delivery: Choose No additional file required if the content to be delivered is included as part of the app. Choose I’ll deliver the required assets if, as a developer, you will be fulfilling the purchased content yourself.
  5. Click Save to create the item and the associated detail tabs for the item:

    The item detail page now displays three additional tabs, where you can configure additional details about your in-app items: * Availability & Pricing (Consumables and Entitlements only) : Set the price and availability date for the item. * Subscription Periods (Subscriptions only): Specify subscription length and free trial information for the item. * Description: Assign a display name and description to the item. * Images: Add images for the item.

    The tabs shown depend on the type of item that you are creating.  
    
    **Note**: You must save the information that you have entered on one tab before moving onto the next tab. If you move from one tab to another without saving, the information that you have already entered will not be persisted when you return to that tab or submit your item.
    
  6. Enter the appropriate additional details for your item, depending on the item type:

    1. If your item is a consumable or entitlement, click the Availability & Pricing to enter a price and availability date for your item:
      • Are you charging for this consumable/entitlement?: Yes, if you are charging for the item, No, if you intend the item 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 $200.00.
      • When would you like this item to be available?: Specify a date (IAP uses the PST time zone) for the item to become available in your app. If you leave this field blank, the item will become available as soon as it is approved by the Amazon Appstore.
    2. If your item is a subscription, enter the click the Subscription Period to add at least one subscription period for your item. Note that you can definite multiple subscription periods for an item:
      • Subscription Period: Select a Subscription Period. Subscription periods 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 a SKU (using the same guidelines as the item SKU) that corresponds to this subscription period. 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 $99.00.
      • Click either of the Save and Add a Subscription Period buttons to save the subscription period. If you want multiple subscription period options to be available for this item, you can define each of them the same way that you did for the subscription period that you just added.
      • If you ever need to remove a subscription period, select the period and click the Remove Subscription Period button.
    3. Click the Description tab to enter description and language information for your item. This tab is the same for all three item types.
      • Display Title: Name of the item as it will be displayed in your app.
      • Description: Description of the item. (Max length = 1200 characters.)
      • Keywords: Comma or white-space-delineated keywords, used to improve the discoverability of your app.
      • To save this set of information and add a set translated into another language, click either Save and Add a Translation button.
      • To save the description information and move on, click Save.
    4. Click the Images tab to upload a small and large icon for your item. This tab is the same for all three item types.
      • Small icon (114px x 114px): A 32-bit 114x114 pixel icon for this purchasable item with a transparent background. 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.
      • To save this set of information and add a set of localized icons, click either Save and Add Localized Media button.
      • To save the description information and move on, click Save.
  7. Click Save to save your item.
  8. Repeat this process for each of your in-app items.

When you have entered all of your in-app items, you can click the JSON Data File download button on your app’s detail page to download a JSON-formatted data file containing all of the real data for your items. Use this file when you test your app using Amazon’s App Tester and other testing tools. See Testing In-App Purchasing.

Submit In-App Purchasable Items

The Submit in-App Item button remains greyed-out until you provide all of the required information for the In-app item.

When it becomes available, click the Submit In-App Item button to submit the In-app item.