Cross-platform subscriptions framework for ReactNative
Clone or download
Latest commit ff5f164 Dec 7, 2018


React Native Purchases is a cross platform solution for managing in-app subscriptions. A backend is also provided via RevenueCat

Getting started

$ npm install react-native-purchases --save

Mostly automatic installation

$ react-native link react-native-purchases

Additional iOS Setup

Purchases.framework also needs to be added to your iOS project. The npm install will download the correct framework version.

Alternatively you can install the framework via CocoaPods.

Create a Framework Reference in your project
  1. Drag Purchases.framework from the RNPurchasessub-project under the libraries section to the outer project and create a reference
Add iOS Framework to Embedded Binaries
  1. In Xcode, in project manager, select your app target.
  2. Select the general tab
  3. Drag Purchases.framework from your project to the Embedded Binaries section
  4. Add $(PROJECT_DIR)/../node_modules/react-native-purchases/ios to Framework Search paths in build settings
Add Strip Frameworks Phase

The App Store, in it's infinite wisdom, still rejects fat frameworks, so we need to strip our framework before it is deployed. To do this, add the following script phase to your build.

  1. In Xcode, in project manager, select your app target.
  2. Open the Build Phases tab
  3. Add a new Run Script, name it Strip Frameworks
  4. Add the following command "${PROJECT_DIR}/../node_modules/react-native-purchases/ios/" (quotes included)


import Purchases from 'react-native-purchases';

Purchases.addPurchaseListener((productIdentifier, purchaserInfo, error) => {
  if (error && !error.userCancelled) {
    this.setState({error: error.message});


Purchases.addPurchaserInfoUpdateListener((purchaserInfo, error) => {
  if (purchaserInfo) {

Purchases.addRestoreTransactionsListener((purchaserInfo, error) => {
  if (purchaserInfo) {

let purchases = await Purchases.setup("revenuecat_api_key", "app_user_id");

let entitlements = await Purchases.getEntitlements();

// later make a purchase