flutter_inapp_purchase

Dependencies

• Updated OpenIAP versions:
  • openiap-google: 1.3.15 -> 1.3.16

New Features

• Advanced Commerce Data (iOS 15+): Support for StoreKit 2's Product.PurchaseOption.custom API

  • New advancedCommerceData field in RequestPurchaseIosProps and RequestSubscriptionIosProps
  • Pass campaign tokens, affiliate IDs, or other attribution data during purchases

  await iap.requestPurchaseWithBuilder(
    build: (builder) {
      builder.ios.sku = 'com.example.premium';
      builder.ios.advancedCommerceData = 'campaign_summer_2025';
      builder.type = ProductQueryType.InApp;
    },
  );
  

• google field support (Android): New google field in request parameters with android fallback

  • Aligns with OpenIAP specification for consistent cross-platform naming
  • android field is now deprecated; use google instead

Deprecated

• requestPurchaseOnPromotedProductIOS(): Use purchasePromoted stream + requestPurchase() instead

  • In StoreKit 2, promoted products can be purchased via the standard purchase flow

  // Recommended approach
  iap.purchasePromoted.listen((productId) async {
    if (productId != null) {
      await iap.requestPurchaseWithBuilder(
        build: (builder) {
          builder.ios.sku = productId;
          builder.type = ProductQueryType.InApp;
        },
      );
    }
  });
  

Dependencies

• Updated OpenIAP versions:
  • openiap-apple: 1.3.5 -> 1.3.7
  • openiap-google: 1.3.14 -> 1.3.16
  • openiap-gql: 1.3.5 -> 1.3.8

Breaking Changes

• oneTimePurchaseOfferDetailsAndroid is now an array: Changed from ProductAndroidOneTimePurchaseOfferDetail? to List<ProductAndroidOneTimePurchaseOfferDetail>? to support multiple discount offers per product (Google Play Billing 7.0+)

  // Before (v7.x)
  final price = product.oneTimePurchaseOfferDetailsAndroid?.formattedPrice;
  
  // After (v8.x)
  final offers = product.oneTimePurchaseOfferDetailsAndroid;
  final price = offers?.isNotEmpty == true ? offers![0].formattedPrice : null;
  

• verifyPurchase and validateReceipt API changed: Now uses platform-specific options instead of deprecated sku and androidOptions parameters

  // Before (v7.x)
  final result = await iap.verifyPurchase(sku: 'product_id');
  final result = await iap.verifyPurchase(
    sku: 'product_id',
    androidOptions: VerifyPurchaseAndroidOptions(...),
  );
  
  // After (v8.x) - iOS
  final result = await iap.verifyPurchase(
    apple: VerifyPurchaseAppleOptions(sku: 'product_id'),
  );
  
  // After (v8.x) - Android
  final result = await iap.verifyPurchase(
    google: VerifyPurchaseGoogleOptions(
      sku: 'product_id',
      accessToken: 'your-oauth-token',  // From your backend
      packageName: 'com.your.app',
      purchaseToken: purchase.purchaseToken,
    ),
  );
  

New Features

• Billing Programs API (Android 8.2.0+): Support for external billing programs

  • isBillingProgramAvailableAndroid() - Check if a billing program is available
  • createBillingProgramReportingDetailsAndroid() - Get external transaction token for reporting
  • launchExternalLinkAndroid() - Launch external link for billing programs

  // Check availability
  final result = await iap.isBillingProgramAvailableAndroid(
    BillingProgramAndroid.ExternalOffer,
  );
  
  if (result.isAvailable) {
    // Launch external link
    await iap.launchExternalLinkAndroid(
      LaunchExternalLinkParamsAndroid(
        billingProgram: BillingProgramAndroid.ExternalOffer,
        launchMode: ExternalLinkLaunchModeAndroid.LaunchInExternalBrowserOrApp,
        linkType: ExternalLinkTypeAndroid.LinkToDigitalContentOffer,
        linkUri: 'https://your-payment-site.com/purchase',
      ),
    );
  
    // Get reporting token
    final details = await iap.createBillingProgramReportingDetailsAndroid(
      BillingProgramAndroid.ExternalOffer,
    );
    // Send details.externalTransactionToken to your server
  }
  

