New version releases and updates
View All Tags
React Native IAP 14.6.0 brings the new Billing Programs API from Google Play Billing Library 8.2.0+, allowing developers to use External Content Links and External Offers. This release also includes full support for one-time product discounts from Billing Library 7.0+ and new purchase status fields from Billing Library 8.1.0+.
React Native IAP 14.5.0 brings built-in purchase verification (aka receipt validation) powered by IAPKit. Now you can verify purchases with enterprise-grade backend validation using a single API call—no server setup required.
React Native IAP 14.4.33 introduces Horizon OS support for Meta Quest devices, enabling developers to implement in-app purchases in VR applications using the same familiar API.
This release integrates Meta's Platform SDK for in-app purchases on Horizon OS, while maintaining the unified OpenIAP interface across iOS, Android, and now Horizon OS.
React Native IAP 14.4.12 introduces comprehensive alternative billing support for both iOS and Android platforms, empowering developers to use external payment systems alongside or instead of platform billing—unlocking reduced fees and greater monetization flexibility.
React Native IAP 14.4.12 introduces comprehensive alternative billing support for both iOS and Android, empowering developers to use external payment systems alongside or instead of App Store and Google Play billing. This enables reduced platform fees and greater flexibility in monetization strategies while maintaining compliance with platform policies.
This release adds full alternative billing functionality for both platforms:
import {
initConnection,
checkAlternativeBillingAvailabilityAndroid,
showAlternativeBillingDialogAndroid,
createAlternativeBillingTokenAndroid,
userChoiceBillingListenerAndroid,
} from 'react-native-iap';
// Initialize with alternative billing mode
await initConnection({
alternativeBillingModeAndroid: 'alternative-only', // or 'user-choice'
});
// 3-step alternative billing flow
const isAvailable = await checkAlternativeBillingAvailabilityAndroid();
const userAccepted = await showAlternativeBillingDialogAndroid();
const token = await createAlternativeBillingTokenAndroid(productId);
// User choice billing event listener
const subscription = userChoiceBillingListenerAndroid((details) => {
console.log('User selected alternative billing');
// Report to backend for Google Play compliance
});
import {
canPresentExternalPurchaseNoticeIOS,
presentExternalPurchaseNoticeSheetIOS,
presentExternalPurchaseLinkIOS,
} from 'react-native-iap';
// Check availability (iOS 18.2+)
const canPresent = await canPresentExternalPurchaseNoticeIOS();
// Present notice sheet before external link
const noticeResult = await presentExternalPurchaseNoticeSheetIOS();
if (noticeResult.result === 'continue') {
// Redirect to external purchase URL
const result = await presentExternalPurchaseLinkIOS(
'https://your-website.com/purchase',
);
}
Automatic iOS alternative billing configuration:
// app.config.ts
export default {
plugins: [
[
'react-native-iap',
{
iosAlternativeBilling: {
// Required: Countries (ISO 3166-1 alpha-2)
countries: ['kr', 'nl', 'de', 'fr'],
// Optional: External URLs per country
links: {
kr: 'https://your-site.com/kr/checkout',
nl: 'https://your-site.com/nl/checkout',
},
// Optional: Multiple URLs (iOS 17.5+, up to 5)
multiLinks: {
de: [
'https://your-site.com/de/checkout',
'https://your-site.com/de/offer',
],
},
// Optional: Custom regions (iOS 18.1+)
customLinkRegions: ['de', 'fr', 'nl'],
// Optional: Streaming regions (iOS 18.2+, music apps)
streamingLinkRegions: ['at', 'de', 'fr', 'nl'],
// Enable entitlements
enableExternalPurchaseLink: true,
enableExternalPurchaseLinkStreaming: false, // music apps only
},
},
],
],
};
The config plugin automatically adds:
com.apple.developer.storekit.external-purchase, etc.)SKExternalPurchase, SKExternalPurchaseLink, etc.)Alternative billing is fully integrated into the useIAP hook:
import {useIAP} from 'react-native-iap';
const {
checkAlternativeBillingAvailabilityAndroid,
showAlternativeBillingDialogAndroid,
createAlternativeBillingTokenAndroid,
} = useIAP({
// Android alternative billing configuration
alternativeBillingModeAndroid: 'alternative-only',
// User choice billing event handler
onUserChoiceBillingAndroid: (details) => {
console.log('User selected alternative billing');
reportToBackend(details.externalTransactionToken);
},
});
A complete alternative billing example is now included in the example app:
Run the example app and navigate to "Alternative Billing" from the home screen.
All alternative billing APIs are fully typed with TypeScript:
AlternativeBillingModeAndroid: 'none' | 'alternative-only' | 'user-choice'UserChoiceBillingDetails: Product list and external transaction tokenExternalPurchaseNoticeResultIOS: Notice sheet result with actionExternalPurchaseLinkResultIOS: External link presentation resultComprehensive documentation added:
Both platforms require special approval to use alternative billing:
npm install react-native-iap@14.4.12
# or
yarn add react-native-iap@14.4.12
# or
bun add react-native-iap@14.4.12
For Expo projects, run npx expo prebuild after updating your config plugin.
This release builds on the alternative billing implementation from expo-iap, bringing the same powerful features to React Native CLI projects.
Try out alternative billing in 14.4.12 and let us know your feedback via GitHub issues!
React Native IAP 14.4.0 graduates the project into the full OpenIAP ecosystem. The release ships with three dedicated native stacks:
From 14.4.0 onward, React Native IAP stays in lockstep with these modules: Apple v1.2.2, Google v1.2.6, and GQL v1.0.8. That shared version alignment gives React Native IAP stable native compatibility and a unified type system straight from the OpenIAP schema.
openiap-versions.json; Gradle now fails fast if the Google artifact version is missing and scripts/migrations read from one source of truth.subscriptionOfferDetailsAndroid so Google Play discounts apply reliably.requestPurchase on iOS explicitly rejects unsupported product types instead of silently treating all as in-app.openiap-versions.json synchronized for Android and iOS builds.transactionId is reinstated as the primary store reference (orderId on Android, StoreKit transaction ID on iOS). Android's generic id is no longer repurposed for orders; when Google Play omits an orderId (typical for consumables), transactionId becomes null and clients should rely on the unified purchaseToken (Android purchase token / iOS JWS). This value is the canonical receipt for server validation.in-app or subs. Passing all (or any other type) throws an explicit error.productId.npm install react-native-iap@14.4.0
# or
yarn add react-native-iap@14.4.0
# or
bun add react-native-iap@14.4.0
Enjoy the smoother upgrade path and richer diagnostics shipped in 14.4.0! Let us know how it goes via GitHub issues.
We're excited to announce React Native IAP 14.1.0 with significant type system improvements and API enhancements! 🚀
⚠️ Note: This release contains breaking changes. Please review the migration guide carefully.
We've just released React Native IAP 14.0.0 with important fixes for Expo plugin and npm publishing. 🛠️