Skip to main content
Version: 6.7

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<FetchProductsResult> fetchProducts(ProductRequest params)

Parameters​

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

Return Value​

The method resolves to a FetchProductsResult sealed type:

  • FetchProductsResultProducts – wraps a List<Product> when querying in-app items
  • FetchProductsResultSubscriptions – wraps a List<ProductSubscription> when querying subscriptions

Use the helper extensions from package:flutter_inapp_purchase/flutter_inapp_purchase.dart (result.inAppProducts(), result.subscriptionProducts(), result.allProducts()) to convert the union into strongly typed lists.

Usage Examples​

Fetch in-app products​

final result = await FlutterInappPurchase.instance.fetchProducts(
  ProductRequest(
    skus: ['coins_100', 'remove_ads'],
    type: ProductQueryType.InApp,
  ),
);

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

Fetch subscriptions​

final result = await FlutterInappPurchase.instance.fetchProducts(
  ProductRequest(
    skus: ['premium_monthly', 'premium_yearly'],
    type: ProductQueryType.Subs,
  ),
);

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

Fetch both types​

Future<void> loadCatalog() async {
  final inApps = await FlutterInappPurchase.instance.fetchProducts(
    ProductRequest(skus: ['coins_100', 'remove_ads'], type: ProductQueryType.InApp),
  );
  final subs = await FlutterInappPurchase.instance.fetchProducts(
    ProductRequest(skus: ['premium_monthly'], type: ProductQueryType.Subs),
  );

  final allProducts = [
    ...inApps.allProducts(),
    ...subs.allProducts(),
  ];

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

Error Handling​

try {
  final result = await FlutterInappPurchase.instance.fetchProducts(
    ProductRequest(skus: productIds, type: ProductQueryType.InApp),
  );

  final products = result.inAppProducts();
  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​

  • Replace requestProducts() calls with fetchProducts(ProductRequest(...))
  • Convert the returned FetchProductsResult using inAppProducts(), subscriptionProducts(), or allProducts() depending on the query type
  • Replace any legacy product-loading helpers in your codebase with fetchProducts()

See Also​