Documentation

Published in website.

Announcement

This is a fork of https://github.com/dooboolab/react-native-iap. The binary is published to https://www.npmjs.com/package/@iap.dev/react-native-iap

Changes

If you are implementing promoted products. Seee the updated FAQ

Introduction

This react-native module will help you access the In-app purchases capabilities of your phone on the Android, iOS platforms and the Amazon platform (Beta).

Keep in mind react-native-iap will provide the basic features you need but is not a turnkey solution, implementing In-app purchases in your app will still require quite some work. Also, implementing the client side is only one side of the coin, you'll have to implement the server side to validate your receipts (which is probably the most time consuming part to do it correctly).

If you're looking for a module going further than react-native-iap, we recommend using react-native-iaphub which is taking care of everything from the client side to the server side.

⚠️ Most of users experiencing issues are caused by:

• A device simulator, use a real device for testing!
• The sandbox environment of the project not being configured properly (Configure android sandbox, Configure ios sandbox)
• An incorrect usage of the library

Demo

Quick News

• We had hard time supporting react-native-iap issues that did not provide working codes or any other examples. Therefore, we've decided to make an example app called DoobooIAP, which will contain all the features of IAP's and willing to continuously improve to support real-life examples. @Bang9 who had been helping many others for react-native-iap, is willing to support this repo so he will grant $300 of our income in opencollective as described in #855 :tada:.
• [email protected] ~ [email protected] is incompatible with react-native <0.61. This is fixed in [email protected] and above.
• [email protected] has been released. You can see #716 for updates.
• In the past, react-native-iap@^3.* has been updated very prompty for migration issues. Don't get suprised too much on why it is bumping up version so quickly these days.
  1. Migrated to new AndroidX APIs.
  2. Migrated to new Android billing client which is > 2.0.0.
     • acknowledgePurchase() has been added since 3.2.0 which is very important.
  3. New Purchase Flow
  4. More is comming in iOS 13.

Breaking Changes

[7.1.0]

• androidOldSku is no longer required #1438.

[6.1.0]

• Creates two variants: play and amazon and only uses the required code.

  NOTE: This would be a breaking change with a very simple fix described in the documentation. To add: `missingDimensionStrategy 'store', 'play'` `in build.gradle`

[3.0.0+] react-native-iap V3 note

Configuration of Google Play & iTunes Connect

• Please refer to Blog.

Deprecated README

• If you are using react-native-iap@^2.*, please follow the above README.

Usage

You can look in the RNIapExample/ folder to try the example.

NOTE: To run RNIapExample on Android use the variant flag as follows:

yarn android --variant=MY_VARIANT

where MY_VARIANT is PlayDebug or AmazonDebug

Below is basic implementation which is also provided in RNIapExample project.

If you want more advanced one please refer to dooboolab.com/sponsor.tsx

Sponsoring

Since IAP itself is not perfect on each platform, we desperately need this project to be maintained. If you'd like to help us, please consider being with us in Open Collective.

Sponsors

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

Backers

Please be our Backers.

Contributing

Please make sure to read the Contributing Guide before making a pull request. Thank you to all the people who helped to maintain and upgrade this project!