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 the digital certificate used during the registration process.

• In-app purchase items submitted and in a live state
• If registering your app using the App Submission API for Testing, you must complete API authentication.

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. If you want to add an additional certificate, click Add new certificate and add a certificate. You can also name your certificate for easier identification. After you upload your certificates, click Register.
   Note: If you add only one certificate when you initially register, you can upload additional certificates later. You can upload a maximum of three certificates to DevTest for IAP.

   

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 50 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

Before you can start testing with DevTest for IAP, you must sign your app with the certificate you used during registration.

To sign your app with the certificate from registration

1. Pull the existing signature from your VPKG.

    vpt pull --signature <PATH_TO_VPKG> existing_digest.sig
   

   Replace PATH_TO_VPKGwith your package's path. Your VPKG must be in the same directory where you run this command. existing_digest.sig is a signature file automatically created which contains the signature extracted from the VPKG binary.

2. Re-sign. Re-signing allows you to sign a package while retaining existing signatures.

    vpt sign --resign existing_digest.sig <private_key> <certificate> updated_digest.sig
   

   The private key and certificate references are your key and certificate used to sign the VPKG binary.

3. Add the signature back to the VPKG.

    vpt push --signature updated_digest.sig <PATH_TO_VPKG>
   

4. Enable developer mode on your device and sideload the app. For help with commands, see Vega SDK CLI Reference.
   Note: You must add testers before you sideload the app.

Related topics

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

---

Last updated: Sep 30, 2025