Available Purchases

Front End System Design Guidebook

This guide demonstrates how to list and restore previously purchased items (non‑consumables and active subscriptions) using getAvailablePurchases() and getActiveSubscriptions().

tip

The complete working example can be found at example/screens/AvailablePurchases.tsx.

Note that the example code was heavily vibe-coded with Claude and is quite verbose/messy for demonstration purposes - use it as a reference only.

Restore Flow

• Ensure the store connection is active (handled by useIAP)
• Call both getAvailablePurchases() and getActiveSubscriptions()
• Validate on your server and grant entitlements

import React from 'react';
import {Alert} from 'react-native';
import {useIAP} from 'react-native-iap';

export default function AvailablePurchasesScreen() {
  const {
    connected,
    getAvailablePurchases,
    getActiveSubscriptions,
    activeSubscriptions,
    finishTransaction,
  } = useIAP();

  const restore = async () => {
    if (!connected) return;
    const [purchases] = await Promise.all([
      getAvailablePurchases(),
      getActiveSubscriptions(),
    ]);

    for (const p of purchases) {
      // TODO: validate on your backend first
      // await grantEntitlement(p)
      // Non-consumables and subscriptions typically don't require consumption
      await finishTransaction({purchase: p, isConsumable: false});
    }

    Alert.alert('Restored', `Restored ${purchases.length} purchases`);
  };

  return null; // Render your UI and call restore() from a button
}

Showing Active Subscriptions

The hook exposes activeSubscriptions, which you can render directly after calling getActiveSubscriptions():

import {useEffect} from 'react';
import {View, Text} from 'react-native';
import {useIAP} from 'react-native-iap';

function ActiveSubscriptionsList() {
  const {activeSubscriptions, getActiveSubscriptions} = useIAP();

  useEffect(() => {
    getActiveSubscriptions();
  }, [getActiveSubscriptions]);

  return (
    <View>
      {activeSubscriptions.map((s) => (
        <Text key={s.productId}>{s.productId}</Text>
      ))}
    </View>
  );
}

Tips

• Only non‑consumables and subscriptions are returned; consumables are not restorable
• Always perform server‑side validation before granting access
• On iOS, you can optionally filter for active items using onlyIncludeActiveItemsIOS
• Android tip: If users redeem a promo code in Google Play, open https://play.google.com/redeem with Linking.openURL(...) and then refresh with getAvailablePurchases() and getActiveSubscriptions()