What is In-App Purchasing (IAP)?
With In-App Purchasing (IAP), your app’s users can purchase various types of digital items within your app, such as extra lives for a game or a subscription to premium content. The following scenarios describe potential use cases for IAP:- Create a “freemium” model for your app where the app itself is free, but you charge a premium for advanced services or functionality.
- Allow your customers to purchase items to enhance their gaming experience, such as currency, extra moves, or lives.
- Unlock bonus levels or mini-games by allowing customers to purchase access to this content.
- Enable customers to subscribe to content available within your app.
Amazon’s role in IAP
The Amazon Appstore plays an integral part of the IAP API workflow. Amazon runs the purchase workflow, starting when the customer decides to purchase an item and ending when Amazon provides the app either a receipt for the purchase or a status code, in the case of a failed purchase. You do not need to provide purchase dialogs, transaction timeout logic, or “Thank You” dialogs. The Amazon Appstore provides all of these pieces of a transaction. Once a user initiates a purchase, the Amazon Appstore client app surfaces and presents an Amazon-branded user interface to complete the transaction. This app presents the user interface for all aspects of the purchase workflow:- Logic to display the purchasable item.
- Perform the purchase.
- Handle any preconditions or error scenarios.
| Responsibility | Your App | Amazon |
|---|---|---|
| Presents the catalog of in-app items to the customer for purchase. | ||
| Unlocks purchasable functionality. | ||
| Manages the purchase flow. | ||
| Performs payment processing. | ||
| Handles secure communication with the Amazon platform, including payment security. | ||
| Verifies entitlements and validates purchase receipts. | ||
| Manages billing for auto-renewing subscriptions. | ||
| Manages billing for revoking of entitlements. | ||
| Verifies receipts for subscriptions and entitlements before providing content to user. | ||
| Downloads remotely delivered content. | ||
| Displays and uses downloaded digital goods. | ||
| Tracks customer purchases and consumable inventory. |
IAP components
If you are new to working with Amazon IAP, familiarize yourself with the following components, which are all involved in implementing this feature:| Name | Description |
|---|---|
| Appstore SDK IAP API | Your app uses the IAP API from the Appstore SDK to implement and fulfill in-app purchases. |
| Appstore SDK API Reference | Lists and descriptions of the APIs contained in the Appstore SDK, which include the IAP API. |
| Amazon Appstore | Handles payment processing, alerts, fulfillment, and other back-end functionality. |
| App Tester | Test your app locally before publishing to the Amazon Appstore. |
| Receipt Verification Service (RVS) | Verify the validity of transaction receipts. RVS supports a sandbox environment and a production environment. |
| Live App Testing | Beta test your app with a select group of users in a production environment. |

