Skip to main content
Version: 14.4

Purchase Flow

GreatFrontEnd
tip

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

Flow Overview​

Connect → Fetch Products → Request Purchase → Server Validate → Finish Transaction

Quick Start with useIAP​

const {connected, products, fetchProducts, requestPurchase, finishTransaction} =
  useIAP({
    onPurchaseSuccess: async (purchase) => {
      // Validate on your server, then finish
      await finishTransaction({purchase, isConsumable: true});
    },
    onPurchaseError: (error) => {
      if (error.code !== ErrorCode.UserCancelled) {
        Alert.alert('Error', error.message);
      }
    },
  });

// Load products
await fetchProducts({skus: ['product_id'], type: 'in-app'});

// Purchase
await requestPurchase({
  request: {
    ios: {sku: 'product_id'},
    android: {skus: ['product_id']},
  },
  type: 'in-app',
});

Key Points​

  • Connection: useIAP automatically manages connection lifecycle
  • Platform differences: iOS takes single sku, Android takes skus array
  • Validation: Always validate receipts on your server before finishing
  • Finish transaction: Call finishTransaction() after validation to prevent replay

IAPKit Server Verification​

IAPKit provides server-side receipt verification without your own infrastructure.

Setup​

  1. Get your API key from IAPKit Dashboard
  2. Add environment variable: 
    EXPO_PUBLIC_IAPKIT_API_KEY=your_api_key_here

Usage​

import {verifyPurchaseWithProvider} from 'react-native-iap';

const verifyPurchase = async (purchase: Purchase) => {
  const result = await verifyPurchaseWithProvider({
    provider: 'iapkit',
    iapkit: {
      apiKey: process.env.EXPO_PUBLIC_IAPKIT_API_KEY!,
      apple: {jws: purchase.purchaseToken!},
      google: {purchaseToken: purchase.purchaseToken!},
    },
  });

  if (result.iapkit.isValid) {
    // Grant entitlement to user
    await finishTransaction({purchase, isConsumable: true});
  }
};

With useIAP Hook​

const {finishTransaction} = useIAP({
  onPurchaseSuccess: async (purchase) => {
    const result = await verifyPurchaseWithProvider({
      provider: 'iapkit',
      iapkit: {
        apiKey: process.env.EXPO_PUBLIC_IAPKIT_API_KEY!,
        apple: {jws: purchase.purchaseToken!},
        google: {purchaseToken: purchase.purchaseToken!},
      },
    });

    if (result.iapkit.isValid) {
      await finishTransaction({purchase, isConsumable: true});
    }
  },
});

Verification Response​

IAPKit returns a standardized response:

interface IapkitVerificationResult {
  isValid: boolean;
  state: IapkitPurchaseState;
  store: 'apple' | 'google';
}

type IapkitPurchaseState =
  | 'entitled'
  | 'pending-acknowledgment'
  | 'pending'
  | 'canceled'
  | 'expired'
  | 'ready-to-consume'
  | 'consumed'
  | 'unknown'
  | 'inauthentic';

Verification Methods​

MethodDescriptionUse Case
None (Skip)Skip verificationTesting/Development
Local (Device)Verify with Apple/Google directlySimple validation
IAPKit (Server)Server-side verification via IAPKitProduction recommended

Testing​

The example app has built-in IAPKit support. Set your API key and use the "Purchase Verification" button to test.

For more information, visit IAPKit Documentation.

Resources​