RevenueCat Integration

​

Getting Started with RevenueCat

This guide will walk you through the essential steps to integrate RevenueCat with your application, focusing on App Store Connect configuration.

​

What’s RevenueCat Integration?

RevenueCat helps you manage subscriptions and in-app purchases for your mobile app. This integration allows you to monetize your OnSpace-built app with ease.

​

1. Prerequisites

• An OnSpace app published to the App Store
• Apple Developer Account access
• App Store Connect access
• Setup all required steps under https://appstoreconnect.apple.com/business

​

Step 1: Create RevenueCat Account

Sign up for RevenueCat

• Go to RevenueCat and create an account
• Select Apple as your platform during setup

​

Step 2: Generate App Store Connect API Key

Navigate to App Store Connect → Users and Access → Integrations → Team Keys

​

Create New API Key

1. Click “Create New API Key” button
2. Set Access Level to “App Manager” (minimum required)

3. Download the API key (.p8 file) and save it securely
4. Copy the Issuer ID from the API page

​

Step 3: Upload API Key to RevenueCat

Return to RevenueCat dashboard Upload the .p8 file you downloaded Paste the Issuer ID you copied from App Store Connect Save the configuration

​

Step 4&5: Select Your App

RevenueCat will automatically read your apps from App Store Connect:

• Select the app you want to set up with RevenueCat
• Don’t have an app yet? Build your first app with OnSpace and publish it to the App Store first

​

Step 6: Set Up In-App Purchase Configuration

Navigate to App Store Connect → Users and Access → Integrations → In-App Purchase

​

Generate In-App Purchase Key

1. Click “Go to In-App Purchase Keys”
2. Navigate to Users and Access → Integrations

3. Select In-App Purchase
4. Click “Generate In-App Purchase Key” or the ”+” symbol
5. Enter a name for the key when prompted

Important Notes You have one opportunity to download the API key The key will appear under “Active Keys” Upload this key to RevenueCat dashboard

​

Step 7: Product Setup

Skip manual product creation in RevenueCat. Instead:

1. Set up products in App Store Connect first
2. Import products directly back to RevenueCat
3. This ensures consistency and reduces setup errors

​

Step 8: Export Dashboard

1. Click “Export Dashboard”
2. You’re all set! Your RevenueCat integration is now complete

​

2. Add App Configuration

• Navigate to your project settings and begin configuring your app.

​

3. Select App Store

• Choose App Store as your platform.

​

4. Add App Bundle ID

• Where to find your “App Bundle ID”:
  1. Go to App Store Connect.
  2. Navigate to General ➡️ App Information.
  3. Copy the Bundle ID found under the General Information section.
• Paste this Bundle ID into the corresponding field in RevenueCat.

---

​

5. Add App-Specific Shared Secret

• Where to find your “App-specific Shared Secret”:
  1. Go to App Store Connect.
  2. Navigate to General ➡️ App Information.
  3. Locate the App-Specific Shared Secret section.

4. Click Manage ➡️ Generate.

5. Copy the generated Shared Secret.

• Paste this Shared Secret into the designated field in RevenueCat.

---

​

6. Add In-App Purchase Key Configuration

• Where to find your “In-app purchase key configuration”:
  1. Go to App Store Connect.
  2. Navigate to Users and Access ➡️ Integrations.
  3. Select In-App Purchase.

4. Click Generate In-App Purchase Key, or click the ”+” symbol next to the “Active” header if you have generated one previously.
5. Enter a name for the key when prompted.

6. Once generated, your key will appear under Active Keys. You will have one opportunity to Download API Key.

7. Store this downloaded .p8 file securely, as you will need to upload it to RevenueCat.

• Uploading the In-App Purchase Key to RevenueCat:
  1. In the RevenueCat dashboard, select your App Store app from the Apps & providers page within your project settings.
  2. Within your app settings, go to the In-app purchase key configuration tab.
  3. Upload the .p8 file you downloaded from App Store Connect.

---

​

7. Add App Store Connect API

• Where to find your “App Store Connect API”:
  1. On App Store Connect, go to Users and Access → Integrations → App Store Connect API.

2. Click to create a new App Store Connect API key.
3. Ensure the newly created key has at least the App Manager access level.

4. Download the API key (.p8 file) and save it securely.

• Uploading the App Store Connect API Key to RevenueCat:

1. In the RevenueCat dashboard, select your iOS app from the Apps & providers page in the navigation.
2. Within your app settings, go to the App Store Connect API tab.
3. Upload the .p8 file you downloaded from App Store Connect.
4. You will then be prompted to input your Issuer ID, which you should have saved from when you created the API key.

5. You will also need to input your Vendor number. This can be found in App Store Connect under Payments and Financial Reports (typically in the top left corner of the page).

6. Click Save Changes in the RevenueCat dashboard.

---

​

8. Create Subscriptions

• Setting up Subscriptions in App Store Connect:
  1. Go to App Store Connect ➡️ Monetization ➡️ Subscriptions ➡️ Create.

2. Create Reference Name: This is an internal name for your subscription.

3. Create Subscription: Fill in both the Reference Name and Product ID. For example, for a monthly subscription, you might name it “monthly_subscription” and set the Product ID accordingly.

4. Ensure you Set Subscription Duration (e.g., Monthly).

5. Availability: By default, it will be set up globally.

6. Subscription Prices: Select the desired price from the dropdown. This will automatically convert to the global pricing table.

7. Localization: Add a Subscription Group Display Name. This is what users will see.
8. Review Information: Please ensure you include a screenshot of your app and your review notes in this section.
9. Make sure to Save your subscription. Once you’ve done these, all statuses will automatically change to “Ready to Submit.”

10. Repeat this process for any other subscription durations (e.g., yearly).
11. Localization: You can use different subscription group display names and app name display options for each localization.

• Importing Products into RevenueCat:
  1. Navigate back to RevenueCat.
  2. Go to Product Catalog ➡️ Entitlements.
  3. Click New Entitlement (e.g., “pro”).

4. Next, go to Product Catalog ➡️ Products.

5. Select the app you want to add products to.

6. Choose Import Products from App Store Connect. RevenueCat will pull the product data directly.

7. Go back to Entitlements, click on the entitlement you created (e.g., “pro”).

8. Click Attach to link your products to the entitlement.

• Setting Up Offerings in RevenueCat:
  1. Go to Product Catalog ➡️ Offerings.

2. Set up a New Offering.

3. Create a New Package within the offering.

4. Add packages for your different subscription durations (e.g., “Annual” and “Monthly”).