In-App Purchases in React Native & Expo: A Practical Guide to Subscriptions
Subscriptions are the most common way mobile apps make money, and also one of the easiest features to get subtly wrong. This guide covers the architecture I use when adding in-app purchases with subscription tiers to an Expo app on both iOS and Android.
Understand the moving parts
- Products and subscription groups are created in App Store Connect and Google Play Console.
- A client library (such as react-native-iap or RevenueCat's SDK) talks to the store from your app.
- Your backend, or a service like RevenueCat, validates receipts and stores what each user is entitled to.
Step 1: Create products
Define your subscription tiers (for example monthly and yearly) in both stores with matching identifiers. Add pricing, localisations and a free trial if needed. Products must be approved and agreements and tax details completed before they appear in the app.
Step 2: Fetch products and start a purchase
On the paywall screen, load products from the store so prices and currencies are always correct for the user's region. Never hard-code prices. When the user taps Subscribe, request the purchase and handle the three outcomes: success, cancelled and pending.
Step 3: Verify on a server
Treat the on-device result as a hint, not proof. Send the receipt or purchase token to your backend, validate it with Apple or Google, and write the entitlement to your database. This stops tampering and lets you support the same account across devices.
Step 4: Gate features with entitlements
Ask one question in the app: does this user have the pro entitlement right now? Keep that logic in one hook or context so every screen stays consistent.
Step 5: Restore purchases and handle renewals
Apple requires a visible Restore Purchases button. Also listen for store webhooks (or server notifications) so cancellations, renewals, billing retries and refunds update entitlements without the user opening the app.
Common mistakes
- Finishing the transaction before granting access, or granting access before finishing it.
- Testing only the happy path. Test cancel, pending, restore, expired and refunded states with sandbox accounts.
- Forgetting that Android and iOS handle trials, grace periods and upgrades differently.
- Not including terms, privacy policy and renewal information on the paywall, which causes review rejections.