NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev, #480 most downloaded on pub.dev
An implementation for the Android platform of the Flutter `in_app_purchase` plugin. This uses the Android BillingClient APIs.
Latest stable
0.5.5
Last release 1 months ago
19 Oct 2026
Ships fairly regularly
a new release about every 6 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
6 years old
108 releases · first in 2021
Drag across the ruler to compare, or tap a release to open it.
…ReplacementMode enum. That belongs in its own breaking change.
Updates com.android.billingclient:billing from 8.0.0 to 9.1.0 in in_app_purchase_android.
Why the minSdk change is required. Play Billing Library 9 declares minSdkVersion 23 in its own AAR manifest (8.0.0 declared 21). With the plugin still on minSdk = 21, the manifest merger fails in any consuming app:
Manifest merger failed : uses-sdk:minSdkVersion 21 cannot be smaller than
version 23 declared in library [com.android.billingclient:billing:9.1.0]
The library module itself still builds at 21, so this only surfaces in the app that consumes the plugin. Raising the plugin's minSdk to 23 makes the constraint explicit. Flutter's own flutter.minSdkVersion is already 24, so there is no practical impact on clients. The same floor is imposed a second time transitively, via play-services-basement 18.9.0.
No removed APIs are used. Diffing the public API of billing-8.0.0.aar against billing-9.1.0.aar shows v9 removes exactly seven classes — SkuDetails, SkuDetailsParams(.Builder), SkuDetailsResponseListener, BillingClient.SkuType, QueryPurchaseHistoryParams(.Builder) — plus BillingFlowParams.Builder.setSkuDetailsList. None appear anywhere under android/src. PurchaseHistoryRecord, which Translator.kt still imports, survives into 9.1.0.
Deprecation. SubscriptionUpdateParams.Builder.setSubscriptionReplacementMode is deprecated as of 8.1.0 but remains functional in 9.x. Because the example builds the plugin with -Xlint:all -Werror, this breaks the build, so it is suppressed with an explanatory comment rather than migrated. Migrating to SubscriptionProductReplacementParams is not a drop-in change: it renumbered the replacement mode constants, which would alter the values carried by the Dart ReplacementMode enum. That belongs in its own breaking change.
Behaviour change reaching clients. Under v9, a Play Store blocked by the system (for example OEM-customized kids mode) reports BILLING_UNAVAILABLE instead of ERROR. The plugin maps response codes 1:1 and branches on neither value, so no plugin code changes; but apps that branch on the code, or match on the stringified code in IAPError.message, are affected. This is called out in the CHANGELOG.
Also corrects the documentation for BillingResponse.billingUnavailable (described the legacy "billing API version not supported" meaning) and BillingResponse.serviceUnavailable (described a network outage, which is what networkError means).
This supersedes #12414, the Dependabot version-only bump, which does not include the required minSdk change and therefore does not build.
Automated: all existing Dart and native unit tests pass against 9.1.0, and the example app builds.
Manual, against a real Play Console app running this branch with billing 9.1.0:
queryProductDetails) return the expected products, prices and offersNot exercised manually: the subscription replacement path (setSubscriptionReplacementMode), which is the deprecated call suppressed in this PR, and consumable purchase/consumption. Flagging that explicitly since it is the least-covered part of this change — note also that the plugin's unit tests mock BillingClient entirely, so none of them exercise the real library at runtime.
Fixes flutter/flutter#189974
Note: The Flutter team is currently trialing the use of Gemini Code Assist for GitHub. Comments from the gemini-code-assist bot should not be taken as authoritative feedback from the Flutter team. If you find its comments useful you can update your code accordingly, but if you are unsure or disagree with the feedback, please feel free to wait for a Flutter team member's review for guidance on which automated comments should be addressed.
Test exemption: this is a manual dependency roll, which Tree Hygiene lists as not automatically exempt, so I am requesting one explicitly. The plugin's behaviour is unchanged: response codes are passed through 1:1 (Translator.kt -> pigeon -> pigeon_converters.dart), and no branch in the plugin keys on error or billingUnavailable. The one user-visible change originates in Google's library, not in plugin code, and so cannot be exercised by a plugin test. Happy to add tests if a reviewer sees a seam I have missed.
On the deprecation suppression: if the team would rather take the breaking SubscriptionProductReplacementParams migration now instead of suppressing, I am glad to do that here or in a follow-up — say which you prefer.
Your coding agent can read these notes before it upgrades. Set up the MCP server →
minSdkVersion will fail to
merge the manifest; Flutter's own minimum is already 24.BillingResponse.billingUnavailable where it previously reported
BillingResponse.error. Apps that branch on the response code, or that match
on the stringified code in IAPError.message, must handle the new value.BillingResponse.billingUnavailable and
BillingResponse.serviceUnavailable, which described the wrong conditions.[in_app_purchase_android] Guard async billing callbacks against dupli…
[in_app_purchase_android] Guard async billing callbacks against dupli…
IllegalStateException: Reply already submitted) when the
Play Billing library invokes a response listener more than once for a single
call.Updates pigeon dev_dependency to ^27.3.2 for analyzer 14 compatibility.
Adds support for passing an obfuscated profile ID in GooglePlayPurchaseParam.
GooglePlayPurchaseParam.Adds support to overlay billing related messages. See InAppPurchaseAndroidPlatformAddition.showInAppMessages.
InAppPurchaseAndroidPlatformAddition.showInAppMessages.Updates Google Play Billing Library from 7.1.1 to 8.0.0.
queryPurchaseHistory and its wrapper queryPurchaseHistoryAsync. Use queryPurchases instead.subResponseCode in BillingResultWrapper.oneTimePurchaseOfferDetailsList in ProductDetailsWrapper.unfetchedProductList in ProductDetailsResponseWrapper to handle product IDs that could not be fetched.Migrates to Built-in Kotlin to support AGP 9.
Bumps the androidx group across 10 directories with 1 update.
Updates build files from Groovy to Kotlin.
Fixes dartdoc comments that accidentally used HTML.
Updates internal implementation to use Kotlin Pigeon.
Removes the deprecated ProrationMode enum. ReplacementMode should be used instead.
ProrationMode enum. ReplacementMode should be used instead.BillingClientWrapper.enablePendingPurchases method.subscriptionsOnVR and inAppItemsOnVR from BillingClientFeature.installmentPlanDetails to SubscriptionOfferDetailsWrapper.PendingPurchasesParams).Updates compileSdk 34 to flutter.compileSdkVersion.
Adds support for setting the offerToken on GooglePlayPurchaseParam.
offerToken on GooglePlayPurchaseParam.Updates kotlin version to 2.2.0 to enable gradle 8.11 support.
Bumps com.android.tools.build:gradle to 8.12.1.
Resolves Gradle 9 deprecations.
Updates Java compatibility version to 17 and minimum supported SDK version to Flutter 3.35/Dart 3.9.
* Updates to Pigeon 26.
Bumps com.android.tools.build:gradle from 8.12.1 to 8.13.1.
Introduces new ReplacementMode for Android's billing client as ProrationMode is being deprecated.
ReplacementMode for Android's billing client as ProrationMode is being deprecated.Updates minimum supported SDK version to Flutter 3.22/Dart 3.4.
Updates Android Gradle Plugin to 8.5.1.
Updates lint checks to ignore NewerVersionAvailable.
Bumps androidx.annotation:annotation from 1.8.0 to 1.8.1.
Bumps com.android.billingclient:billing from 6.1.0 to 6.2.0.
Bumps androidx.annotation:annotation from 1.8.1 to 1.8.2.
Sets android.buildFeatures.buildConfig to true for compatibility with AGP 8.0+.
android.buildFeatures.buildConfig to true for compatibility with AGP 8.0+.Removes dependency on org.jetbrains.kotlin:kotlin-bom.
Updates Java compatibility version to 11.
Updates Pigeon for non-nullable collection type support.
Bumps androidx.annotation:annotation from 1.8.2 to 1.9.0.
Updates README to remove contributor-focused documentation.
Updates androidx.annotation:annotation to 1.9.1.
Replaces getCountryCode with countryCode.
getCountryCode with countryCode.Updates example to use countryCode instead of deprecated getCountryCode.
countryCode instead of deprecated getCountryCode.Bumps androidx.annotation:annotation from 1.7.1 to 1.8.0.
* Adds countryCode API.
countryCode API.Adds documentation for UserChoice and Alternative Billing.
Deprecates JSON serialization and deserialization for Billing Client wrapper objects.
Moves alternative billing listener creation to BillingClientFactoryImpl.
Adds UserChoiceBilling APIs to platform addition.
Converts internal platform communication to Pigeon.
Adds alternative-billing-only APIs to InAppPurchaseAndroidPlatformAddition.
BREAKING CHANGE: Removes launchPriceChangeConfirmationFlow from InAppPurchaseAndroidPlatform. Price changes are now handled by Google Play.
launchPriceChangeConfirmationFlow from InAppPurchaseAndroidPlatform. Price changes are now handled by Google Play.queryProductDetailsAsync is called.Fixes misaligned method signature strings.
Removes obsolete null checks on non-nullable values.
* Fixes Java lint issues.
Fixes unawaited_futures violations.
Bumps org.jetbrains.kotlin:kotlin-bom from 1.8.0 to 1.8.21.
Bumps org.jetbrains.kotlin:kotlin-bom from 1.8.21 to 1.8.22.
Bumps org.mockito:mockito-core from 4.7.0 to 5.3.1.
Adds a guide for migrating to 0.3.0.
Bumps com.android.billingclient:billing from 5.2.0 to 6.0.0.
Bumps com.android.billingclient:billing from 6.0.0 to 6.0.1.
Migrates styleFrom usage in examples off of deprecated primary and onPrimary parameters.
styleFrom usage in examples off of deprecated primary and onPrimary parameters.Adds pub topics to package metadata.
Updates example code for current versions of Flutter.
Updates annotations lib to 1.7.0.
Adds missing network error response code to BillingResponse enum.
One column per quarter.