One TypeScript API for in-app purchases and paywalls across iOS and Android.
The React Native SDK is on the roadmap and is not published yet. cashsdk-react-native does not
resolve from any registry today, so the code on this page describes the
intended API rather than a package you can install.
Shipping now? Use the iOS or Android SDK, which are available today. To be notified when this one lands, contact support@cashsdk.com.
The CashSDK React Native SDK gives you a single, fully typed API that runs on both iOS (StoreKit 2) and Android (Play Billing). Fetch offerings, run purchases, and read entitlements with the same code on every platform.
npm install cashsdk-react-native
For a bare React Native project, install the native iOS pods:
cd ios && pod install
Expo? The SDK includes a config plugin. It works in any development or
production build (npx expo run:ios / eas build). It is not available in
Expo Go, since in-app purchases require native modules.
Call configure once at the root of your app, before rendering any screen that
reads entitlements. Use your publishable key.
import { CashSDK } from "cashsdk-react-native";
CashSDK.configure({ publishableKey: "csk_pk_…" });
export default function App() {
return <RootNavigator />;
}
Only publishable keys (csk_pk_… / csk_pk_…) belong in your app bundle.
Keep secret keys (csk_sk_…) on your backend.
Fetch offerings on mount, present them, and complete a purchase. The result carries the customer's updated entitlements.
import { useEffect, useState } from "react";
import { View, Text, Pressable } from "react-native";
import { CashSDK, type Offering } from "cashsdk-react-native";
export function Paywall({ onUnlock }: { onUnlock: () => void }) {
const [offering, setOffering] = useState<Offering>();
const [busy, setBusy] = useState(false);
useEffect(() => {
CashSDK.offerings().then(setOffering);
}, []);
async function buy() {
if (!offering) return;
setBusy(true);
try {
const result = await CashSDK.purchase(offering.monthly);
if (result.entitlements.pro?.isActive) onUnlock();
} finally {
setBusy(false);
}
}
return (
<View>
<Text>Unlock Pro</Text>
<Pressable disabled={busy} onPress={buy}>
<Text>{offering?.monthly.localizedPrice ?? "…"}</Text>
</Pressable>
<Pressable onPress={() => CashSDK.restorePurchases()}>
<Text>Restore purchases</Text>
</Pressable>
</View>
);
}
Read entitlements from any purchase or restore result to gate features.
if (result.entitlements.pro?.isActive) {
unlockPro();
}
Let customers recover access on a new device or after a reinstall.
const result = await CashSDK.restorePurchases();
if (result.entitlements.pro?.isActive) {
unlockPro();
}
Link the SDK to your own user ID so entitlements follow the customer across
devices and platforms. Call identify after sign-in.
CashSDK.identify("u_812");