Prerequisites
For this guide, you need the following:- Fire tablet device
- Android Studio IDE
Download the Appstore SDK
You can download the Appstore SDK on the SDKs and samples page. The download includes the JAR file, API documentation, and examples.Implement Pending Purchases
To implement Pending Purchases in your app, follow the instructions in Implement Pending Purchases. Then, return to this page and continue with the next section.Set up App Tester for Pending Purchases
App Tester is a tool that enables you to test the in-app purchase flow locally before uploading your app to the Appstore or Live App Testing. This section explains how to install App Tester and how to use it to test Pending Purchases. To see detailed instructions, click the following button.Open/Close instructions to set up App Tester
Open/Close instructions to set up App Tester
Install App Tester
App Tester is a free app that runs on Fire devices. Download App Tester from the Amazon Appstore.Configure App Tester
This section explains how to set up App Tester.Sandbox mode
Run the following command to turn on sandbox mode. Sandbox mode routes calls that would usually go to the Appstore client to go to the App Tester client instead.Upload your IAP JSON file
App Tester must have a JSON list of the in-app purchases you want to test. You can automatically create the JSON file through the Developer Console using these steps:- Sign in to the Developer Console and from the navigation bar, choose My Apps.
- Find your app, expand the row, and then select View to open the app listing.
- From the sidebar, select In-App Items.
- If you haven’t already done so, add your in-app items.
- Select Export Multiple IAPs > JSON.
- When the file is generated, a link to download it appears. Download the file.
- Name the downloaded file
amazon.sdktester.json. - Use the following command to copy the file to the
/sdcard/folder in your device file system.

Imported IAP entries in App Tester
Test Pending Purchases in App Tester
This section describes the Pending Purchases flow in App Tester.Request a purchase
Open your app and select an in-app item to initiate a purchase. If Pending Purchases is enabled in your app, the dialog that appears has a Request Purchase button.
Request Purchase button
Manage a purchase request
After a purchase is requested, it can be approved or declined from the Manage Transactions tab in App Tester.
PENDING status of an IAP request in App Tester
Set up a live integration test
After you have implemented Pending Purchases in your app and tested it locally using App Tester, you can start a live integration test. Follow these steps to set up and run your test.- Create an Amazon Family with parent and child profiles.
- Set up a Live App Test with the version of your app that has the Pending Purchase code.
- In the Amazon Kids app on your Fire tablet, add your app to the child profile and enable in-app purchasing.
- Initiate an IAP from within the child experience to test the Pending Purchase flow.
Open/Close instructions to set up live integration test
Open/Close instructions to set up live integration test
Create an Amazon account
If you don’t have an Amazon account, go to the Amazon website for your marketplace, such as Amazon.com and create one. Hover over Account & Lists, and select Start here under the Sign in button.
Add a child profile
Child profiles can be added from the Amazon website or on a Fire tablet.- Amazon website
- Fire tablet
- Sign in, hover over Accounts & Lists and select Account under Your Account.
- Select Your Amazon Family.
- Select New and then choose Add Child.
Create a Live App Test
The Appstore’s Live App Testing (LAT) feature allows you to test your app in Amazon’s production environment. With LAT, you can deliver your app to your Fire tablet and test in-app purchasing. Follow these steps to set up your device.-
Go to the Developer Console Dashboard, sign in to your account and select your app. If you don’t have an app listing for this app yet, follow these steps:
- From the navigation bar, select My Apps.
- Select Add new app.
- Complete the New App Submission page, click Save, then go to step 2.
- Select Live App Testing under your app’s name.
- Select Create a new Live App Test.
- Upload your binary file with the Pending Purchase code changes and complete the form. For more details on using LAT, see Get Started with Live App Testing. After you have completed all the required fields, click Submit.
-
You will receive an email indicating you’ve been invited to a Live App Test. Click the link for the Amazon website to be taken to your app’s retail web page. Alternatively, you can get to your app’s web page with these steps:
- Go to the Amazon website for your marketplace (such as Amazon.com).
- Select the All menu in the top navigation bar.
- Under Digital Content & Devices, select Amazon Appstore, then Your Apps and Subscriptions.
- Find your test app and select it to open its retail web page.
-
Your app’s web page will look similar to the following image. Choose to deliver the app to your Fire tablet.

Live App Test web page
Add your app to the child profile
After your app is available in the parent profile account, you need to add it to the child account. Follow these steps.- Open the Amazon Kids app.
- You will see a list of the child profiles in your Amazon Family. Tap on the gear icon next to a child profile to go to the settings screen.
- Select Add Content and then Share Content.
- Tap Games & Apps, then find and select your app.
- Tap Done.
Enable in-app purchasing
Now you need to enable in-app purchasing for the child account. While on the child settings screen, toggle on the Enable In-App Purchasing option.
Toggle on Enable In-App Purchasing
Press the back arrow to return to the child profile list. Launch the child experience by tapping on the child profile.Initiate a purchase from the child profile
After launching the child experience, find your test app and tap the icon to download it. After you download and open your app, you can test both entitlement and consumable purchases.To test Pending Purchases for an entitlement or consumable, follow these steps.- Entitlement
- Consumable
-
Select an entitlement to purchase from your test app. A dialog like the one shown here appears.
- To initiate the Pending Purchase flow, click Request Purchase. This causes the pending status to be sent to your app. You don’t need to implement state management in your app or be concerned with handling duplicate requests as Amazon’s IAP API handles this. On this dialog, you can also initiate the regular in-app purchase flow by clicking Grown ups, purchase on device. In this flow, a parent enters their password on the device and the purchase is completed immediately.
- After the request is created, go to the Parent Dashboard at parents.amazon.com to review the request. Make sure to sign in with the parent account for the Amazon Family. You will also receive an email for the request.
-
Click You have notifications.
- Click Store under the child profile to open the store requests page and review the request. You can review all the consumable and entitlement requests on this page.
- Click Review request to view the details of the request.
-
On the request detail screen, choose Buy Now to approve the request or Decline to reject it.
If you choose Buy Now, the entitlement is added to the child profile. A push notification with a message of the parent’s approval is sent to Fire tablet with the child profile, as shown here.
Tap the notification to launch the app and initiate the getPurchaseUpdates()flow. The new entitlement appears in the app. If you choose Decline, the entitlement is not added to the child profile. The child receives a push notification with a message that says the in-app purchase is not approved, as shown here.
There will be no update to the getPurchaseUpdates()response, and the child can request the entitlement again.


