Vielen Dank für Ihren Besuch. Diese Seite ist momentan nur auf Englisch verfügbar. Wir arbeiten an der deutschen Version. Vielen Dank für Ihr Verständnis.

Create and Submit Single IAP items

Create and submit the in-app purchasable items for your IAP-integrated app before you submit the app to the Appstore. The Amazon Appstore will not test your app until both the app and your in-app items are submitted.

Use the developer console to create in-app items one at a time. If you need to create a number of in-app items, you could use the bulk IAP submission. See Create and Submit a Batch of IAPs.

You can update an existing in-app item in the live state. The new field values will take effect after you submit this version of the in-app item and it transitions to the live state.

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 Items

Note: You need to create an app on the Developer Portal before you can add In-App Purchase items to that app.

To create an in-App Purchase item:

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

    1. Log in to your developer account on the 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 Export Multiple IAPs selector. 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 selector and select JSON to automatically create and download a JSON-formatted data file that is compatible with IAP's testing tools, such as the App Tester.

  3. The Add Single IAP selector lets you select the type of In-App Item that you want to create:
    • Consumable
    • Entitlement
    • 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 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 period SKUs that you will create later.
  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 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 for your item:
      • 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. For the price ranges in other currencies, see IAP Price Ranges for All Currencies.
      • 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.
      • When would you like this item to be available?: The item will become available as soon as it is approved by the Amazon Appstore. IAP submission no longer supports the ability to specify a future date for the item to become available.
    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 $299.99.
      • 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 and then click Edit to upload a small and large icon for your item. The images tab is the same for all three item types, except that the icon files are optional for Consumables and Entitlements, but mandatory for Subscription items.
      • 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.

IAP Price Ranges for All Currencies

Currency
Abbreviation
Currency Min Price
(all IAP types)
Max Price
Consumables &
Entitlements
Max Price
Subscriptions
AUD Australian Dollars 0.99 550.00 299.99
BRL Brazilian Reals 1.99 1500.00 599.99
CAD Canadian Dollars 0.99 500.00 299.99
EUR Euros 0.69 400.00 299.99
GBP Pounds Sterling 0.59 400.00 299.99
INR Indian Rupees 10.12 26,000.00 20,140.00
JPY Japanese Yen 85 48,000 24,000
USD Dollars 0.99 400.00 299.99

Update a Live In-App Item

You can edit the fields of an existing in-app item in the live state. When you update fields and save the in-app item, the system saves the changes as a new version. The new values will only take effect after you submit this version of the in-app item.

Note: you cannot edit an in-app item if it is currently in transition to live state (for example, if the state is Submitted or Approved).

Submit a new or updated In-App Item

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. The in-app item goes through the approval process and then becomes live. You can track the status of the in-app item from the In-App items tab of the app page.

Special Case: Subscription Prices

For a subscription in-app item, updates to the general information or the description fields will apply to all users when the updated in-app item goes live.

If you change a subscription price, all new subscribers are charged the new price. However, existing subscribers keep their current price, unless the new price is lower than their current price.

Details

  1. Subscription IAPs support one or more subscription periods (such as weekly or monthly). You configure a SKU and a price for each subscription period that you offer.

  2. If you change the subscription price for a subscription period, any new subscribers to this subscription period will pay the new price.

  3. If you raise the subscription price for a subscription period, existing customers who have purchased that subscription continue to pay their original price. Even if a customer is currently in the free-trial period, their price does not change.

  4. If you lower the subscription price for a subscription period, existing customers who are currently paying a higher price will now start to pay the lower price.

  5. If a customer cancels and then starts the subscription again, they will pay the current price, which may be different from the price of the subscription that they cancelled.