This guide walks you through how to connect RevenueCat to your Audiorista app to enable in-app subscriptions on iOS and Android. You'll learn how to install the RevenueCat extension, set up your keys and paywalls, and request your updated app build.
Table of contents
-
Before you begin
What this guide covers
By the end of this guide, you will:
Know how to install the RevenueCat extension and configure your paywall.
Understand the difference between hard vs soft paywalls.
Know where to find and paste the required API keys and project IDs into Audiorista.
Be ready to request an iOS and Android app build.
Before you begin
Task prerequisites
A free account at revenuecat.com
-
Accounts at:
Step 1: Sign up for RevenueCat and create a project
Sign up: Go to RevenueCat and sign up for a free account. You only need an email to get started. Once logged in, the dashboard prompts you to create a project.
Step 2: Complete RevenueCat’s setup wizard
These steps include important details such as:
- Naming your project
- Choosing supported platforms (iOS or Android)
- Linking to existing or creating new in-app products in App Store Connect and Google Play Console
- Generating API credentials
NOTE: We strongly recommend using the RevenueCat setup wizard. While it’s possible to configure everything manually in the different sections of the RevenueCat Dashboard, the wizard offers a streamlined flow that minimizes setup errors.
👉 Make sure you complete the RevenueCat wizard before continuing.
Step 3: Generate your RevenueCat credentials (API keys & project ID)
You’ll need to generate and copy several keys and IDs from your RevenueCat dashboard:
Project ID (v2): In RevenueCat, open your Project’s Settings (⚙). Under General, note the Project ID shown there 13 . This ID (often a short alphanumeric string) is used in API v2 calls.
-
Secret API Keys (v1 & v2): Scroll on the API Keys page to Secret API Keys. Click + New secret API
Give it a name (e.g. “Audiorista-v1”), choose version v1, and save. Copy the generated secret key (starts with sk_ ). Repeat and create another with version v2 (for API v2 integration).
- Public SDK Keys (Android & iOS): Each app in your project has a Public API Key (also called the SDK key). These are auto-generated when you added the apps via the wizard. To find them, go to API Keys in the dashboard, or open each app under Apps & providers. You’ll see a “Public SDK Key” string for each platform. Copy the Android key and the Apple key separately. (They typically start appl_ or andr_ ). These public keys are used by the SDK and Audiorista for client-side identification.
Step 4: Install the RevenueCat extension in Audiorista
Log in to your Audiorista Dashboard
Navigate to the Extensions section
Select RevenueCat
A new page with configuration settings will then open
Step 5: Hard vs. soft paywalls
Audiorista supports two types of paywall behavior when using RevenueCat:
| Paywall type | Description |
|---|---|
| Hard paywall | Requires users to subscribe before accessing any content. No free previews are shown. This forces immediate subscription to proceed. |
| Soft paywall | Allows users to sample content or access some free content before prompting them to subscribe. For example, you might give a few podcast episodes free and lock the rest. |
Choose the mode that fits your business model. For example, a soft paywall is common when you want to let users try some free episodes or use the app in limited mode; a hard paywall may be used if all premium content requires a subscription upfront. Audiorista’s dashboard will apply the paywall logic based on how you configure the subscriptions and extensions. Each uploaded title can be marked as free or Paid, and any paid titles will load the paywall when pressed.
Step 6: Add your RevenueCat credentials to Audiorista
Open the newly installed RevenueCat extension. It will have fields to enter your RevenueCat keys: paste the Project ID (v2), Public API key (Android), Public API key (Apple), and Secret API key (v1 or v2) as requested. Enter the values exactly as copied from RevenueCat.
3. Connect: Click Save/Connect. Audiorista will verify the connection. If everything is correct, the extension will show as active. Your Audiorista app is now linked to RevenueCat.
Step 7: Finalize subscription products in App Stores
Before generating builds, make sure your in-app purchases are fully configured in both stores:
• App Store Connect & Google Play Console: Complete any necessary setup for your in-app subscriptions, such as providing descriptions, pricing for different markets, and availability in different markets.
• Sandbox/Test Accounts: For development testing, make sure you have sandbox testers set up:
• In App Store Connect, add tester Apple IDs (in Users and Access or via TestFlight internal testing).
• In Google Play, set up internal testing and add tester emails.
Step 8: Create a Paywall in RevenueCat
Now design the paywall your users will see in the app:
In RevenueCat’s dashboard, select your project and go to Paywalls (under Monetization or Offerings). Click + New Paywall to start building.
• Select Offering: Choose the Offering you created (e.g., default ).
• Choose a Template: You can pick a pre-built template (e.g,. Subscription options screen) or start from scratch.
• Design: Customize the paywall UI (text, images, colors) as needed. Link each button to the appropriate package (e.g., “Monthly” buys the monthly subscription package).
• Save the paywall. This paywall will be shown in your app when users hit the subscription screen.
Step 9: Request app builds in Audiorista
With everything wired up, generate your iOS and Android builds through Audiorista:
• Build iOS & Android builds: In the Audiorista dashboard, navigate to the iOS or Android build section under distribution. Ensure your App Store setup is complete (you added bundle ID and team ID, etc.). Click request a new build, and in a few minutes, the build will be sent over to Apple TestFlight in your App Store Connect account, or the bundle explorer in Google Play Console for Android apps.
Testing your setup
Before submitting your app to the stores, make sure to test the full subscription flow:
Use TestFlight (iOS) or Internal Testing (Android)
Verify the paywall displays correctly
Check test transactions with test users added to your App Store Connect and Google Play Console