This troubleshooting guide covers the most common issues developers encounter when integrating RevenueCat into their apps. Whether you're dealing with configuration problems, error messages, or unexpected behavior, this guide will help you identify and resolve issues quickly.

What This Guide Covers

We'll walk through troubleshooting steps for:

• Google Play Configuration: Product setup, service credentials, and testing issues.
• App Store Configuration: Product approval, StoreKit, and bundle ID problems.
• Fetching Offerings: Empty offerings, product mismatches, and network errors.
• Paywall Issues: Display problems, product rendering, and purchase flows.
• SDK Debug Messages: Understanding and interpreting SDK logs.
• General Debugging: Tools, techniques, and best practices.

How to Use This Guide

Each section contains:

• Common error messages you might see.
• Root causes for each issue.
• Step-by-step solutions to resolve the problem.
• Prevention tips to avoid the issue in the future.

Before You Begin

Make sure you have:

• Access to your RevenueCat dashboard.
• Access to Google Play Console (for Android).
• Access to App Store Connect (for iOS).
• Your project's source code.
• SDK debug logging enabled (we'll show you how).

Let's start troubleshooting!