• One-Time Product Discounts (Android 8.0+): New fields in ProductAndroidOneTimePurchaseOfferDetail

  • offerId - Unique offer identifier
  • fullPriceMicros - Full (non-discounted) price
  • discountDisplayInfo - Discount percentage and amount
  • limitedQuantityInfo - Maximum and remaining quantity
  • validTimeWindow - Offer validity period
  • offerTags - List of offer tags
  • offerToken - Token for purchase requests
  • preorderDetailsAndroid - Pre-order release dates (Android 8.0+)
  • rentalDetailsAndroid - Rental period information (Android 8.0+)

• Purchase Suspension Status (Android 8.1.0+): New isSuspendedAndroid field in PurchaseAndroid

  • Check if a subscription is suspended due to payment issues
  • Do NOT grant entitlements for suspended subscriptions

  for (final purchase in purchases) {
    if (purchase is PurchaseAndroid && purchase.isSuspendedAndroid == true) {
      // Subscription suspended - do not grant access
      // Direct user to fix payment method
    }
  }
  

Deprecated

• checkAlternativeBillingAvailabilityAndroid() - Use isBillingProgramAvailableAndroid(BillingProgramAndroid.ExternalOffer) instead
• showAlternativeBillingDialogAndroid() - Use launchExternalLinkAndroid() instead
• createAlternativeBillingTokenAndroid() - Use createBillingProgramReportingDetailsAndroid(BillingProgramAndroid.ExternalOffer) instead

Fixes

• Web Build Error: Fixed dart:io import causing web build failures
  • Replaced dart:io Platform with defaultTargetPlatform from Flutter foundation
  • Added kIsWeb guards to prevent native API calls on web
  • Note: IAP functionality is still iOS/Android only; this fix only enables web compilation

Dependencies

• Updated OpenIAP versions:
  • openiap-apple: 1.3.0 → 1.3.5
  • openiap-google: 1.3.12 → 1.3.14
  • openiap-gql: 1.3.2 → 1.3.5

Migration Guide

See Migration from v7 for detailed upgrade instructions.

• feat: Add IapStore enum for unified store identification (apple, google, horizon, unknown)
• feat: Add store field to Purchase types (deprecates platform)
• feat: Support apple/google keys in request parameters (alongside legacy ios/android)
• chore(deps): Update OpenIAP versions (apple: 1.3.0, google: 1.3.10, gql: 1.3.0)

• feat: Add verifyPurchaseWithProvider for IAPKit integration
  • Supports server-side purchase verification via IAPKit
  • New VerificationMethod option: ignore, local, iapkit
  • New verification status error codes
• fix: Deep conversion of purchase maps to avoid _Map<Object?, Object?> cast errors on iOS 26
  • Fixes trial subscription purchase parsing failures
  • Uses existing normalizeDynamicMap for recursive map conversion
• chore(deps): Update openiap versions (apple: 1.2.42, google: 1.3.8, gql: 1.2.7)

• chore(deps): Update openiap-versions

  {
    "apple": "1.2.38"
  }
  

• chore(deps): Update openiap-versions

  {
    "google": "1.3.7",
    "apple": "1.2.38"
  }
  

• chore(deps): Update openiap-versions

  {
    "google": "1.3.6",
    "apple": "1.2.36"
  }
  

• feat: Add macOS platform support
  • Minimum deployment target: macOS 14.0
  • Shares StoreKit 2 implementation with iOS

• chore(deps): openiap-apple@1.2.34

• Update openiap-versions.

  {
    "gql": "1.2.5",
    "google": "1.3.5",
    "apple": "1.2.32"
  }
  

  • openiap-gql v1.2.5

• fix(android): Prevent incomplete product data on repeated fetchProducts calls
  • Fixed issue where displayPrice and other fields were missing on subsequent calls
  • ProductManager now validates cached data integrity before returning
  • Automatically re-queries products with incomplete cached data
  • openiap/pull/29

:::warning Migration Required for v7.1.14+ Due to product flavor support added in v7.1.13, apps using Google Play must add platform dimension configuration to avoid build errors. Add to android/app/build.gradle:

