react-native-iap

React Native IAP provides different API surfaces depending on the platform to handle subscription validation.

• getAvailablePurchases: Fetches active entitlement records. On iOS, it wraps StoreKit 2 Transaction.currentEntitlements. On Android, it merges inapp and subs queries from Google Play Billing.
• getActiveSubscriptions: A specialized version of getAvailablePurchases that filters for subscriptions and adds convenience fields like expirationDateIOS or willExpireSoon (Android).
• subscriptionStatusIOS: Provides fine-grained phase data (e.g., inTrialPeriod, inGracePeriod) on iOS via StoreKit 2. Not available on Android; Android users must pair getAvailablePurchases with the Play Developer API for phase data.
• Receipt Validation: Use getReceiptDataIOS or validateReceipt (iOS) for App Store receipts/JWS. For Android, validateReceipt forwards to the OpenIAP Google Play validator using purchaseToken and packageName.

To use react-native-iap on Meta Quest devices running Horizon OS, you must configure the library to use Meta's Platform SDK instead of Google Play Billing. This requires enabling Horizon mode in Gradle and providing your Horizon App ID in the Android manifest.

Prerequisites

• Meta Quest Developer account
• App created in Meta Quest Developer Hub
• Quest device or Quest Link for testing

1. Enable Horizon Mode

Add the following line to your android/gradle.properties file:

2. Add Horizon App ID

Add the following <meta-data> tag inside the <application> block of your android/app/src/main/AndroidManifest.xml. Replace YOUR_HORIZON_APP_ID with the ID from the Meta Quest Developer Hub.

3. Clean and Rebuild

After making these changes, you must clean the build to ensure the correct artifacts are used:

Note on Code Integration

Code integration is identical to standard Android integration. You can use the useIAP hook and standard API methods without modification; react-native-iap handles the platform differences automatically.

# android/gradle.properties
horizonEnabled=true

<!-- android/app/src/main/AndroidManifest.xml -->
<application>
  <!-- Meta Horizon App ID (required for Horizon OS) -->
  <meta-data
    android:name="com.meta.horizon.platform.ovr.OCULUS_APP_ID"
    android:value="YOUR_HORIZON_APP_ID" />
</application>

cd android
./gradlew clean
cd ..
npx react-native run-android

Android supports two modes: alternative-only (exclusive use of your payment system) and user-choice (users choose between Google Play and your system).

Follow this three-step flow:

1. Check availability using checkAlternativeBillingAvailabilityAndroid().
2. Show the selection dialog using showAlternativeBillingDialogAndroid().
3. Create a reporting token using createAlternativeBillingTokenAndroid(productId) to ensure Google Play compliance (must be reported within 24 hours).

Use userChoiceBillingListenerAndroid to listen for user selection events.

import {
  initConnection,
  checkAlternativeBillingAvailabilityAndroid,
  showAlternativeBillingDialogAndroid,
  createAlternativeBillingTokenAndroid,
  userChoiceBillingListenerAndroid,
} from 'react-native-iap';

// Initialize with alternative billing mode
await initConnection({
  alternativeBillingModeAndroid: 'alternative-only', // or 'user-choice'
});

// 3-step alternative billing flow
const isAvailable = await checkAlternativeBillingAvailabilityAndroid();
const userAccepted = await showAlternativeBillingDialogAndroid();
const token = await createAlternativeBillingTokenAndroid(productId);

// User choice billing event listener
const subscription = userChoiceBillingListenerAndroid((details) => {
  console.log('User selected alternative billing');
  // Report to backend for Google Play compliance
});