⚠️ This repository has moved to the OpenIAP monorepo. This repository is deprecated and will be archived soon. All future development happens in the monorepo. Please see the announcement for details.
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.
Compile-time CSS-in-JS for React Native
✨ Banishing runtime overhead, one style at a time with kstyled - fully type-safe styling that compiles away.
📖 Visit our comprehensive documentation site →
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.
react-native-iap@14.x(Nitro) requires React Native 0.79+.- Stuck on RN 0.75.x or lower? Use the last pre‑Nitro version:
npm i react-native-iap@13.1.0. - Seeing Swift 6 C++ interop errors in Nitro (e.g.,
AnyMap.swiftwithcppPart.pointee.*)? Temporarily pin Swift to 5.10 for theNitroModulespod (see Installation docs) or upgrade RN and Nitro deps. - Recommended: upgrade to RN 0.79+, update
react-native-nitro-modules/nitro-codegen, thenpod installand clean build.
More details and the Podfile snippet are in the docs: https://hyochan.github.io/react-native-iap/docs/installation#ios
- 🔄 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 - 📱 Expo Compatible: Works with Expo development builds
- 🔍 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
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 →
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 | Notes |
|---|---|---|
| iOS | ✅ | StoreKit 2 (requires iOS 15+) |
| Android | ✅ | Google Play Billing v8.0.0+ |
| Expo Go | ❌ | Not supported (requires native modules) |
| Expo Dev Client | ✅ | Full support |
| Bare React Native | ✅ | Full support |
Before installing React Native IAP, make sure you have:
- React Native 0.64 or later, or Expo SDK 45 or later
- Node.js 16 or later
- iOS 15+ for iOS apps (StoreKit 2 requirement)
- Android API level 21+ for Android apps
Kotlin Version Requirement: This library requires Kotlin 2.0+. Configure your project's Kotlin version:
In your root android/build.gradle:
buildscript {
ext {
kotlinVersion = "2.1.20"
}
dependencies {
classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlinVersion"
}
}-
Install pods:
cd ios && pod install
-
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"
For Expo projects, add the plugin to your app.json or expo.json:
{
"expo": {
"plugins": [
"react-native-iap",
[
"expo-build-properties",
{
"android": {
"kotlinVersion": "2.2.0"
}
}
]
]
}
}Note: Expo projects require development build (dev-client) as this library contains native code.
React Native IAP is OpenIAP compliant. For detailed store configuration:
- iOS Setup → - App Store Connect configuration
- Android Setup → - Google Play Console configuration
React Native IAP provides AI-friendly documentation for Cursor, GitHub Copilot, Claude, and ChatGPT.
Quick links:
- llms.txt - Quick reference
- llms-full.txt - Full API reference
📖 Visit our comprehensive documentation site →
- 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
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, Dart, and GDScript from a single GraphQL schema
- Platform implementations — openiap-apple (StoreKit 2) and openiap-google (Play Billing 8.x)
- Verification profiles — Standardized receipt validation and purchase verification patterns
Other libraries built on OpenIAP: expo-iap · flutter_inapp_purchase · kmp-iap · godot-iap
Learn more about the OpenIAP standard →
Support this project by becoming a sponsor. Your logo will show up here with a link to your website. Buy me a coffee.
We also manage sponsorships through OpenCollective, which operates separately from our main sponsor program.
Sponsors:
Backers:
Become a sponsor | Become a backer
See our Contributing Guide for development setup and guidelines.
