In-App Purchasing (IAP) is gaining in popularity with developers as it continues to be a reliable revenue generator for mobile apps and games. It is the basis of Free-to-Play, eliminating up-front costs but allowing customers to purchase upgrades and add-ons they find valuable. The Amazon Appstore platform is designed to manage these transactions, and we have enhanced our In-App purchasing API to make it easier for you to manage the purchases your customers make.

Improved Customer Experience

With this update, the In-App Purchasing API improves the receipt process to provide better visibility into the fulfillment status of your customers’ in-app purchases.

The updated API replaces PurchaseToken with a unique receipt identifier called ReceiptId. The ReceiptId value allows you to:

• Determine fulfillment status and reconcile transaction records with your Amazon earnings report.
• Identify duplicate transactions to prevent over-fulfillment of digital content.
• Receive notification of transactions that cancel orders.

Getting Started

The updated API is backward-compatible, which means that your existing applications will continue to work without modification. We recommend that you migrate to the latest version, though, so that you can benefit from these improvements.

• If you are adding in-app purchasing to your app for the first time, simply build your project with the Amazon Mobile App SDK, which includes the latest version of the In-App Purchasing API.
• If your app already uses an older version of the API but you’re not ready to migrate from PurchaseToken to ReceiptId, you can still update to the latest version. Your app will work without modification, so you can prepare for the switch and follow through with the actual migration when you’re ready.
• If you are ready to use ReceiptId now, simply follow the migration guide available on our Developer Portal.

Additional Resources

For more details on in-app purchasing and how to implement it in your mobile projects, check out our Developer Portal and blog. Dive deep on the new API, or explore related topics such as increasing conversion, digital item sales in desktop and web-based applications, and managing promotions and discounts.