Breaking Changes #

• API Cleanup: Removed all deprecated methods that were marked for removal in 6.0.0
  • Removed initialize() - use initConnection() instead
  • Removed checkSubscribed() - implement custom logic with getAvailablePurchases()
  • Removed showInAppMessageAndroid() - no longer supported
  • Removed manageSubscription() - use deepLinkToSubscriptionsAndroid() instead
  • Removed openPlayStoreSubscriptions() - use deepLinkToSubscriptionsAndroid() instead
  • Removed clearTransactionIOS() - no longer needed
  • Removed showPromoCodesIOS() - use presentCodeRedemptionSheetIOS() instead
  • Removed getPromotedProductIOS() and requestPromotedProductIOS() - use standard purchase flow
  • Removed requestProductWithOfferIOS() and requestPurchaseWithQuantityIOS() - use requestPurchase() with RequestPurchase object
  • Removed consumePurchaseAndroidLegacy() and validateReceiptAndroidLegacy() - use modern equivalents
  • Removed deepLinkToSubscriptionsAndroidLegacy() - use deepLinkToSubscriptionsAndroid()
  • Removed acknowledgePurchaseAndroid() - use finishTransaction() instead

Improvements #

• Code Quality: Removed internal legacy methods and cleaned up codebase
  • Removed _requestPurchaseOld() internal method
  • Consolidated duplicate functionality
  • Improved type safety and consistency

Migration Guide #

If you're upgrading from 6.0.x and were using any deprecated methods:

• Replace initialize() with initConnection()
• Replace acknowledgePurchaseAndroid() with finishTransaction()
• Use requestPurchase() with proper RequestPurchase objects instead of platform-specific methods
• Use presentCodeRedemptionSheetIOS() for promo codes on iOS

Bug Fixes #

• Android: Fixed missing signatureAndroid field in purchase conversion
  • Added signatureAndroid and other Android-specific fields to the Purchase object
  • Ensures Android purchase signature is properly passed through for receipt validation

Bug Fixes #

• iOS: Fixed type casting issue where subscriptionPeriodNumberIOS was sent as integer instead of string from native iOS code, causing runtime errors
• Internal: Renamed unused stream controllers for better code clarity
  • _purchaseUpdatedController → _purchaseUpdatedListener
  • _purchaseErrorListenerController → _purchaseErrorListener

Major Release - Open IAP Specification Compliance #

This major release redesigns the API to fully comply with the Open IAP specification, providing a standardized interface for in-app purchases across platforms.

What is Open IAP? #

Open IAP is an open standard for implementing in-app purchases consistently across different platforms and frameworks. By following this specification, flutter_inapp_purchase now offers:

• Consistent API design patterns
• Standardized error codes and handling
• Unified purchase flow across iOS and Android
• Better interoperability with other IAP libraries

Breaking Changes #

• Architecture: Complete redesign following Open IAP specification
  • Removed useIap hook and IapProvider - use FlutterInappPurchase.instance directly
  • Removed flutter_hooks dependency
  • Simplified API with direct instance access pattern
• iOS: Now requires iOS 11.0+ with StoreKit 2 support (iOS 15.0+)
• Android: Updated to Billing Client v8.0.0
• API Changes:
  • Enum naming convention: E_UNKNOWN → eUnknown (lowerCamelCase)
  • Channel access: FlutterInappPurchase.channel → FlutterInappPurchase.instance.channel
  • Unified error handling with standardized error codes

New Features #

• Open IAP Compliance: Full implementation of the Open IAP specification
• Improved Error Handling: Standardized error codes across platforms
• Event-based Architecture: New listeners for purchase updates and errors
• StoreKit 2 Support: Automatic transaction verification on iOS 15.0+
• Better Type Safety: Enhanced TypeScript-like type definitions

Migration Guide #

// Before (5.x)
final iap = useIap();
await iap.initialize();

// After (6.0)
final iap = FlutterInappPurchase.instance;
await iap.initConnection();

For complete migration details, see the documentation.

• fix: removed references to deprecated v1 Android embedding by @moodstubos in https://github.com/hyochan/flutter_inapp_purchase/pull/497

• Erroneous duplicate item by @deakjahn in https://github.com/hyochan/flutter_inapp_purchase/pull/441
• Fixed consumable products reading on Android by @33-Elephants in https://github.com/hyochan/flutter_inapp_purchase/pull/439
• fix: Support AGP8 namespace by @dev-yakuza in https://github.com/hyochan/flutter_inapp_purchase/pull/467

• refactor: android init connection

  Used Kotlin apply for cleaner initialization of billingClient.
  Introduced context ?: return for null-safety with context.
  Merged repetitive code into the updateConnectionStatus method to avoid duplication.
  Improved the handling of the alreadyFinished flag to ensure it is only set once and at the appropriate time.
  Streamlined the error and success handling for clarity.
  

• Migrate android billingClient to 6.0.1

  • https://developer.android.com/google/play/billing/release-notes#6-0-1

