What RevenueCat Does
RevenueCat sits between your app and the App Store / Google Play billing systems. It validates receipts, tracks subscriber status in real time, and gives you a unified revenue dashboard across both platforms. You also get built-in tools to design paywalls and run experiments to find the pricing that converts best.Prerequisites
Before connecting RevenueCat to Rey, make sure you have:- A RevenueCat account with a project created.
- Your in-app products configured in App Store Connect (iOS) and/or Google Play Console (Android).
- Your RevenueCat public API key — find it in RevenueCat under Project Settings → API Keys.
Connect RevenueCat to Rey
Set up products in RevenueCat
Log in to your RevenueCat dashboard, create a new project, and add your products. Make sure each product ID matches exactly what you’ve configured in App Store Connect or Google Play Console. RevenueCat’s quickstart guide walks through this in detail.
Copy your public API key
In RevenueCat, go to Project Settings → API Keys and copy your Public SDK key. This is a read-safe key used to initialize the SDK — do not use a secret key here.
Enter your API key in Rey
In the Rey editor, open the Integrations panel, select RevenueCat, and paste your public API key into the API Key field.
Add a Paywall Screen
Once RevenueCat is connected, drag the Paywall component from the Rey component library onto any screen. The Paywall component fetches your active offering from RevenueCat and renders the paywall UI automatically — including product names, pricing, and call-to-action buttons.Configure Products and Pricing
All product and pricing configuration happens in the RevenueCat dashboard, not in Rey. To update pricing, add a new product, or change your offering, log in to RevenueCat and edit your offerings there. Rey picks up the latest configuration automatically — no republish required.Run A/B Tests on Paywalls
RevenueCat’s Experiments feature lets you test different paywall designs and pricing against each other. To run a test:- Set up an experiment in the RevenueCat dashboard under Experiments.
- Define your control and treatment offerings (different prices, trial lengths, or UI copy).
- Rey surfaces the correct paywall variant to each user automatically based on RevenueCat’s assignment logic.
Understand Your Revenue
What happens if a user's subscription lapses?
What happens if a user's subscription lapses?
RevenueCat tracks subscription status in real time. When a subscription lapses, RevenueCat updates the subscriber’s entitlements immediately. Rey reads the updated entitlement status and can show or hide premium content accordingly — no extra logic needed on your end.
Can I offer a free trial?
Can I offer a free trial?
Yes. Configure free trial periods directly in App Store Connect or Google Play Console on the product level. RevenueCat and Rey surface the trial automatically in the Paywall component.
Does Rey support one-time purchases as well as subscriptions?
Does Rey support one-time purchases as well as subscriptions?
Yes. RevenueCat supports both subscription products and non-consumable / consumable one-time purchases. Add them as products in RevenueCat and they will appear in your Paywall component alongside subscriptions.