Skip to main content
The Subscription Management mode allows you to implement a complete cycle of in-app purchases management: getting offers, making (or restoring) purchases, and handling entitlements. If you want only to get a single source of truth for revenue analytics and leverage real-time purchase events in integrations, please refer to the Analytics Mode guide.

​
1. Configure Products & Entitlements

To successfully run subscription-based entitlement management, you need to connect stores’ products to Qonversion:
  1. Create and configure in-app products on the App Store Connect and/or Google Play Console sides
    • Please note that your App Store Connect products must be in either Ready to submit or Ready for sale statuses. Otherwise, the Product not found error may occur during Qonversion SDK integration.
    • Do not forget to activate your products for the Google Play console. Otherwise, the SkuDetails error may occur during Qonversion SDK integration.
  2. Create entitlement which should be granted once in-app product is purchased. Learn more about Qonversion entitlements here.
  3. Create product-linker in Qonversion and link it to the previously created entitlement. Learn more about Qonversion products here.
Selling on the web too? You can map web-billing products into the same entitlements. Connect Stripe or Paddle and add their product IDs to your Qonversion products so cross-platform subscribers get the same access.

​
2. Configure a Remote Config for your paywall (optional)

To change the set of products offered to your users without an app release, put your product IDs into a Remote Config and read it in the app. This also lets you target user segments and run A/B tests on your paywall later. See the recommended payload structure and code samples. This step is not required for Subscription Management Mode — you can also request your products directly.

​
3. Launch SDK

Initialize the SDK in Subscription Management mode: →Get your Qonversion Project Key

​
4. Set additional user attributes

Optionally, to improve attribution in Adjust, AppsFlyer, Singular, or to match Qonversion revenue events to users in third-party tools, you can share with us such attributes as User Identifier, IDFA (Identifier for Advertisers, iOS 14.5+ only) or ASID (App set ID, Android 12+ only). Please follow this guide to learn more.

​
5. Display products, make purchases, and check the premium status

Once you have added Products and Entitlements to Qonversion, initialized the SDK, and added user attributes, it’s time to proceed to the main part of the Subscription Management implementation!
  1. Here you’ll learn how to correctly display products to your customer using Qonversion SDK.
  2. By following this guide, you will know how to launch a purchase, after which your user gets premium access with the entitlement you have created above.
  3. Finally, this article will help you check whether your user has already been granted access to your premium features.

​
Next steps

With products, entitlements, and the SDK in place, wire up the purchase flow and verify access.