react-native-iap

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.

Compatibility (Nitro 14.x)

• 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

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 v8.0.0+
Expo Go	❌	Not supported (requires native modules)
Expo Dev Client	✅	Full support
Bare React Native	✅	Full support

📦 Installation & Configuration

Prerequisites

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

Post Installation

Android Configuration

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"
    }
}

iOS Configuration

• 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"

Expo Configuration

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.

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

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