Get Started with Appstore DevTest for IAP

This page provides an introduction on how to use Appstore DevTest for In-App Purchasing (IAP). For a conceptual overview, see About Appstore DevTest for IAP.

• Prerequisites
• Register your app
• Add testers
• Prepare your app
• Related topics

Prerequisites

To get started with DevTest for IAP, you must have the following:

• Developer or administrator role in the developer account
• Certificate information

  • You can use existing keys if you already have them, otherwise, you can use the following command to generate new ones.

      openssl req -x509 -nodes -newkey ec -pkeyopt ec_paramgen_curve:secp384r1 -keyout key.pem -out cert.pem
    

    The above command generates 2 files: key.pem (Private Key) and cert.pem (Certificate).

    DevTest for IAP currently supports the use of Elliptic Curve Digital Signature Algorithm (ECDSA) for digital certificate used during the registration process.

• In-app purchase items submitted and in a live state

Register your app

Before you can test your app with DevTest for IAP, you must register your app.

To register your app in the Developer Console

1. Go to the Developer Console dashboard and if needed, sign in.
2. From the top navigation bar, select Apps & Services > My Apps, and then select your app.
3. On the left sidebar for your app, select Amazon Appstore DevTest for IAP.
4. On the registration page, provide the data from the certificate file in the Certificate field, which you will use to sign the app, and click Register.

   

5. Use the certificate to sign your app. For details, see Prepare your app.

You can now test using DevTest for IAP. For detailed instructions on how to integrate the IAP API into your app, see IAP Overview.

Add testers

After you register your app, you can start adding testers to DevTest for IAP. You can grant access to up to 10 testers. Only the testers you add here are entitled to make in-app purchases when testing the app locally. For general instructions on how to manage testers in your account, see Manage Testers for Appstore DevTest for IAP.

To add testers to DevTest for IAP in the Developer Console

1. Go to the Developer Console dashboard and if needed, sign in.
2. From the top navigation bar, select Apps & Services > My Apps, and then select your app.
3. On the left sidebar for your app, under Amazon Appstore DevTest for IAP, select Manage Testers.

4. On the testers screen, select Add new testers. All testers must be in a group. From this screen, you can choose to add new testers or add existing testers from an existing group.

   • Add New Testers
   • Add Existing Testers
   1. Select the Add new testers radio button.
   2. You can either upload a CSV file or add testers individually. If you use a CSV file, list the testers with the format: E-mail,First name,Last name. If you add testers individually, use the plus button to add more. You can add yourself as a tester too.
   3. Add the testers to a group by either creating a new group, or adding the testers to an existing group.

      • To create a new group, select Create new tester group. This opens a new field labeled Add new tester group. Click the checkbox for Add new tester group and enter a name for the group in the field.

        

        

      • To add the tester to an existing group, select the groups to which you want the tester added.

   4. You must have the rights to provide the testers' names and email addresses to Amazon, the testers should have consented to receive communications from Amazon, and the testers must be at least 18 years old. To confirm this, click the checkbox with this statement and select Add.

   1. Select the Add existing testers radio button.
   2. Under Existing testers, use the radio buttons to choose whether to add entire groups or select specific testers from one or more groups.

   3. After choosing the groups or testers, select Add.

      

The testers you added now have permission to use DevTest for IAP on their local devices.

Prepare your app

DevTest for IAP supports apps using Appstore SDK version 3.0.3 and higher and devices running Fire OS 6 and higher. For details about how to integrate your app with Appstore SDK, see Integration steps for Appstore SDK. Before you can start testing with DevTest for IAP, you must generate a signed APK.

To sign your app with the certificate from registration

1. Generate a keystore for the certificate that you used to register your app.

    openssl pkcs12 -export -out keystore.p12 -inkey key.pem -in cert.pem
   

   You will use the keystore to generate a signed APK.

2. Generate a signed APK file. There are several ways to generate a signed APK, which are described in the Android developer documentation in Sign your app. You can follow the steps in Sign your app for release. With this approach, using Android Studio, select Build > Generate Signed Bundle / APK…, and then complete the information required by the APK wizard.
3. Sideload the APK on a device using the adb install command. For details about the command, see Install an app in the Android developer documentation.
   Note: You must add testers before you sideload the APK.
4. Synchronize the content on your Fire device by navigating to Settings > Account & Profile Settings > Sync Amazon Content.

Related topics

• Manage Testers for Appstore DevTest for IAP
• Appstore DevTest for IAP FAQ
• About Appstore DevTest for IAP

Last updated: May 09, 2025