In July 2014, we released In-App Purchasing (IAP) v2.0, which represents an evolution of the API with several major updates. With the continued focus on the newer IAP v2.0 we will deprecate v1.0 of the API on April 30, 2016. This means that new apps submitted with IAP after April 30th, 2016 must be on v2.0. If you make an update to an existing IAP v1.0 app after April 30, 2016 you must migrate to v2 by that date. We have created detailed documentation on the process to help you make the transition. If you have not already updated your app, here are some highlights on the features of v2.0 and migration details are noted below.
IAP v2.0 contains several major updates. First, per popular request, we’ve provided an immutable transaction identifier by replacing PurchaseToken with ReceiptId. This allows developers to easily de-dupe transactions, as well as better reconcile transaction records with Amazon reports available in their Amazon account. Second, we’ve included a new feature that allows for in-app item fulfillment notification. By using the notifyFulfillment() method, developers can tell Amazon whether or not an order was fulfilled to the customer, allowing for better order tracking. Third, Amazon is providing cancellation notification where we notify the developer if an order is cancelled so they can respond by taking appropriate action within their app. Finally, we’ve introduced App Tester as a replacement to SDKTester to improve testing based on developer feedback. After testing your app locally, you can use the Live App Testing service to beta test your app in a live production environment with a select group of users.
For those developers who have integrated IAP using plugins, we have four new plugins available: Adobe AIR, Cordova, Unity, and Xamarin. As a best practice, developers should implement the getPurchaseUpdates() method in the onStart() and onResume() method of the activity. Additionally, developers must implement the notifyFulfillment() method with the appropriate status when an item is fulfilled to a customer or the item cannot be fulfilled to the customer. Both of these implementation details are outlined in the referenced documentation.
Detailed documentation for integrating with IAP v2.0, instructions on how to migrate an app already integrated with IAP v1.0 to IAP v2.0, as well as instructions on how to test integration with App Tester and Live App Testing are available at https://developer.amazon.com/appsandservices/apis/earn/in-app-purchasing/docs-v2/migrate-iapv1-apps-to-iapv2.
Don’t forget that it is incredibly important that you update your app to the latest IAP 2.0 version before April 30, 2016 so that there are no disruptions of service to your app. You can learn more about IAP v2.0, download the SDK and plugins with the following links:
- Jesse Freeman (@jessefreeman)