Amazon Developer

as

Settings
Sign out
Notifications
Alexa
Amazon Appstore
Ring
AWS
Documentation
Support
Contact Us
My Cases
Develop
Test
Publish
Monetize
Engage users
Device specifications
Resources
Skip to main content
A pending purchase can be initiated from the Amazon Kids experience. A child can make a purchase request, which is then reviewed and approved asynchronously by a parent on their own device. For more information about Amazon Kids, see the What is Amazon Kids? help article. To test Pending Purchases, follow the instructions on this page. The Pending Purchase feature is only supported for entitlement and consumable in-app purchases. Pending Purchases is not available for subscriptions. For more information on how to implement other features of Amazon’s In-App Purchasing (IAP) API in your app, see Implement Appstore SDK IAP. For information specific to implementing the Pending Purchase feature, see Implement Pending Purchases.

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.

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.
If you want to exit sandbox mode, use the following command.

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:
  1. Sign in to the Developer Console and from the navigation bar, choose My Apps.
  2. Find your app, expand the row, and then select View to open the app listing.
  3. From the sidebar, select In-App Items.
  4. If you haven’t already done so, add your in-app items.
  5. Select Export Multiple IAPs > JSON.
  6. When the file is generated, a link to download it appears. Download the file.
  7. Name the downloaded file amazon.sdktester.json.
  8. Use the following command to copy the file to the /sdcard/ folder in your device file system.
If done successfully, your IAP items should be listed in App Tester under IAP Items in JSON File tab as shown in the following image.
A section of App Tester titled 'IAP Items in JSON File', which shows two IAP entries.

Imported IAP entries in App Tester

For more help configuring App Tester, see Install and Configure the 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.
An app dialog with text 'Test Paid Consumable. $1.00.' And three buttons: Cancel, Get Item, Request Purchase

Request Purchase button

When you tap Request Purchase, you won’t immediately purchase the item. Instead, the request is forwarded to be approved or declined. In the actual customer experience, this request would be sent to a parent or guardian. For this test, you can manage the request in App Tester.

Manage a purchase request

After a purchase is requested, it can be approved or declined from the Manage Transactions tab in App Tester.
A section of App Tester titled 'Manage Transactions', which shows metadata for a consumable item with status PENDING and two buttons: Approve Request, Decline Request.

PENDING status of an IAP request in App Tester

Open App Tester and select Manage Transactions. The pending transaction will be shown with options to approve or decline the request.If you select Approve Request, the in-app item is purchased. The IAP flow continues like other regularly purchased items, and must be fulfilled.If you select Decline Request, the in-app purchase is canceled.

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.
  1. Create an Amazon Family with parent and child profiles.
  2. Set up a Live App Test with the version of your app that has the Pending Purchase code.
  3. In the Amazon Kids app on your Fire tablet, add your app to the child profile and enable in-app purchasing.
  4. Initiate an IAP from within the child experience to test the Pending Purchase flow.
To see detailed instructions, click the following button.

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.New Customer? Start here

Add a child profile

Child profiles can be added from the Amazon website or on a Fire tablet.
Method 1: Add a child profile from the Amazon website
  1. Sign in, hover over Accounts & Lists and select Account under Your Account.
  2. Select Your Amazon Family.
  3. Select New and then choose Add Child.
After adding a child profile, you will see the newly created profile when you launch the Amazon Kids app on the device.

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.
  1. 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:
    1. From the navigation bar, select My Apps.
    2. Select Add new app.
    3. Complete the New App Submission page, click Save, then go to step 2.
  2. Select Live App Testing under your app’s name.
  3. Select Create a new Live App Test.
  4. 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.
  5. 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:
    1. Go to the Amazon website for your marketplace (such as Amazon.com).
    2. Select the All menu in the top navigation bar.
    3. Under Digital Content & Devices, select Amazon Appstore, then Your Apps and Subscriptions.
    4. Find your test app and select it to open its retail web page.
  6. Your app’s web page will look similar to the following image. Choose to deliver the app to your Fire tablet.
    Retail web page for Kids IAP Test App. A drop-down menu to select a device and Deliver button are shown.

    Live App Test web page

The test app will appear on your Fire tablet in the parent profile.

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.
  1. Open the Amazon Kids app.
  2. 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.
  3. Select Add Content and then Share Content.
  4. Tap Games & Apps, then find and select your app.
  5. 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.
Child profile settings screen. There is a highlight on the Enable In-App Purchasing option

Toggle on Enable In-App Purchasing

If this option is disabled, you see a “feature is blocked” message when trying to purchase entitlements and consumables in the child profile, as shown in the following image.Feature is Blocked. In-App Purchasing is currently blocked. If you would like to enable it, please go to your child's Amazon settings and toggle 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.
Test a pending purchase for an entitlement
  1. Select an entitlement to purchase from your test app. A dialog like the one shown here appears. A dialog with text 'Test Paid Entitlement. $20.00. A request will be sent to your parent.' And two buttons: Request Purchase, Grown ups, purchase on device.
  2. 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.
  3. 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.
  4. Click You have notifications. Amazon Parent Dashboard. A bell icon with the text 'You have notifications' is shown.
  5. 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.
  6. Click Review request to view the details of the request.
  7. On the request detail screen, choose Buy Now to approve the request or Decline to reject it. Amazon Parent Dashboard. Purchase request details screen with text: Kids IAP Test App. Test Paid Entitlement. $20.00. And two buttons: Decline and Buy Now. 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. A push notification with the text 'Your parent approved' 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. A push notification with the text 'Your parent didn't approve' There will be no update to the getPurchaseUpdates() response, and the child can request the entitlement again.
Last modified on February 17, 2026