Skip to main content
Version: 14.1 (Current)

Error Codes

React Native IAP uses standardized error codes that conform to the OpenIAP specification.

OpenIAP Error Documentation​

For comprehensive error code definitions, error handling patterns, and platform-specific error mappings, please refer to:

👉 OpenIAP Error Documentation

Basic Usage Example​

import {useIAP, ErrorCode, PurchaseError} from 'react-native-iap';

const {requestPurchase} = useIAP({
  onPurchaseError: (error: PurchaseError) => {
    console.log('Error details:', {
      code: error.code,
      message: error.message,
      platform: error.platform,
    });

    switch (error.code) {
      case ErrorCode.E_USER_CANCELLED:
        // Don't show error for user cancellation
        break;
      case ErrorCode.E_NETWORK_ERROR:
        Alert.alert('Network Error', 'Please check your internet connection');
        break;
      case ErrorCode.E_ITEM_UNAVAILABLE:
        Alert.alert('Item Unavailable', 'This item is not available');
        break;
      case ErrorCode.E_ALREADY_OWNED:
        Alert.alert('Already Owned', 'You already own this item');
        break;
      case ErrorCode.E_DEVELOPER_ERROR:
        Alert.alert('Configuration Error', 'Please contact support');
        break;
      default:
        Alert.alert('Purchase Failed', error.message);
    }
  },
});

Advanced Error Handling with Retry​

const handlePurchaseWithRetry = async (productId: string, retryCount = 0) => {
  const MAX_RETRIES = 2;

  try {
    await requestPurchase({
      request: {
        ios: {sku: productId},
        android: {skus: [productId]},
      },
    });
  } catch (error: any) {
    const purchaseError = error as PurchaseError;

    // Determine if we should retry
    const retryableErrors = [
      ErrorCode.E_NETWORK_ERROR,
      ErrorCode.E_SERVICE_ERROR,
      ErrorCode.E_INTERRUPTED,
    ];

    const shouldRetry =
      retryableErrors.includes(purchaseError.code!) && retryCount < MAX_RETRIES;

    if (shouldRetry) {
      console.log(`Retrying purchase (${retryCount + 1}/${MAX_RETRIES})`);
      setTimeout(
        () => {
          handlePurchaseWithRetry(productId, retryCount + 1);
        },
        1000 * Math.pow(2, retryCount),
      ); // Exponential backoff
    } else {
      handlePurchaseError(purchaseError);
    }
  }
};

Platform-Specific Error Handling​

const handlePlatformSpecificError = (error: PurchaseError) => {
  if (Platform.OS === 'ios') {
    switch (error.code) {
      case ErrorCode.E_DEFERRED_PAYMENT:
        // iOS-specific: Parental approval required
        Alert.alert('Approval Required', 'This purchase requires approval');
        break;
      case ErrorCode.E_TRANSACTION_VALIDATION_FAILED:
        // iOS-specific: StoreKit validation failed
        Alert.alert('Validation Failed', 'Transaction could not be validated');
        break;
    }
  } else if (Platform.OS === 'android') {
    switch (error.code) {
      case ErrorCode.E_BILLING_RESPONSE_JSON_PARSE_ERROR:
        // Android-specific: Billing response parse error
        Alert.alert('Error', 'Failed to process purchase response');
        break;
      case ErrorCode.E_PENDING:
        // Android-specific: Purchase is pending
        Alert.alert('Purchase Pending', 'Your purchase is being processed');
        break;
    }
  }
};

Error Logging​

const logError = (error: PurchaseError) => {
  // Log to analytics service
  analytics.track('purchase_error', {
    error_code: error.code,
    platform: error.platform,
    product_id: error.productId,
    message: error.message,
  });

  // Log to crash reporting
  if (error.code !== ErrorCode.E_USER_CANCELLED) {
    crashlytics.recordError(error);
  }
};

See Also​