• Erroneous duplicate item (#441) - Remove extra introductoryPricePaymentModeIOS

• Fixed consumable products reading on Android (#439)

• chore(deps): migrate internal packages to recent

  http: ^1.1.0
  meta: ^1.10.0
  platform: ^3.1.3
  

• chore: migrate example project to recent flutter version, 3.16.0-0.3.pre

What's Changed #

• Update actions/stale action to v8 by @renovate in https://github.com/hyochan/flutter_inapp_purchase/pull/414
• Fix - wrong casting by @BrunoFSimon in https://github.com/hyochan/flutter_inapp_purchase/pull/427
• Fixed consumable product purchase on Android by @33-Elephants in https://github.com/hyochan/flutter_inapp_purchase/pull/420

New Contributors #

• @BrunoFSimon made their first contribution in https://github.com/hyochan/flutter_inapp_purchase/pull/427
• @33-Elephants made their first contribution in https://github.com/hyochan/flutter_inapp_purchase/pull/420

Full Changelog: https://github.com/hyochan/flutter_inapp_purchase/compare/5.4.1...5.4.2

• Fixed concurrency issue on iOS. by @OctavianLfrd in https://github.com/hyochan/flutter_inapp_purchase/pull/413

• Fixed wrong casting in checkSubscribed method by @kleeb in https://github.com/hyochan/flutter_inapp_purchase/pull/368
• Upgrade to billing 5.1 (reverse compatible) by @SamBergeron in https://github.com/hyochan/flutter_inapp_purchase/pull/392

What's Changed #

• Refactor java to kotlin, add showInAppMessageAndroid by @offline-first in https://github.com/hyochan/flutter_inapp_purchase/pull/365

New Contributors #

• @offline-first made their first contribution in https://github.com/hyochan/flutter_inapp_purchase/pull/365

Full Changelog: https://github.com/hyochan/flutter_inapp_purchase/compare/5.2.0...5.3.0

Bugfix #356

Run on UiThread and few others (#328)

• Related #272

• The main difference is a new MethodResultWrapper class that wraps both the result and the channel. onMethodCall() now immediately saves this wrapped result-channel to a field and only uses that later to set both the result and to send back info on the channel. I did this in both Google and Amazon but I can't test the Amazon one.

• Included the plugin registration differences.

• Midified suggested in one of the issues that initConnection, endConnection and consumeAllItems shouldn't be accessors. This is very much so, property accessors are not supposed to do work and have side effects, just return a value. Now three new functions are suggested and marked the old ones deprecated.

Fourth, EnumUtil.getValueString() is not really necessary, we have describeEnum() in the Flutter engine just for this purpose.

Upgrade android billing client to 4.0.0 (#326)

Remove orderId in Purchase

• This is duplicate of transactionId.

Support for Amazon devices with Google Play sideloaded (#313)

• Add iOS promo codes (#325)
• Use http client in validateReceiptIos (#322)
• Amazon getPrice directly withoiut formatting (#316)

• Fix plugin exception for requestProductWithQuantityIOS #306

• Replaced obfuscatedAccountIdAndroid with obfuscatedAccountId in request purchase method #299

• Add AndroidProrationMode values #273

• Support null safety #275

• The dart side requires "introductoryPriceCyclesAndroid" to be a int #268

• platform dep version >=2.0.0 <4.0.0

• Support flutter v2 #265

• Migrate to flutter embedding v2 #240
• Expose android purchase state as enum #243

• Upgrade android billing client to 2.1.0 from 3.0.0.
• Removed deveoperId and accountId when requesting purchase or subscription in android.
• Added obfuscatedAccountIdAndroid and obfuscatedProfileIdAndroid when requesting purchase or subscription in android.
• Removed developerPayload in android.
• Added purchaseTokenAndroid as an optional parameter to requestPurchase and requestSubscription.

Republishing since sourcode seems not merged correctly.

• Bugfix IAPItem deserialization #212
• Add introductoryPriceNumberIOS #214
• Fix iOS promotional offers #220

• Implement endConnection method to declaratively finish observer in iOS.
• Remove addTransactionObserver in IAPPromotionObserver.m for dup observer problems.
• Automatically startPromotionObserver in initConnection for iOS.

• Fix ios failed purchase handling problem in 11.4+ #176

• Fix dart side expression warning #169.

• Fix wrong introductory price number of periods #164.

• Trigger purchaseUpdated callback when iap purchased #165.

• Renamed finishTransactionIOS argument purchaseToken to transactionId.

• finishTransaction parameter changes to purchasedItem from purchaseToken.
• Update android billing client to 2.1.0 from 2.0.3.

• [bugfix] Fix double call of result reply on connection init #126

• [bugfix] Fix plugin throws exceptions with flutter v1.10.7 beta #117

• [bugfix] Decode response code for connection updates stream #114
• [bugfix] Fix typo in consumePurchase #115

• use ConnectionResult as type for connection stream, fix controller creation #112

• Resolve #106 by not sending result.error to the listener. Created use _conectionSubscription.

• Fixed minor typo when generating string with toString. Resolve #110.

• Pass android exception to flutter side.

• Android receipt validation api upgrade to v3.

• Resolve #102. Fluter seems to only sends strings between platforms.

• Resolve #101.

• Resolve #100.

• Resolve #99.

• Send purchase-error with purchases returns null.

• Renamed invoked parameters non-platform specific.

• Add deveoperId and accountId when requesting purchase or subscription in android. Find out more in requestPurchase and requestSubscription.

• Correctly mock invoke method and return results #94

• Seperate long example code to example readme.

• Properly set return type PurchaseResult of when finishing transaction.

• Removed deprecated note in the readme.
• Make the previous tests work in travis.
• Documentation on readme for breaking features.
• Abstracts finishTransaction.
  • acknowledgePurchaseAndroid, consumePurchaseAndroid, finishTransactionIOS.

[Android]

• Completely remove prepare.
• Upgrade billingclient to 2.0.3 which is currently recent in Sep 15 2019.
• Remove [IInAppBillingService] binding since billingClient has its own functionalities.
• Add [DoobooUtils] and add getBillingResponseData that visualizes erorr codes better.
• buyProduct no more return asyn result. It rather relies on the purchaseUpdatedListener.
• Add feature method acknowledgePurchaseAndroid
  • Implement acknowledgePurchaseAndroid.
  • Renamed consumePurchase to consumePurchaseAndroid in dart side.
  • Update test codes.
• Renamed methods
  • buyProduct to requestPurchase.
  • buySubscription to requestSubscription.

[iOS]

• Implment features in new releases.
  • enforce to finishTransaction after purchases.
  • Work with purchaseUpdated and purchaseError listener as in android.
  • Feature set from react-native-iap v3.
  • Should call finish transaction in every purchase request.
  • Add IAPPromotionObserver cocoa touch file
  • Convert dic to json string before invoking purchase-updated
  • Add getPromotedProductIOS and requestPromotedProductIOS methods
  • Implement clearTransaction for ios
  • Include purchasePromoted stream that listens to iap-promoted-product.

• Add DEPRECATION note. Please use in_app_purchase.

0.9.+ #

• Breaking change. Migrate from the deprecated original Android Support Library to AndroidX. This shouldn't result in any functional changes, but it requires any Android apps using this plugin to also migrate to Android X if they're using the original support library. Android's Migrating to Android X Guide.

• Improved getPurchaseHistory's speed 44% faster #68.

0.8.+ #

• Fixed receipt validation param for android.

• Updated http package.

• Implemented new method getAppStoreInitiatedProducts.

  • Handling of iOS method paymentQueue:shouldAddStorePayment:forProduct:
  • Has no effect on Android.

• Fixed issue with method buyProductWithoutFinishTransaction for iOS, was not getting the productId.

• Fixed issue with toString method of class IAPItem, was printing incorrect values.

• Fixes for #44. Unsafe getting originalJson when restoring item and Android.

• Use dictionaryWithObjectsAndKeys in NSDictionary to fetch product values. This will prevent from NSInvalidArgumentException in ios which rarely occurs.

• Fixed wrong npe in android when getAvailablePurchases.

• Only parse orderId when exists in Android to prevent crashing.

• Add additional success purchase listener in iOS. Related #54

• Implemented receiptValidation for both android and ios.
  • In Android, you need own backend to get your accessToken.

• Addition of Amazon In-App Purchases.

• Prevent nil element exception when getting products.

• Prevent nil exception in ios when fetching products.

• Fix broken images on pub.

• Added missing introductory fields in ios.

• convert dynamic objects to PurchasedItems.
• Fix return type for getAvailablePurchases().
• Fix ios null value if optional operator.

• Update readme.

• Fixed failing when there is no introductory price in ios.

• Fixed checkSubscribed that can interrupt billing lifecycle.

• Major code refactoring by lukepighetti. Unify PlatformException, cleanup new, DateTime instead of string.

• Fix getSubscription json encoding problem in ios.

• Avoid crashing on android caused by IllegalStateException.

• Avoid possible memory leak in android by deleting static declaration of activity and context.

• Few types fixed.

• Fixed error parsing IAPItem.

• Fixed error parsing purchaseHistory.

• Fix crashing on error.

• Give better error message on ios.

• Code migration.
• Support subscription period.
• There was parameter renaming in 0.5.0 to identify different parameters sent from the device. Please check the readme.

• Fixed subscription return types.

• Well formatted code.

• Code formatted
• Updated missing data types

• Upgraded readme for ease of usage.
• Enabled strong mode.

• Moved dynamic return type away and instead give PurchasedItem.

• Quickly fixed purchase bug out there in issue. Need much more improvement currently.

• Migrated packages from FlutterInApp to FlutterInAppPurchase because pub won't get it.

• Initial release of beta
• Moved code from react-native-iap