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.

🎨 Promotion

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.

🚀 Explore kstyled →

📚 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.

$3

- 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.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://hyochan.github.io/react-native-iap/docs/installation#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
- 📱 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

🚀 Quick Start

``bash
npm install react-native-iap react-native-nitro-modules


or

In your root android/build.gradle:

`gradle
buildscript {
ext {
kotlinVersion = "2.1.20"
}
dependencies {
classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlinVersion"
}
}
`

#### iOS Configuration

1. Install pods:

`bash
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 Configuration

For Expo projects, add the plugin to your app.json or expo.json:

`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.

$3

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 →

$3

- 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

Sponsors

💼 View Our Sponsors

$3

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.

---

$3

We also manage sponsorships through OpenCollective, which operates separately from our main sponsor program.

Sponsors:

Backers:

Become a sponsor | Become a backer

Contributing

See our Contributing Guide for development setup and guidelines.