Skip to main content
RevenueCat is the industry-standard platform for managing in-app subscriptions and one-time purchases on iOS and Android. It handles subscription state, receipt validation, paywall UI, A/B testing, and revenue analytics in one place. By connecting RevenueCat to Rey, you can fully monetize your app without writing any payment or billing code.

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

1

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.
2

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.
3

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.
4

Save and verify the connection

Click Save. Rey connects to RevenueCat and confirms the integration is active. A green status indicator appears on the RevenueCat card in the Integrations panel.

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.
Place your Paywall screen at high-intent moments: right after onboarding, when a user tries to access a premium feature, or on a dedicated “Upgrade” screen reachable from your settings menu.

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:
  1. Set up an experiment in the RevenueCat dashboard under Experiments.
  2. Define your control and treatment offerings (different prices, trial lengths, or UI copy).
  3. Rey surfaces the correct paywall variant to each user automatically based on RevenueCat’s assignment logic.
You don’t need to change anything in Rey to start or stop an experiment — RevenueCat controls variant delivery end-to-end.

Understand Your Revenue

RevenueCat’s dashboard shows active subscribers, monthly recurring revenue, churn rate, and trial conversions in real time. For monetization analytics, you don’t need a separate analytics tool — RevenueCat covers it all.
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.
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.
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.