React Native IAP

React Native IAP is a high-performance in-app purchase library using Nitro Modules that conforms to the Open IAP specification. It provides a unified API for handling in-app purchases across iOS and Android platforms with comprehensive error handling and modern TypeScript support.

📚 Documentation

📖 Visit our comprehensive documentation site →

⚠️ Notice

Starting from version 14.0.0, this library uses Nitro Modules for high-performance native bridge implementation. You must install react-native-nitro-modules alongside react-native-iap.

Compatibility (Nitro 14.x)

• [email protected] (Nitro) requires React Native 0.79+.
• Stuck on RN 0.75.x or lower? Use the last pre‑Nitro version: npm i [email protected].
• Seeing Swift 6 C++ interop errors in Nitro (e.g., AnyMap.swift with cppPart.pointee.*)? Temporarily pin Swift to 5.10 for the NitroModules pod (see Installation docs) or upgrade RN and Nitro deps.
• Recommended: upgrade to RN 0.79+, update react-native-nitro-modules/nitro-codegen, then pod install and clean build.

More details and the Podfile snippet are in the docs: https://openiap.dev/docs/setup/react-native#ios

✨ Features

• 🔄 Cross-platform Support: Works seamlessly on both iOS and Android
• ⚡ Nitro Modules: High-performance native bridge with minimal overhead
• 🎯 TypeScript First: Full TypeScript support with comprehensive type definitions
• 🛡️ Centralized Error Handling: Unified error management with platform-specific error code mapping
• 🎣 React Hooks: Modern React hooks API with useIAP
• 📱 React Native Focused: Use expo-iap for Expo projects
• 🔍 Receipt Validation: Built-in receipt validation for both platforms
• 💎 Products & Subscriptions: Support for both one-time purchases and subscriptions
• 🚀 Performance Optimized: Efficient caching and minimal re-renders

🚀 Quick Start

npm install react-native-iap react-native-nitro-modules
# or
yarn add react-native-iap react-native-nitro-modules

📖 See the complete installation guide and quick start tutorial →

🏗️ Architecture

React Native IAP is built with a modern architecture that emphasizes:

• Nitro Modules: High-performance native bridge with C++ core and platform-specific implementations
• Type Safety: Comprehensive TypeScript definitions for all APIs
• Error Resilience: Centralized error handling with meaningful error codes
• Platform Abstraction: Unified API that handles platform differences internally
• Performance: Optimized for minimal bundle size and runtime performance

📱 Platform Support

| Platform | Support | Notes | | ----------------- | ------- | -------------------------------- | | iOS | ✅ | StoreKit 2 (requires iOS 15+) | | Android | ✅ | Google Play Billing v9.1.0 | | Expo Go | ❌ | Use expo-iap for Expo projects | | Expo Dev Client | ❌ | Use expo-iap for Expo projects | | Bare React Native | ✅ | Full support |

📦 Installation & Configuration

Prerequisites

Before installing React Native IAP, make sure you have:

• React Native 0.79 or later
• Node.js 18 or later (and any higher minimum required by your React Native version)
• iOS 15+ for iOS apps (StoreKit 2 requirement)
• Android API level 23+ for the library (and any higher minimum required by React Native)
• Kotlin 2.1.20 or later for Android builds

Post Installation

Android Configuration

Kotlin compatibility: React Native IAP uses the Kotlin and Android Gradle Plugin versions supplied by the host React Native project. Published OpenIAP Android artifacts are validated against Kotlin 2.1.20, while the standalone source-build fallback is Kotlin 2.2.0. React Native 0.79 projects that still use Kotlin 2.0.21 must upgrade their Android Kotlin plugin; newer React Native releases should keep their supplied compiler version.

iOS Configuration

1. Install pods:

   cd ios && pod install

2. Add StoreKit capability to your iOS app in Xcode:

   • Open your project in Xcode
   • Select your app target
   • Go to "Signing & Capabilities"
   • Click "+ Capability" and add "In-App Purchase"

Expo Projects

Use expo-iap for Expo apps. This package targets bare React Native/Nitro projects.

Store Configuration

React Native IAP is OpenIAP compliant. For detailed store configuration:

• iOS Setup → - App Store Connect configuration
• Android Setup → - Google Play Console configuration

🤖 Using with AI Assistants

React Native IAP provides AI-friendly documentation for Cursor, GitHub Copilot, Claude, and ChatGPT.

📖 AI Assistants Guide →

Quick links:

• llms.txt - Quick reference
• llms-full.txt - Full API reference

🎯 What's Next?

📖 Visit our comprehensive documentation site →

Key Resources

• Installation & Quick Start - Get started in minutes
• API Reference - Complete useIAP hook documentation
• Examples - Production-ready implementations
• Error Handling - OpenIAP compliant error codes
• Troubleshooting - Common issues and solutions

Powered by OpenIAP

React Native IAP conforms to the OpenIAP specification — an open, vendor-neutral interoperability standard for in-app purchases. OpenIAP provides:

• Shared specification — Common types, error codes, and purchase flows across all platforms
• Generated type-safe bindings — Swift, Kotlin, TypeScript, Dart, C#, and GDScript from a single GraphQL schema
• Platform implementations — openiap-apple (StoreKit 2) and openiap-google (Play Billing 9.1.0)
• Verification profiles — Standardized receipt validation and purchase verification patterns

Other libraries built on OpenIAP: expo-iap · flutter_inapp_purchase · kmp-iap · maui-iap · godot-iap

Learn more about the OpenIAP standard →

Sponsors

💼 View Our Sponsors

Angel

Past Supporters

Support this project by becoming a sponsor. Your logo will show up here with a link to your website. Buy me a coffee.

OpenCollective Sponsorship

We also recognize sponsors and backers through OpenCollective. The original react-native-iap collective now supports the broader OpenIAP ecosystem and is managed separately from our main sponsor program.

Sponsors:

Backers:

Become a sponsor | Become a backer

Community

Have a question or need help? Ask in react-native-iap Q&A Discussions.

For bug reports, please open an issue.

Contributing

Thank you to everyone who contributed to hyochan/react-native-iap, the community where OpenIAP began.

See our Contributing Guide for development setup and guidelines.