Next, set up your RevenueCat account. All you need is an email address.

Connecting the App Store to RevenueCat requires configuring credentials that allow RevenueCat to securely communicate with Apple's servers. There are two key credentials you should configure:

1. Generate an In-App Purchase Key (Required)

The In-App Purchase Key enables server-to-server communication with Apple's App Store Server API for validating transactions, managing subscriptions, and accessing purchase information. This is mandatory for apps using StoreKit 2.

Step 1: Create the Key in App Store Connect

1. Log in to App Store Connect.
2. Click Users and Access in the top navigation.
3. Select the Integrations tab.
4. In the left sidebar, click In-App Purchase under the "Keys" section.
5. Click the Generate In-App Purchase Key button (or click the + icon next to "Active" if you already have keys).
6. Enter a descriptive name for your key (e.g., "RevenueCat Production").
7. Click Generate.

Step 2: Download and Save the Key

1. Click Download In-App Purchase Key to download the .p8 file.
2. The file will be named SubscriptionKey_XXXXXXXXXX.p8 where XXXXXXXXXX is your Key ID.
3. Note down the Key ID displayed next to your key—you'll need this for RevenueCat.
4. Store the downloaded file in a secure location (password manager, secure vault, etc.).

Step 3: Find Your Issuer ID

1. On the same In-App Purchase keys page, look for the Issuer ID displayed at the top of the page.
2. Copy this ID—it's shared across all keys in your account.

2. Generate an App Store Connect API Key (Optional)

The App Store Connect API Key allows RevenueCat to automatically import products and prices from App Store Connect. While optional, it's highly recommended as it streamlines product management.

Step 1: Create the Key in App Store Connect

1. In App Store Connect, go to Users and Access → Integrations.
2. Click App Store Connect API in the left sidebar.
3. Click Generate API Key (or the + icon).
4. Enter a name (e.g., "RevenueCat Integration").
5. Select App Manager as the minimum access level.
6. Click Generate and download the .p8 file immediately.

Step 2: Find Your Vendor Number

1. Navigate to Payments and Financial Reports.
2. Find your Vendor Number in the top left corner.

3. App-Specific Shared Secret (StoreKit 1 - Legacy)

If your app supports iOS 14 or earlier with StoreKit 1, you'll need to configure the App-Specific Shared Secret instead of the In-App Purchase Key.

4. App Store Server Notifications (Optional)

App Store Server Notifications allow Apple to send real-time updates to RevenueCat about subscription events (renewals, cancellations, refunds, etc.).

If you'd like to set up server notifications, see the official documentation: Apple Server Notifications

5. Add Your Credentials to RevenueCat

Now let's configure everything in the RevenueCat dashboard.

Create or Select Your App Configuration

1. Log in to the RevenueCat dashboard.
2. Navigate to your project and click Apps & providers in the left sidebar.
3. If you haven't added an iOS app yet, click + Add app config in the top right corner.
4. Select App Store as the platform.
5. Enter your app's Bundle ID (must match exactly what's in App Store Connect, including capitalization).

Configure In-App Purchase Key (Required)

In your app's configuration page, find the In-app purchase key configuration section:

1. Upload your .p8 key file (SubscriptionKey_XXXXXXXXXX.p8).
2. Enter the Issuer ID (found at the top of the In-App Purchase keys page in App Store Connect).
3. Click Save Changes.

RevenueCat will automatically validate your credentials. If successful, you'll see a "Valid credentials" confirmation.

Configure App Store Connect API Key (Optional)

If you also want to enable automatic product importing, find the App Store Connect API section:

1. Upload your .p8 key file (AuthKey_XXXXXXXXXX.p8).
2. Enter the Issuer ID.
3. Enter the Vendor Number (found in Payments and Financial Reports).
4. Click Save Changes.

6. Verify Your Configuration

After saving your credentials, RevenueCat automatically validates them. You should see a "Valid credentials" message confirming everything is set up correctly.

Checklist

• ✅ Bundle ID matches exactly between RevenueCat and App Store Connect (including capitalization)
• ✅ In-App Purchase Key uploaded with correct Issuer ID (required for StoreKit 2)
• ✅ App Store Connect API Key uploaded with Issuer ID and Vendor Number (optional, for product importing)
• ✅ Key Status shows as "Active" in App Store Connect (not "Revoked")
• ✅ Server Notifications configured (optional, but recommended)
• ✅ Products created in App Store Connect (from Step 1)
• ✅ Paid Applications Agreement is signed and active

Common Issues

Phew, Congrats! You made it through the tricky part 🎉