Configuration for the Amazon Appstore and Amazon Underground stores

Introduction

This guide describes the process of setting up the Amazon Appstore and the Amazon Underground stores for use with the Unity in-app purchasing (IAP) system. This includes establishing the digital records and relationships that are required to interact with the Unity IAP API, setting up an Amazon developer account, and testing and publishing a Unity IAP application.

As with other platforms, the Amazon stores allow for the purchase of virtual goods and managed products. These digital products are identified using a string identifier and an additional type to define durability, with choices including subscription (capable of being subscribed to), consumable (capable of being rebought), and non-consumable (capable of being bought once). Note that the Amazon Underground store does not support subscription.

Amazon has established two app stores for both non-FireOS Android devices as well as FireOS, set up to support free and paid versions of the same app:

• The Amazon Appstore is provided to support paid and free apps.
• The Amazon Underground store is designed to give developers a payment schedule for eligible free apps. The Underground store also has stringent requirements for apps based on pay per time spent in the application. More details can be found in the program overview and details documents.

Cross-store implementation of in-app purchases

There are cross-store installation issues with publishing to multiple Android IAP stores (e.g. Amazon and Google) simultaneously and shared Android bundle identifiers. Please see the page on Cross-store installation issues with Android in-app purchase stores to learn more.

Amazon Appstore and Amazon Underground stores

Getting started

1. Set up an Amazon developer account at the Amazon developer portal. A single developer account may be used to set up both stores.
2. Determine which store is most appropriate for your app. Take note of your game’s product identifiers, and study the differences in the types of digital items that are acceptable for the different stores. For example, the identifier for consumable coins will be used in the Amazon store rather than the Amazon Underground store.
3. Write a game implementing the Unity IAP API. For reference, see the guides on Unity IAP initialization and Integrating Unity IAP in your game. Use the Amazon Appstore for apps with no restrictions on IAP items. To create a free version of your app for the Amazon Underground store, follow Amazon’s guidelines.

Device setup

1. For non-FireOS Android devices, download and install the Amazon Appstore. Additionally, if you plan on an Underground version of your app, download and install the Amazon Underground store.

2. On FireOS devices, the Amazon Appstore and the Amazon Underground apps should come pre-installed. If your FireOS device doesn’t have the Amazon Underground store installed, download and install it from the Amazon website.

3. Once you have installed Amazon Appstore (and Amazon Underground, if desired), install the Amazon App Tester.

   

4. Set up the Android SDK
   1. To install and watch the Android debug log, ensure you have the Android SDK installed. Download the relevant command line tools package from the Android SDK install page and extract them to your computer.
   2. Confirm that the SDK recognizes the attached Android device through the command-line adb tool. For example:

|[11:07:01] user@laptop:/Applications | $ adb devices
List of devices attached
00DA0807526300W5    device

Unity app setup

Setting up to use Unity’s IAP takes a few steps.

1. Import the Unity IAP plug-in. See Setting up Unity IAP for more information (Unity 5.3 or higher).

2. Set the IAP target store. You should already have an Android app set up. Set the target store using Unity IAP’s Window > Unity IAP > Android > Target Amazon menu item. This is used to toggle between Google and Amazon stores.

   

Alternatively, call the API:

UnityPurchasingEditor.TargetAndroidStore(AndroidStore.AmazonAppStore)

Amazon Appstore and Amazon Underground setup

It’s not necessary to download Amazon’s native IAP plug-in when preparing to use the Amazon stores, as all of the functionality it provides is already included in Unity’s IAP service.

1. Add your app. From the Amazon Developer Portal select Add a New App.

   

2. Set up your catalog. Using the product descriptions you prepared earlier, add the items to the Amazon catalog using the Amazon Developer Portal. Navigate to your app’s page, and find the In-App Items section. Use the Add a Consumable, Add an Entitlement, or Add a Subscription buttons to set up your catalog.