Handyman Service - Documentation
Handyman Services

RevenueCat Setup

Welcome to RevenueCat!
This guide will help you understand how to create a RevenueCat account and obtain the required API keys for integrating RevenueCat into your mobile app or website.

📦 What is RevenueCat?

RevenueCat is a powerful and user-friendly third-party service that simplifies the management of in-app subscriptions and purchases across iOS, Android, and Web applications.

It makes the following tasks easier:

  • Real-time tracking of subscriptions
  • Verifying purchase receipts
  • Analyzing customer and revenue data
  • No need to build or maintain a custom server-side system

📘In simple terms — RevenueCat provides a robust backend to manage your paid plans, subscriptions, and premium access features efficiently.

For more details, visit the official RevenueCat documentation: 👉 RevenueCat Documentation

🧭 What will you learn in this guide?

This step-by-step guide will walk you through:

  • How to create a new project in RevenueCat
  • How to add your Android and iOS apps
  • How to configure your subscriptions and offerings
  • Where to find and use RevenueCat API keys
  • How to integrate RevenueCat within your admin panel

🧾 Create a RevenueCat Account

To get started with RevenueCat, the first step is to create your account and log in to the dashboard. Follow the steps below:

🔹 Step 1: Go to the RevenueCat Website
  • Open your browser and navigate to: https://www.revenuecat.com
  • On the top-right corner of the homepage, you will see two buttons:
    🔵 Log In and 🔵 Sign Up
🔹 Step 2: Sign Up or Log In

If you already have an account:

  • Click Log In
  • Enter your email and password to access your dashboard.

🔹 Step 2: If you’re new to RevenueCat:

  • Click Sign Up.
  • Provide your Name, email address and create a password to register.
✅ After Logging In:

Once logged in, you’ll be redirected to the RevenueCat Dashboard you can start like creating your first project, add apps, configure subscriptions, and manage your in-app purchases.

🏗️ How to Create a Project in RevenueCat

To manage subscriptions using RevenueCat, the first step is to create a Project. Each mobile app or service should have its own separate project for better organization and data separation.

🔹 Step 1: Open the “All Projects” Menu
  • In the top-left corner of the RevenueCat dashboard, you will see a dropdown labeled “All Projects.”
  • Click on it to open the project selection menu.
🔹 Step 2: Click on “Create new project”
  • At the bottom of the dropdown menu, you’ll see ➕ Create new project
  • Click this button to begin creating your project.
🔹 Step 3: Enter Your “Project Name”
  • A popup window will appear asking for the name of your project.
  • After entering the name, click on the Create Project button.
✅ After Successfully Creating the Project:

You will be taken into your new project dashboard, where you can:

  • Add Android and iOS apps
  • Manage Subscriptions, Products, and Offerings
  • Access API Keys and integration settings

📱Configure Android and iOS in RevenueCat

If you have already created a project in RevenueCat, follow the steps below to add your Android App:

🔹 Step 1: Login to your RevenueCat Dashboard.
  • On the Projects list, select the project you previously created.
🔹 Step 2: Click on “Apps & Providers”
  • On the left-hand sidebar, scroll down and click on “Apps & providers”.
🔹 Step 3: Click “+ Add app config”

Inside the App configuration section, click the button labeled “+ Add app config”. This begins the process of adding a new app configuration for either iOS or Android.

Add Android Apps

🔹 Step 4: Choose “Google Play Store” (Android)

A dialog will prompt you to select the platform. Pick Android / Google Play Store as your platform type.

🔹 Step 5: Fill Required Android App Details
  • App Name: The name you want for your app in RevenueCat.
  • Google Play Package Name: Must match your Android app’s applicationId (from android/app/build.gradle).
  • Service Account Credentials JSON: Upload the JSON file generated via Google Play Console to authenticate and sync purchase data.
  • RevenueCat automatically validates the uploaded service account credentials. You should see a “Valid credentials” message if everything is correctly configured.
  • After all fields are correct and validation passes, click the “Save” or “Continue” button to finalize the Android app setup.
  • The details of the Android App you added can be viewed here.

Add iOS Apps

🔹 Step 6: Choose “Apple App Store” (iOS)

A popup will appear asking you to choose a platform. Select Apple App Store as your app’s platform.

🔹 Step 7: Fill Required iOS App Details

Fill in the following fields from App Store Connect:

  • Click on “+ Add” button from top left corner of “Apps Section”.
  • Choose “AppStore” as platform
  • You have to add your Provider App’s name, bundle Id, App Store Connect App-Specific Shared Secret, P8 key file from App Store Connect inside “In-App Purchase Key Configuration” and “App Store Connect API”
  1. App Specific Shared Secret
  2. In-App Purchase Key Configuration
  3. App Store Connect API

After adding required details save it.

  • The details of the Android App you added can be viewed here.

Add Products

✅Step 1: Open the RevenueCat dashboard then go to Product Catalog.

✅Step 2: From the left sidebar, go to Product Catalog > Products.

✅ Step 3: Click the “+ New” button to create a new products.

✅ Step 4: From here, first select your platform (Android / iOS).

✅ Step 5: The “Import Products” button is the easiest option. It automatically imports your subscription plans from the Google Play Console and Apple App Store.

  • Then, enter the Display Name and select the Product Type.
  • Fill in the Subscription ID, Base Plan ID (if applicable for Google), and the RevenueCat Product Identifier, then click on the “Create Product” button.

Add Entitlement

✅Step 1: Open the RevenueCat dashboard then go to Product Catalog.

✅Step 2: From the left sidebar, go to Product Catalog > Entitlement.

✅ Step 3: Click the “+ New” button to create a new Entitlement.

✅ Step 3: Here, you need to enter a simple lowercase identifier name and write a short and clear description about your subscription plan.

  • After filling in all the details, click on the “Add” button to save the entitlement.

Add Offerings

🟢 Step 1: Open the RevenueCat dashboard then go to Product Catalog.

🟢 Step 2: From the left sidebar, go to Product Catalog > Offerings.

🟢 Step 3: Click the “+ New” button to create a new offering.

🟢 Step 4: Enter an Identifier Name, such as Display Name.

  • Go to the Packages tab.
  • Then click the “+ New” button to create a new package.
  • Choose a Package Identifier and Description, like annual or monthly.

🟢 Step 5: Choose the product(s) you created in the Google Play Console or App Store Connect (e.g., premium, monthly_access).

  • You can attach multiple subscription products to the same package if needed.
  • Then click Save.

In App Purchase setup in Admin panel

  • Go to “Earning Setting” menu and choose subscription from Select Earning Type For Provider dropdown.
  • Open your admin panel and navigate to Settings → App Configuration Settings
  • Enable switch for “In App Purchase” then fill up required fields.
  • For “Entitlement Identifier” , go to RevenueCat dashboard and click on “Entitlement” menu from “Product Catalog”
  • For “Google Public API Key” and “Apple Public API Key” fields, go to RevenueCat dashboard and click on “API Keys” menu from “Project Settings” section.
  • Copy the app-specific “Public API keys” for your Android app inside “Google Public API Key” and iOS app Apple Public API Key

Update Plans in Admin Panel

  • Go to “Plan” section.
  • Go to the RevenueCat dashboard and copy the PlayStore Identifier and App Store Identifier for the specific plan and related plan.
  • Go to Admin Panel -> Plan Section and select your desired plan.
  • Then, Fill in the PlayStore Identifier and AppStore Identifier fields.
  • Click Save button.