android {
    defaultConfig {
        missingDimensionStrategy 'platform', 'play'
    }
}

See Android Setup Guide for details. :::

• feat: Add Horizon OS support for Meta Quest devices
  • Added product flavor support for Meta Horizon billing (play/horizon flavors)
  • Integrated openiap-google-horizon dependency for Meta Quest Platform SDK
  • Added Horizon App ID configuration via gradle.properties and AndroidManifest.xml
  • Example app now supports both Google Play and Meta Horizon builds
  • Added comprehensive documentation for Horizon OS setup
  • Blog post: Horizon OS Support
  • Setup guide: Horizon OS
• BREAKING: Android apps must configure platform dimension
  • Due to product flavor support, apps must add missingDimensionStrategy 'platform', 'play' to their build.gradle
  • See Android Setup Guide for configuration details
• BREAKING: introductoryPricePaymentModeIOS is now required (non-nullable) in ProductSubscriptionIOS
  • Changed from PaymentModeIOS? to PaymentModeIOS (required field)
  • Default value is PaymentModeIOS.Empty when not provided
  • Update: Modified _parsePaymentMode helper to return PaymentModeIOS.Empty instead of null
  • Migration: Add introductoryPricePaymentModeIOS: PaymentModeIOS.Empty when creating ProductSubscriptionIOS instances manually

• Update openiap-versions.

  {
    "apple": "1.2.25",
    "google": "1.3.1",
    "gql": "1.2.2"
  }
  

  • openiap-apple v1.2.25
  • openiap-google v1.3.1

• fix: improve subscription state handling
  • openiap/pull/15

• fix: handle string timestamp in DiscountOfferInputIOS
  • openiap-apple/pull/26

• chore(deps): openiap-apple@1.2.18
  • openiap-apple pr#23

• fix(ios): corrected transactionReason detection for re-purchased subscriptions by upgrading openiap-apple to 1.2.18 - Fixed an issue where previously cancelled subscriptions that were purchased again were incorrectly marked as RENEWAL instead of PURCHASE. Now uses Apple's transactionReason from JSON representation for accurate transaction type detection.

• Accidental release with no changes.

• Resolve issue like react-native-iap issue #3054 by upgrading openiap-apple to 1.2.17.

• Fixed missing upgrade of openiap-apple module to 1.2.14 in the previous release.

• Updated openiap-apple to 1.2.14, improving promotional offer error messages.

• Upgrade openiap-apple module to 1.2.13.

• Upgrade openiap-apple module to 1.2.12.

• Breaking: fetchProducts() now returns Future<List<dynamic>> instead of specific typed lists
  • Requires explicit type annotation for proper type inference
  • Example: final List<Product> products = await iap.fetchProducts(skus: ['id'], type: ProductQueryType.InApp);
  • For subscriptions: final List<ProductSubscription> subscriptions = await iap.fetchProducts(skus: ['id'], type: ProductQueryType.Subs);
  • Simplifies API by removing the need for .value or .products getters
  • Fixes #576 - Type inference issues with FetchProductsResult

