Skip to main content

Integrate the Qonversion SDK using the official documentation.

Open in Cursor
Prefer to do it by hand? The steps are below. Setting up Qonversion takes four steps: choose a mode, create a project and register your app, install the SDK, and implement the mode you chose. Follow the steps below in order.
1

Choose the Qonversion mode you want to implement

Qonversion offers two SDK launch modes. Both include subscription analytics, integrations, webhooks, Apple Ads attribution, raw data export, and A/B experiments; the difference is who handles purchases and access.
  • Analytics Mode (Observer) — the fastest way to start in an app that already sells subscriptions: keep your purchase and entitlement code and get best-in-class subscription analytics.
  • Subscription Management Mode — let Qonversion fetch products, make and restore purchases, and check entitlements, including cross-platform access across iOS, Android, and the web.
Feature availability depends on your plan.
2

Create a project and register your app

  1. Navigate to the New Project page and provide a new project’s name. One project in Qonversion supports iOS, Android, and Web apps.
  2. In Settings, select the platform for your app and provide platform-specific data:
    • iOS App:
      1. App-Specific Shared Secret — you can find more details here.
      2. Your app’s App Store ID. To get your app’s App Store ID, navigate to the Apps tab in your App Store Connect account. Click on your app. You can see the App ID in the URL.
    • Android App:
      1. Service Account Key credentials — you can find more details here.
      2. Android package name.
    • Stripe App: Please follow this guide to connect Stripe to Qonversion.
  3. Get your Qonversion project key. You can find your Qonversion project key in the dashboard under Settings → Developer → Keys (see Project Keys). You will need this key to configure the SDKs. The project key is not the same as a store shared secret or service account key.
Please note, it may take up to 24 hours for your Google service credentials to work properly with the Android Developer API. You may see “Please provide valid JSON credentials” during the first 24 hours until the credentials start working correctly.
3

Install the SDK

Install the Qonversion SDK for your platform:→ iOS SDK → Android SDK → Flutter SDK → React Native SDK → Unity SDK → Cordova Plugin → Capacitor Plugin → Web SDK

​
Kids Mode SDKs

If you are building an app for kids, it is necessary to follow policies and not collect IDFA, GAID, and other advertisement attributes. For Kids Mode SDK integration follow this guide.
4

Implement Analytics or Subscription Management Mode

Use the mode you chose in Step 1 and follow the required option:

​
Additional Resources

→ Check out the Sample Apps → Tips on testing → Troubleshooting → Migrating In-App Subscriptions

​
Next steps

After the SDK is installed and your mode is implemented, wire up the purchase flow and verify access. These steps apply to Subscription Management Mode.

Displaying products

Fetch your configured products from Qonversion to build your paywall.

Making purchases

Trigger a purchase through the SDK and handle the result and errors.

Check entitlements

Read a user’s active entitlements to unlock or gate premium features.

Testing

Test purchases in the Apple and Google sandbox before going live.