Home > Services & APIs > Earn > In-App Purchasing

Linking to the Amazon Client (IAP v1.0)

IAP v1.0 Deprecation Notice

In July 2014, Amazon released the In-App Purchasing (IAP) v2.0 API, which includes several important updates. As of April 30, 2016, Amazon will deprecate IAP v1.0 for new and updated app submissions. While this deprecation will not affect apps that are currently live in the Amazon Appstore, any apps submitted as either a new or updated app after May 11, 2016 will need to use IAP v2.0.


Providing a link directly to the Amazon Client from within your app is an effective tool for promoting your apps. This type of link is referred to as a deep link and can be used for several purposes including:

  • Linking to the paid version of your app on the Amazon Client
  • Linking to another one of your apps on the Amazon Client
  • Linking customers to the Amazon Client to write a review

Getting Started

The Amazon Client will automatically pick up on specially formatted links through the use of Android Intents. These are referred to as "deep" links. You have two options for providing a deep link.

Option Description Base URL
Link to the Amazon Retail Website This type of link will be picked up by the Amazon Client as well as any installed browsers on the device. http://www.amazon.com/gp/mas/dl/android?
Link directly to the Amazon Client This specially formatted link is the preferred method and will directly open up the Amazon Client. amzn://apps/android?

Link Configuration

Both deep link formats accept parameters to tailor the link result.

Parameter Description Amazon Client Example Amazon Retail Web Example
s= Add a search term. Please note that you would have to use URL Encoding for special characters (e.g. spaces). amzn://apps/android?s=amazon%20mp3 http://www.amazon.com/gp/mas/dl/android?s=amazon%20mp3
p= Link to the detail page for a specific package name. amzn://apps/android?p=com.amazon.mp3 http://www.amazon.com/gp/mas/dl/android?p=com.amazon.mp3
asin= All apps in the catalog have a unique identifier known as an ASIN. Use this identifier to link directly to an app by its ASIN. The ASIN for an app can be found on its detail page. amzn://apps/android?asin=B004FRX0MY http://www.amazon.com/gp/mas/dl/android?asin=B004FRX0MY
showAll=1 Show all apps by the developer of the app corresponding to the specified package name or ASIN (requires “p” or “asin” arg) amzn://apps/android?p=com.amazon.mp3&showAll=1 http://www.amazon.com/gp/mas/dl/android?p=com.amazon.mp3&showAll=1