• << Fire OS Developer Docs
• Get Started
  • IAP Overview
  • Types of Purchases
  • UX Design Guidelines for IAP
  • IAP FAQ
  • Release Notes
• Manage IAP In-App Items
  • CSV File for IAP Import
  • IAP Batch Submission
  • FAQs for IAP Batch Submission
  • Submit Single IAP items
  • Submit IAP Applications
  • Set Up Promotional Pricing
• Appstore SDK In-App Purchasing
  • Get Started with Appstore SDK Sample Apps
  • Implement Appstore SDK IAP
  • Implement Pending Purchases
  • Obfuscate the App Code
  • Migrate from Google Play Billing to Appstore SDK
  • Transitioning from IAP v2.0
• Appstore SDK API Reference
• Add-On Subscriptions
  • Add-On Subscriptions Overview
  • Set Up Add-On Subscriptions
  • Add-On Subscriptions FAQ
• Quick Subscribe
  • Quick Subscribe Overview
  • Set Up Quick Subscribe
  • One-Click Account Information Sharing
  • Quick Subscribe Test Cases
  • Quick Subscribe FAQ
• Tiered Subscriptions
  • Tiered Subscriptions Overview
  • Set Up Tiered Subscriptions in Developer Console
  • Integrate Tiered Subscriptions in Android Apps
  • Receipt Verification for Tiered Subscriptions
• Receipt Verification Service
  • RVS Overview
  • RVS for Appstore SDK IAP
  • Use RVS Cloud Sandbox
  • RVS Production Setup for Appstore SDK IAP
  • RVS Examples for Appstore SDK IAP
• Real-Time Notifications for IAP Apps
  • Understanding Real-Time Notifications
  • Use Real-Time Notifications
  • Real-Time Notifications Examples
• Test IAP Apps
  • IAP Testing Overview
  • Configure the App Tester
  • App Tester User Guide
  • Test Cases for IAP
  • LAT for IAP
  • Test Pending Purchases
• IAP Best Practices
  • IAP Best Practice - Improve App Startup Time
  • IAP Best Practice - Track Customer Purchase Trends
• Legacy Reference
  • IAP 2.0 API Reference
  • IAP API for Web Apps
  • Web App IAP API Methods
  • Web App IAP API Reference
  • Example IAP Web App
• Digital Rights Management (DRM) for Android
  • DRM Overview
  • DRM for Android
  • DRM Sample App

Get Started with Appstore SDK Sample Apps

Use the following procedure to get started with In-App Purchasing (IAP) using the sample apps included in the Appstore SDK. For detailed instructions on how to implement the IAP API, see Implement Appstore SDK IAP.

• 1. Download the sample apps
• 2. Set up sample apps in Android Studio
• 3. Set up App Tester
• 4. Submit your app and in-app items

1. Download the sample apps

The sample apps are included in the Appstore SDK, which you can download here.

This download includes the IAP JAR file, API documentation, and Java sample apps.

When you are ready to integrate the Appstore SDK into your own app, use Maven Central to add the Appstore SDK to your project. This is the preferred option to get started with In-App Purchasing (IAP) since you can update the Appstore SDK directly within Android Studio and the Gradle build automation system. Maven Central sends you automatic notifications when there are SDK updates. You can follow the instructions in Integrate the Appstore SDK.

2. Set up sample apps in Android Studio

If you are using Android Studio as your IDE, you can import the sample projects, export them as APKs and run them on a Fire device.

To use a Kotlin sample app, clone or download the IAP Kotlin sample app from GitHub here:

For Java sample apps, follow these steps:

1. Extract the contents of the Appstore_SDK_<version>.zip file somewhere to your local machine.
2. Start Android Studio and import the IAP sample apps to your workspace:
   1. On the Welcome to Android Studio screen, from the More Actions menu (the three stacked dots in the upper right) select Import Project (Eclipse ADT, Gradle, etc.) to open a project import window.
      Or from within Android Studio, select File > New > Import Project.
   2. Navigate to the location where you extracted the contents of the SDK zip file, and expand the /Appstore_SDK_<version>/examples directory.
   3. Select the folder for one of the IAP sample projects, and click OK.
   4. Repeat these steps for each sample app.
3. Generate the APK for one of the sample apps:
   1. Enable developer options and USB debugging on your device, and connect the device to your development computer. For help with connecting your device, see Connect to Fire Tablet through ADB.
   2. In Android Studio, select Run > Run 'app' to install the app to that device.

You should now be able to run this sample app on your Fire device.

When submitting your actual app to the Amazon Appstore, an Amazon signature will be applied to your app, regardless of whether you submit a signed or unsigned APK.

3. Set up App Tester

Amazon provides an App Tester tool for performing unit testing of IAP. You can test out this tool with the IAP sample apps.

To install the App Tester and enable the sample app to run on the App Tester:

1. Follow the instructions in Installing and Configuring the App Tester.

2. From the sample app, using the adb push command, copy the amazon.sdktester.json file to the /mnt/sdcard/amazon.sdktester.json path on your device:

   $ adb push <_Your_JSON_File_Folder_>/amazon.sdktester.json /mnt/sdcard/
   

3. Follow the instructions in the App Tester User Guide to learn more about testing an app with App Tester. If you need help setting up the test cases to check with the App Tester, see Defining and Executing Test Cases for IAP.

4. Submit your app and in-app items

After you finish testing your app, you can submit your app and in-app items to Amazon.

See Create and Submit IAP Items.

---

Last updated: May 20, 2026