• Add missing isEligibleForIntroOfferIOS method (Fixes #574)

• Feature: Full Alternative Billing support for iOS and Android
  • iOS: External purchase links via presentExternalPurchaseLinkIOS()
  • Android: Alternative-Only and User-Choice billing modes
  • New event listener: userChoiceBillingAndroid for Android User Choice Billing
  • New APIs: checkAlternativeBillingAvailabilityAndroid(), showAlternativeBillingDialogAndroid(), createAlternativeBillingTokenAndroid()
• Breaking: Major API redesign with named parameters and record types
  • fetchProducts() now uses named parameters instead of ProductRequest object
  • getAvailablePurchases() now uses named parameters instead of PurchaseOptions object
  • finishTransaction() simplified to accept Purchase object directly
  • validateReceiptIOS(), deepLinkToSubscriptions() now use named parameters
  • RequestPurchaseProps.inApp() / .subs() factory methods removed (use constructor with type parameter)
• Breaking: Removed deprecated iOS-specific methods
  • getAvailableItemsIOS() - Use getAvailablePurchases() instead
  • getAppTransactionTypedIOS() - Use getAppTransactionIOS() instead
  • getPurchaseHistoriesIOS() - Use getAvailablePurchases() with options instead
• Improvement: Moved _buildIosPurchasePayload to public utils for better code organization
• 👉 Full release notes
• 👉 Migration guide

• Update OpenIAP google module to 1.2.10

• Update readme

• feat: fetchProducts with ProductQueryType.All #568

• fix(android): openiap module version path

• fix(ios): Resolve #567

• fix(ios): send error only once - prevent duplicate purchase error events on iOS
• chore(deps): openiap-google@1.2.7
• chore: refine error codes - improve error code mapping and remove message-based inference

Full Changelog: https://github.com/hyochan/flutter_inapp_purchase/compare/6.8.2...6.8.3

• fix: resolve type casting error with PurchaseOptions by @hyochan in https://github.com/hyochan/flutter_inapp_purchase/pull/565
• chore(android): refine openiap-versions.json search by @hyochan in https://github.com/hyochan/flutter_inapp_purchase/pull/566

Full Changelog: https://github.com/hyochan/flutter_inapp_purchase/compare/6.8.1...6.8.2

• chore(deps): openiap-apple@1.2.3 #562

• migrate Flutter In-App Purchase fully into the OpenIAP ecosystem, aligning with openiap-apple@1.2.2, openiap-google@1.2.6, and openiap-gql@1.0.8.
• update product and purchase APIs: use fetchProducts(ProductRequest(...)) with typed helpers and extend getAvailablePurchases() via PurchaseOptions; legacy getProducts, getSubscriptions, and getPurchaseHistories are removed.
• clarify identifiers by keeping native transaction IDs untouched and documenting purchaseToken as the canonical receipt for server validation.
• 👉 full release notes

• refactor: align openiap-gql@1.0.6
• migration: integrate openiap-google@1.1.12
• feat: purchase helper extensions; product prices now use displayPrice and transaction IDs shown only when available.
• refactor: api migrated to a generated, typed handler surface; purchase requests now use a single props object and result types simplified.
• docs: added conventions guide, multiple blog/FAQ updates, and CHANGELOG entry for 6.7.1.

• Follow-up fixes & refinements for 6.7.0

• fix(android): honor subscription offerToken
• refactor: align openiap-gql@1.0.2
• migration: integrate openiap-google@1.1.11
• migration: integrate openiap-apple@1.1.12

Fixed

• iOS: Ensure product.id is always populated in fetchProducts() (fixes cases where id was empty on iOS). The parser now resolves id from the first non-empty of: productId → id → sku → productIdentifier (#550). In debug builds, logs which key was used. withOpacity in example UI.
• refactor: remove overridden field in PurchaseIOS (use super.expirationDateIOS).
• refactor: locally suppress legacy jwsRepresentation mapping and deprecated requestPurchase calls kept for backward compatibility.

Changed

• Products API: id is the primary identifier for Product/ProductSubscription. productId is kept for backward compatibility only (see Deprecated).
• fetchProducts(): Adds support for type: 'all'.
  • iOS: passes 'all' through the native fetchProducts call
  • Android: fetches inapp and subs, then merges results
• productId on ProductCommon: Use id instead (will be removed in 6.6.0).
• Subscription type name: Use ProductSubscription instead (will be removed in 6.6.0). The alias keeps existing code working.
• Parser now emits ProductSubscription (alias of Subscription) for subscriptions internally.
• Docs/Examples: Completed migration from PurchasedItem → Purchase in current docs/examples.

Changed

• Android: Migrated native billing to openiap-google and simplified plugin with coroutines and connection gating.
• Android: Hardened null-safety and error logging; removed BuildConfig dependency in Amazon plugin.
• Dart: More robust product parsing (platform heuristics, per-item guards) and safer generics in fetchProducts.
• Example: Fixed sporadic setState after dispose by guarding mounted across async paths.

Added

• iOS mixin: Convenience helpers (subscription group, App Store country, available items, typed app transaction, purchase histories).

Tooling

• Pre-commit: Align dart format flags with CI and avoid staging untracked files.

Deprecated

• Methods (removal in 6.6.0):
  • fetchProducts() → use fetchProducts()
  • purchaseAsync() → use requestPurchase()
  • requestPurchaseAuto() → use requestPurchase()
  • finalize() → use endConnection()
  • deepLinkToSubscriptionsAndroid() → use platform UI links as documented
  • getPurchaseHistories() → use getAvailablePurchases(PurchaseOptions(onlyIncludeActiveItemsIOS: false))

Fixed

• iOS: Fix product/discount price parsing to tolerate numeric values (prevents type 'double' is not a subtype of type 'String?'), fixes #547.

Changed

• iOS: pin OpenIAP Apple native module to openiap 1.1.9 (exact version) to avoid unexpected CocoaPods minor updates.

Notes

• Recommend upgrading to 6.5.2. Prior 6.5.0–6.5.1 allowed older constraints; this release enforces exact 1.1.9 for stability. No breaking changes.

Changed

• iOS: bump OpenIAP Apple native module to openiap ~> 1.1.8 (no breaking changes)
• iOS: unified error helper to OpenIapError.defaultMessage (OpenIAP 1.1.8 consolidation)

Notes

• Example iOS Podfile pins tag 1.1.8; run cd example/ios && pod install to refresh lockfile.

Fixed

• iOS: Retrieve expired subscriptions in StoreKit 2 sandbox (#543)
  • Added PurchaseOptions parameter to getAvailablePurchases() for OpenIAP compliance
  • Use onlyIncludeActiveItemsIOS: false to include expired subscriptions

Deprecated

• getPurchaseHistories() → Use getAvailablePurchases() with options (removed in 6.6.0)

Changed

• BREAKING: Updated getAvailablePurchases() to support PurchaseOptions parameter (OpenIAP compliant)
  • Now accepts optional PurchaseOptions parameter for platform-specific configuration
  • iOS: Added onlyIncludeActiveItemsIOS option (default: true) to control whether expired subscriptions are included

Added

• Added PurchaseOptions class with iOS-specific options:
  • alsoPublishToEventListenerIOS: Whether to also publish purchase events to the event listener when fetching available purchases
  • onlyIncludeActiveItemsIOS: Whether to only include active items (set to false to get expired subscriptions)
• iOS: Added getPurchaseHistoriesIOS() platform-specific method that retrieves all transactions including expired subscriptions

Deprecated

• getPurchaseHistories() - Use getAvailablePurchases(PurchaseOptions(onlyIncludeActiveItemsIOS: false)) instead (will be removed in 6.6.0)

Bug Fixes

• iOS: Fixed missing transactionStateIOS field in getAvailableItems method (#538)
• iOS: Fixed expired subscriptions not being returned in purchase history (#543)
  • Added new iOS native method using Transaction.all instead of Transaction.currentEntitlements
  • This ensures all historical purchases including expired subscriptions are returned correctly

Bug Fixes

• Android: Fixed FormatException when calling finishTransaction (#539)

Bug Fixes

• iOS: Replace ISO8601DateFormatter with millisecond timestamps for date fields (#535)
  • Changed expirationDateIOS and revocationDateIOS to use millisecond timestamps
  • Added explicit Int64 casting for better type safety
  • Aligned with expo-iap implementation for consistency
  • Improved Dart type safety for date parsing with safe num to int conversion

Bug Fixes

• Android: Fixed subscriptionOfferDetailsAndroid field returning null (Fixes #534)
  • Added proper parsing for subscriptionOfferDetailsAndroid in subscription products
  • Removed parsing of deprecated subscriptionOfferDetails field
  • Fixed Map type casting issues that could cause runtime errors with Map<dynamic, dynamic> inputs

Improvements

• Type Safety: Improved type safety for JSON parsing across the codebase
  • Added safe JSON map conversion helper to prevent type casting errors
  • Fixed all unsafe as Map<String, dynamic> casts in types.dart
  • Ensures robust handling of platform channel data

Improvements

• ActiveSubscription Type: Implemented a dedicated ActiveSubscription type for subscription APIs to provide better type safety and clearer subscription status information (#532)
  • getActiveSubscriptions() now returns List<ActiveSubscription> instead of List<SubscriptionPurchase>
  • New type includes subscription-specific fields like willExpireSoon and daysUntilExpirationIOS
  • Automatically calculates expiration status for iOS subscriptions
  • Provides cleaner API with subscription-focused properties

Breaking Changes

• Simplified fetchProducts API: The fetchProducts method now accepts direct parameters instead of a wrapper object (Fixes #527)

  // Before (6.3.x)
  final products = await iap.fetchProducts(
    RequestProductsParams(
      skus: ['product_id'],
      type: PurchaseType.inapp,
    ),
  );
  
  // After (6.4.0)
  final products = await iap.fetchProducts(
    skus: ['product_id'],
    type: PurchaseType.inapp,  // Optional, defaults to PurchaseType.inapp
  );
  

  • Removed RequestProductsParams class
  • This change simplifies the API and improves developer experience based on user feedback

New Features

• DSL-like Builder Pattern for Purchase Requests: Added a builder pattern API for more intuitive and type-safe purchase request construction

  // New builder pattern approach
  await iap.requestPurchaseWithBuilder(
    build: (r) => r
      ..type = PurchaseType.inapp
      ..withIOS((i) => i
        ..sku = 'product_id'
        ..quantity = 1)
      ..withAndroid((a) => a
        ..skus = ['product_id']),
  );
  

  • Provides better type safety with platform-specific configurations
  • Supports cascade notation for cleaner code
  • Separate builders for iOS and Android parameters
  • Available for both purchases and subscriptions

Improvements

• Replaced magic numbers with enums: Android purchase states now use AndroidPurchaseState enum instead of hardcoded values (0, 1, 2)
  • Better code readability and maintainability
  • Type-safe state checking

Deprecated Items Removed

The following deprecated items from v6.3.x have been removed in v6.4.0:

• subscriptionOfferDetails field (use subscriptionOfferDetailsAndroid instead)
• prorationMode field (use replacementModeAndroid instead)
• AndroidProrationMode typedef (use AndroidReplacementMode instead)

Note to Users

We understand there have been several breaking changes recently. We sincerely apologize for any inconvenience. These changes are part of our effort to quickly address the long maintenance gap and bring the library up to modern standards. With version 6.4.0, we believe the major restructuring is now complete, and the API should remain stable going forward.

Bug Fixes

• Android Type Mapping: Fixed Android-specific field mappings to match TypeScript/OpenIAP specifications
  • Fixed Product parsing for nameAndroid and oneTimePurchaseOfferDetailsAndroid fields
  • Fixed Purchase dataAndroid field mapping from native Android data
  • Added proper platform checks for Android/iOS specific fields in toJson output
  • Fixed subscription offer details structure to handle nested pricingPhases
  • Fixed PricingPhase parsing for Android field names (formattedPrice, priceCurrencyCode, priceAmountMicros)

Code Quality

• Platform-Specific Field Segregation: Enhanced platform checks across all type classes
  • Added _platform.isAndroid and _platform.isIOS conditions for platform-specific fields
  • Android-specific fields now only appear on Android platform
  • iOS-specific fields now only appear on iOS platform
  • Added comprehensive TODO comments for v6.4.0 deprecation cleanup

Documentation

• Release Notes: Added proper version planning comments for deprecated field removal in v6.4.0

Bug Fixes

• iOS Purchase State Detection: Enhanced purchase state detection for iOS
  • Fixed UI getting stuck in "Processing..." state when transactionStateIOS is null
  • Now properly detects successful purchases using multiple conditions (state, token, transaction ID)
  • Added duplicate transaction tracking to prevent double processing
• Timeout Error Handling: Improved error handling for store server timeouts
  • Added specific handling for Korean timeout message "요청한 시간이 초과되었습니다"
  • Provides user-friendly troubleshooting steps for network issues
• Security: Enhanced security for sensitive data logging
  • Purchase tokens are now masked in debug logs (showing only last 4 characters)
  • All sensitive logging is properly gated behind kDebugMode flag

Documentation

• Added comprehensive iOS purchase state detection guide
• Enhanced troubleshooting documentation with iOS-specific solutions

Bug Fixes

• Android Subscription Loading: Fixed type casting error when loading subscriptions
  • Fixed _Map<String, dynamic> type casting issue that prevented subscriptions from loading
  • Improved handling of pricing phases data structure from Android
  • Fixed parsing of subscription offer details from nested JSON structure
• Test Product Cleanup: Removed deprecated android.test.purchased test product ID
  • This test ID is no longer valid in Google Play Billing Library 6+
• Type Safety: Improved type handling for Map conversions from native platforms
  • Better handling of different Map implementations from iOS and Android

Bug Fixes

• CRITICAL FIX: Android Purchase State Mapping: Fixed incorrect mapping of Android purchase states (#524)
  • Previously mapped: 0=PURCHASED, 1=PENDING (incorrect)
  • Now correctly maps: 0=UNSPECIFIED_STATE, 1=PURCHASED, 2=PENDING
  • This fix aligns with official Google Play Billing documentation
  • Prevents misinterpreting UNSPECIFIED_STATE as a completed purchase
  • UNSPECIFIED_STATE (0) and unknown states now properly map to PurchaseState.unspecified

Features

• Enhanced OpenIAP Compliance: Extended OpenIAP specification support with comprehensive field mapping

  • Added full iOS-specific field support: displayName, displayPrice, isFamilyShareable, jsonRepresentation, discountsIOS, subscription info, and promotional offer fields
  • Added comprehensive Android-specific field support: originalPrice, originalPriceAmount, freeTrialPeriod, subscriptionOffersAndroid, and billing cycle information
  • Enhanced Purchase object with StoreKit 2 fields: verificationResultIOS, environmentIOS, expirationDateIOS, revocationDateIOS, and transaction metadata

• Improved Test Organization: Restructured test suite by business flows

  • Purchase Flow Tests: General purchase operations and error handling
  • Subscription Flow Tests: Subscription-specific operations and lifecycle management
  • Available Purchases Tests: Purchase history, restoration, and transaction management
  • Enhanced test coverage from 26% to 28.2%

Improvements

• Type Safety: Enhanced type casting and JSON parsing reliability

  • Fixed Map<Object?, Object?> to Map<String, dynamic> conversion issues
  • Improved null safety handling for platform-specific fields
  • Better error handling for malformed data

• Subscription Management: Enhanced active subscription detection

  • Improved iOS subscription detection logic for better reliability
  • Added fallback logic for subscription identification across platforms

• Code Quality: Comprehensive test suite improvements

  • All 95 tests now pass consistently
  • Flexible test assertions that adapt to mock data variations
  • Better separation of platform-specific test scenarios

Bug Fixes

• Critical Fix: Fixed iOS subscription loading issue where fetchProducts with PurchaseType.subs returned empty arrays
  • iOS now correctly uses getItems method instead of unsupported getSubscriptions
  • Resolves GitHub issues where users couldn't load subscription products on iOS
• Fixed type casting errors in purchase data conversion
• Fixed subscription detection on iOS platform
• Fixed Android purchase state mapping in active subscription queries
• Resolved null reference exceptions for platform-specific fields
• Fixed test expectations to match actual implementation behavior

Technical Improvements

• Enhanced mock data consistency across test files
• Improved JSON serialization/deserialization robustness
• Better error messages and debugging information
• Standardized field naming conventions following OpenIAP specification

Breaking Changes

None - This version maintains full backward compatibility while extending functionality.

Features

• OpenIAP Compliance: Added id field to Purchase class for standardized transaction identification
• Unified Purchase Token: Added purchaseToken field for cross-platform server validation
  • iOS: Contains JWS representation for App Store validation
  • Android: Contains purchase token for Google Play validation
  • Deprecated platform-specific token fields in favor of unified approach

Improvements

• Transaction Management: finishTransaction now accepts Purchase objects directly
• iOS StoreKit 2: Complete implementation with improved transaction handling
• Date Handling: Fixed date parsing issues across platforms
• Error Handling: Enhanced error reporting and duplicate event prevention

Bug Fixes

• Fixed missing transactionId and id fields in Android purchase responses
• Fixed iOS transaction finishing with proper ID lookup
• Fixed date conversion issues in Purchase.fromJson()

Breaking Changes

None - This version maintains backward compatibility.

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