Developer Console

Live App Testing for IAP

If you are using Live App Testing (LAT) and have Amazon In-App Purchasing (IAP) in your app, you can submit in-app items so they are available only for testing in your LAT app. These in-app items won't be available in the live version of your app. When you are ready, you can promote a LAT in-app item to your live app. With LAT, you select the testers, and can test your app with production Amazon services. For more details on LAT, see Understanding Live App Testing.

Submit in-app item to LAT

To test in-app purchases (IAPs) in LAT, you first must create an in-app item. Create an IAP in the Developer Console with the steps in Create new in-app items. When creating an in-app item, you can choose to submit the item to either LAT only or for both LAT and live, as shown in the following image.

The Submit IAP button opens a menu with two options: Submit to Test and Submit to Test and Live.

If you submit the IAP item to only LAT, a TEST label appears to indicate that this submission is only for LAT. If the item had any previous submissions for a live app, the TEST label won't appear.

Test label appears next to the name of the in-app item on the details screen.
TEST label on the item detail screen
Test labels appear next to the name of the in-app item on the dashboard list.
TEST labels on the dashboard

You can also import multiple IAPs at the same time by uploading a CSV file. For details, see Import and export multiple in-app items.

Promote in-app item to live app

In LAT, in-app purchases are free and you can test without being charged. When you've completed testing with a LAT in-app item, you can promote the item to your live app. Only test in-app items that have a status of Live can be promoted to the live app. Promote a test item by clicking Promote Test IAP on the item detail screen, as shown in the following image.

The Promote Test IAP button appears on the detail screen for a live test in-app item.

You can also select multiple test in-app items and promote them all at the same time. To do this, go to the dashboard and select Promote Test IAPs. Test in-app items that can be promoted (have a status of Live) appear in the check list. Use the checkboxes next to the items you want to promote and click Promote selected IAPs as shown here.

The dashboard shows two items. Both have their checkboxes selected. The options Cancel and Promote selected IAPs appear.

Import and export multiple in-app items

You can submit multiple test in-app items by uploading a CSV file to the console. You can also export items from the console as a CSV file.

Import test in-app items

To add multiple in-app items for LAT at the same time, you can upload a CSV file. On the In-App Items dashboard, click Import Multiple IAPs using CSV, then choose whether you want to submit the IAPs to LAT only or to LAT and live. To submit the item only for LAT, select TEST. To submit the item for both LAT and live, select TEST and LIVE. The following image shows the import menu options.

The 'Import Multiple IAPs using CSV menu' is open with options 'TEST', and 'TEST and LIVE'.

If you select TEST, the import dialog displays a TEST label as shown in the following image.

The 'Upload a CSV to import IAPs' dialog displays a 'TEST' label.

For more details on importing a CSV file for IAPs, see Create and Submit a Batch of IAPs.

Export test in-app items

You can export multiple IAPs to a CSV file by selecting Export Multiple IAPs > CSV. You can see which IAPs were submitted for LAT by viewing the TEST IAP field on the CSV file. The following table provides details about the field.

Field Type Description
TEST IAP TRUE or FALSE For IAPs submitted or published to only LAT (IAPs with a TEST label), the value of this field is TRUE.

For IAPs created or submitted to both TEST and LIVE, the value of this field is FALSE.

To see a description for all fields, see CSV file format.


Last updated: Oct 23, 2024