Skip to main content
Version: 7.1 (Current)

fetchProducts()

fetchProducts() is the unified way to load in-app products or subscriptions from the store, consolidating the legacy helpers into a single API.

Signature​

Future<List<T>> fetchProducts<T extends ProductCommon>({
  required List<String> skus,
  ProductQueryType type = ProductQueryType.InApp,
})

Parameters​

ParameterTypeRequiredDescription
skusList<String>✅Store identifiers to query (Google Play product IDs / App Store product identifiers)
typeProductQueryType❌ProductQueryType.InApp (default), ProductQueryType.Subs, or ProductQueryType.All

Return Value​

Returns a typed list based on the generic type parameter:

  • InApp: Use <Product> type parameter
  • Subs: Use <ProductSubscription> type parameter
  • All: Use <ProductCommon> type parameter

Usage Examples​

Fetch in-app products​

// Use explicit type parameter
final products = await FlutterInappPurchase.instance.fetchProducts<Product>(
  skus: ['coins_100', 'remove_ads'],
  type: ProductQueryType.InApp,
);

for (final product in products) {
  print('${product.title}: ${product.displayPrice}');
}

Fetch subscriptions​

// Use explicit type parameter
final subscriptions =
    await FlutterInappPurchase.instance.fetchProducts<ProductSubscription>(
  skus: ['premium_monthly', 'premium_yearly'],
  type: ProductQueryType.Subs,
);

for (final sub in subscriptions) {
  print('${sub.title}: ${sub.displayPrice}');
  print('Period: ${sub.subscriptionPeriodUnitIOS ?? sub.subscriptionInfoAndroid?.billingPeriod}');
}

Fetch both types​

Future<void> loadCatalog() async {
  // Use explicit type parameter
  final inAppProducts =
      await FlutterInappPurchase.instance.fetchProducts<Product>(
    skus: ['coins_100', 'remove_ads'],
    type: ProductQueryType.InApp,
  );

  final subscriptions =
      await FlutterInappPurchase.instance.fetchProducts<ProductSubscription>(
    skus: ['premium_monthly'],
    type: ProductQueryType.Subs,
  );

  // Combine into a single list if needed
  final List<ProductCommon> allProducts = [
    ...inAppProducts,
    ...subscriptions,
  ];

  for (final item in allProducts) {
    debugPrint('Loaded ${item.id} (${item.displayPrice})');
  }
}

Fetch all products at once​

// Query all products together
final allProducts =
    await FlutterInappPurchase.instance.fetchProducts<ProductCommon>(
  skus: ['coins_100', 'remove_ads', 'premium_monthly'],
  type: ProductQueryType.All,
);

for (final item in allProducts) {
  debugPrint('Loaded ${item.id} (${item.displayPrice})');
}

Error Handling​

try {
  final products =
      await FlutterInappPurchase.instance.fetchProducts<Product>(
    skus: productIds,
    type: ProductQueryType.InApp,
  );

  if (products.isEmpty) {
    debugPrint('No products returned for: $productIds');
  }
} on PurchaseError catch (error) {
  switch (error.code) {
    case ErrorCode.NotPrepared:
      debugPrint('Call initConnection() before fetching products');
      break;
    case ErrorCode.NetworkError:
      debugPrint('Network error – prompt the user to retry');
      break;
    default:
      debugPrint('Unexpected store error: ${error.message}');
  }
}

Platform Notes​

iOS​

  • Products must be visible in App Store Connect (Ready for Sale or Approved)
  • The bundle identifier must match the app querying the products
  • StoreKit 2 caching means results may be served from a local cache on subsequent calls

Android​

  • Products must be active in Google Play Console (Internal Testing track or above)
  • Billing client v8 requires the app to be signed with a certificate added to Play Console
  • Only SKUs that belong to the current package can be queried

Migration Notes​

From v6.x to v7.0​

The API now uses generic type parameters for type-safe product fetching:

// Before (v6.x)
final result = await iap.fetchProducts(
  ProductRequest(
    skus: ['product_id'],
    type: ProductQueryType.InApp,
  ),
);
final products = result.value; // or result.products

// After (v7.0) - Use explicit type parameter
final products = await iap.fetchProducts<Product>(
  skus: ['product_id'],
  type: ProductQueryType.InApp,
);

// For subscriptions
final subscriptions = await iap.fetchProducts<ProductSubscription>(
  skus: ['sub_id'],
  type: ProductQueryType.Subs,
);

Key Changes​

  • No more .value or .products getters - The method returns the list directly
  • Generic type parameter - Use <Product>, <ProductSubscription>, or <ProductCommon>
  • Simplified API - Direct iteration without unwrapping union types

See Also​