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 that contains information about these IAP items. Use this JSON file to test your app with the Amazon App Tester. See IAP Testing Overview.
Submit your in-app items before you start Live App Testing.
- Create New In-App Items
- Add Description and Images
- Add Subscription Terms
- Add Pricing (For Consumables and Entitlements)
- Download IAP data for testing
- IAP Price Ranges for All Currencies
- Update a Live In-App Item
- Submit a new or updated In-App Item
- Update Subscription Price
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 item:
Navigate to your in-progress app on the Developer Portal:
- Log in to your developer account on the Developer Portal.
- Navigate to the Apps & Services tab to see your apps.
- Click the link to your app to view the app detail page.
- Click the In-App Items tab to view, add, or edit In-App items for the app.
- Use the Add Single IAP selector to choose the type of In-App Item that you want to create:
A New Consumable/Entitlement/Subscription dialog opens. For example, here is how the CREATE NEW SUBSCRIPTION dialog looks like:
- 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.
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.
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.
- 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.
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-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.
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. 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.
The Appstore does not display IAP information fields such as title or description. You will use the IAP API in your app to retrieve the information fields for each IAP, so that your app can display this information (such as title, description, price, and icon) to the user.
For additional details, see step 5 of Integrate the IAP API.
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. See Testing In-App Purchasing.
To create the JSON file:
- Navigate to the In-App Items tab of your app.
- Click the Export Multiple IAPs button, and select JSON as the format.
IAP Price Ranges for All Currencies
(all IAP types)
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 take effect only after you submit this version of the in-app item.
Updates to Consumables and Entitlements take effect for all users when the in-app item goes live. For a subscription in-app item, updates to the general information or the description fields take effect for all users when the updated subscription goes live.
Warning: If you change a subscription price field, the system may not apply that change to existing subscribers, as described in Update Subscription Prices
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.
Update Subscription Price
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.
The overall intent of this approach is that existing subscribers will never experience a price increase on an active subscription, but they will get the benefit of a price decrease. An existing subscriber pays the new price starting at the next renewal period of the subscription.
Subscription IAPs support one or more subscription terms (such as weekly or monthly). You configure a SKU and a price for each subscription term that you offer.
If you change the subscription price for a subscription term, any new subscribers to this subscription term will pay the new price.
If you raise the subscription price for a subscription term, existing subscribers (including customers currently in the free-trial period) continue to pay their original price.
If you lower the subscription price for a subscription term, existing subscribers who are currently paying a higher price (including customers currently in the free-trial period) will now start to pay the lower price.
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.
You lower the price of an existing monthly subscription
An existing subscriber has a monthly subscription with auto-renewal. The current subscription price is $12.99.
During the month, you lower the price to $10.99
At the next renewal period (and beyond), the existing subscriber pays $10.99.
Note: This action does not affect any subscribers currently paying less than $10.99 per month.
You raise the price of an existing monthly subscription
An existing subscriber has a monthly subscription with auto-renewal. The current subscription price: $12.99
During the month, you raise the price to $14.99
At the next renewal period (and beyond), the existing subscriber continues to pay $12.99.
Any new user signing up for this subscription will pay $14.99 a month.
You offer a special introductory price for a new subscription
You create a new monthly subscription. Your intent is to offer a six-month introductory period at $9.99 per month, and then start charging the full price of $12.99 per month.
You create the subscription with a price of $9.99 per month. After six months, you raise the price to $12.99 per month.
Any subscriber that signed up during the introductory period will continue to pay $9.99 per month.