How to display products with the Qonversion SDK

The Qonversion SDK manages in-app purchases across platforms so you do not store App Store or Google Play product IDs and prices on the client. To promote products from the Qonversion dashboard, first configure Products and Entitlements in Qonversion. Qonversion gives you two ways to decide which products to show:

Remote Config (recommended) — a Remote Config holds your product IDs, so you can change the products offered, target user segments, and run A/B tests without an app release. See the recommended payload structure and code samples.
Qonversion Products directly — fetch the full list of configured products with the SDK, as described in Get the list of available products below.

Local cache

The Qonversion SDK caches product and entitlement data, so the list stays available when the internet connection is lost or the server is delayed. On every app launch the SDK also requests the current SKProduct / storeDetails from the App Store or Google Play to keep prices and product data up to date.

Get the list of available products

Call the products method to fetch every product configured for your project. The method returns a dictionary keyed by Qonversion Product ID; each value is a Qonversion.Product object.

Qonversion.shared().products { productsList, error in
    let product = productsList["main"]
    if product?.type == .trial {

    }
}

[[Qonversion sharedInstance] products:^(NSDictionary<NSString *,QONProduct *> * _Nonnull productsList, NSError * _Nullable error) {
  if (error) {
    // Handle error
  }
  QONProduct *product = productsList[@"main"];
  if (product && product.type == QONProductTypeTrial) {

  }
}];

Qonversion.getSharedInstance().products(new QonversionProductsCallback() {
            @Override
            public void onSuccess(@NotNull Map<String, QProduct> productsList) {
                // handle available products here
            }

            @Override
            public void onError(@NotNull QonversionError error) {
                // handle error here
            }
});

Qonversion.shared.products(callback = object: QonversionProductsCallback {
            override fun onSuccess(products: Map<String, QProduct>) {
                // handle available products here
            }

            override fun onError(error: QonversionError) {
                // handle error here
            }
})

try {
  final Map<String, QProduct> products = await Qonversion.getSharedInstance().products();
} catch (e) {
  print(e);
}

const products: Map<string, Product> = await Qonversion.getSharedInstance().products();

Qonversion.GetSharedInstance().Products((products, error) =>
{
   if (error == null)
   {
       // Display products
   }
   else
   {
       // Handle the error
       Debug.Log("Error" + error.ToString());
   }
});

const products = await Qonversion.getSharedInstance().products();

const products: Map<string, Product> = await Qonversion.getSharedInstance().products();

The callback (or return value) provides:

productsList — a dictionary of available products, keyed by Qonversion Product ID (for example, main). Values are Qonversion.Product objects.
error — the error, if the request failed. On callback-based platforms the products dictionary is empty when error is set.

The products method returns only products you configured in the Qonversion dashboard. It does not create products in the stores, and it does not return App Store or Google Play products that are not linked to a Qonversion Product.

The Product object

Qonversion.Product exposes the fields below. Fields marked iOS only or Android only are nil/null on the other platform.

Property	Type / values	Description
`qonversionID`	String	Qonversion Product ID. For example, `main`.
`storeID`	String	The store product ID (App Store or Google Play).
`basePlanID`	String, Android only	Identifier of the base plan for a subscription product.
`type`	Enum: `trial`, `intro`, `directSubscription`/`subscription`, `oneTime`/`inapp`	Product type. `trial` — subscription with a trial period; `intro` — subscription with an intro period; `directSubscription`/`subscription` — auto-renewable or prepaid (Android) subscription without a trial or intro; `oneTime`/`inapp` — non-recurring product.
`subscriptionPeriod`	`SubscriptionPeriod` object, or `nil` if not a subscription	The subscription period. `SubscriptionPeriod` has `SubscriptionPeriodUnit` (`day`, `week`, `month`, or `year`) and an integer `unitCount`. For example, `unit = .month` and `unitCount = 3` means a 3-month subscription. On Android and cross-platform SDKs it also has an `iso` field in ISO 8601 format, e.g. `P3M` for that example.
`trialPeriod`	`SubscriptionPeriod` object, or `nil` if not a subscription or no trial	The trial period. Same shape as `subscriptionPeriod`. For example, `unit = .day` and `unitCount = 7` means a 7-day trial. On Android and cross-platform SDKs it also has an `iso` field, e.g. `P3M`.
`skProduct`	`SKProduct`, iOS only	The `SKProduct` object received from StoreKit.
`storeDetails`	Store details object, Android only	The Google Play store details of the product, including the offers for purchasing the base plan (specified by `basePlanID`) for a subscription. Full description: Google Play product details.
`prettyPrice`	String	A localized price with currency symbol from Apple or Google, ready to display. For example, `$99.99`.

Deprecated fields

These fields are deprecated. Use the replacement field listed for each — new integrations should not read these.

Property	Type / values	Status	Description
`duration`	Enum: `unknown`, `weekly`, `monthly`, `3Months`, `6Months`, `annual`, iOS only	Deprecated — use `subscriptionPeriod`.	Duration of a product. `unknown` — non-renewable purchases. There is no 2-month option because Google Play does not have it.
`trialDuration`	Enum: `notAvailable`, `unknown`, `threeDays`, `week`, `twoWeeks`, `month`, `twoMonths`, `threeMonths`, `sixMonths`, `year`, `other`, iOS only	Deprecated — use `trialPeriod`.	Duration of an introductory offer. `notAvailable` — trial not available; `unknown` — no trial info; `other` — duration outside the enum range, check `skuDetails` or `skProduct` directly.
`skuDetail`	`skuDetails` object, Android only	Deprecated — use `storeDetails`.	The `skuDetails` object received from the Google Billing Client.

How to check trial and introductory offer eligibility

You can check whether a user is eligible for an introductory offer, including a free trial, before showing a price. Eligibility is computed differently per platform:

iOS — a user is eligible if they have not previously used an introductory offer for any product in the same subscription group.
Android — eligibility is computed from the store details. If the Google Play Billing Library returns any trial or intro offer as a possible purchase option for a product, the user is eligible for it.

Show only the regular price to users who are not eligible for an introductory offer. Use checkTrialIntroEligibility to determine eligibility:

Qonversion.shared().checkTrialIntroEligibility(["main", "secondary"]) { (result, error) in
  if let mainProductIntroEligibility = result["main"],
     mainProductIntroEligibility.status == .eligible {
     // handle available trial
  }
}

[[Qonversion sharedInstance] checkTrialIntroEligibility:@[@"main", @"secondary"] completion:^(NSDictionary<NSString *,QNIntroEligibility *> * _Nonnull result, NSError * _Nullable error) {
  QONIntroEligibility *mainProductEligibility = result[@"main"];
  if (mainProductEligibility && mainProductEligibility.status == QONIntroEligibilityStatusEligible) {
    // handle available trial
  }
}];

List<String> productIds = Arrays.asList("main", "secondary");
Qonversion.getSharedInstance().checkTrialIntroEligibility(productIds, new QonversionEligibilityCallback() {
    @Override
    public void onSuccess(@NotNull Map<String, QEligibility> eligibilities) {
        QEligibility mainProductEligibility = eligibilities.get("main");
        if (mainProductEligibility != null && mainProductEligibility.getStatus() == QIntroEligibilityStatus.Eligible) {
            // handle available trial
        }
    }

    @Override
    public void onError(@NotNull QonversionError error) {
        // handle error here
    }
});

Qonversion.shared.checkTrialIntroEligibility(listOf("main", "secondary"), object : QonversionEligibilityCallback {
    override fun onSuccess(eligibilities: Map<String, QEligibility>) {
        val mainProductEligibility = eligibilities["main"];
        if (mainProductEligibility != null && mainProductEligibility.status == QIntroEligibilityStatus.Eligible) {
            // handle result here
        }
    }

    override fun onError(error: QonversionError) {
        // handle error here
    }
})

try {
  final Map<String, QEligibility> eligibility = await Qonversion.getSharedInstance().checkTrialIntroEligibility(['main', 'premium']);
  final QEligibility mainProductStatus = eligibility['main'];
  if (mainProductStatus.status == QEligibilityStatus.eligible) {
      // handle available trial
  }
} catch (e) {
  print(e);
}

try {
    const eligibilityStatuses = await Qonversion.getSharedInstance().checkTrialIntroEligibility(['main', 'secondary']);
    const mainProductEligibility = eligibilityStatuses.get('main');
    if (mainProductEligibility && mainProductEligibility.status === IntroEligibilityStatus.ELIGIBLE) {
        // handle result here
    }
} catch (error) {
    // handle error here
}

string[] productIds = {"premium"};

Qonversion.GetSharedInstance().CheckTrialIntroEligibility(productIds, (eligibility, error) =>
{
    if (error == null)
    {
        if (eligibility.TryGetValue("premium", out Eligibility premiumEligibility) && premiumEligibility.Status == EligibilityStatus.Eligible)
        {
            // handle available eligibility
        }
    }
});

try {
    const eligibilityStatuses = await Qonversion.getSharedInstance().checkTrialIntroEligibility(['main', 'secondary']);
    const mainProductEligibility = eligibilityStatuses.get('main');
    if (mainProductEligibility && mainProductEligibility.status === Qonversion.IntroEligibilityStatus.ELIGIBLE) {
        // handle result here
    }
} catch (error) {
    // handle error here
}

try {
    const eligibilityStatuses = await Qonversion.getSharedInstance().checkTrialIntroEligibility(['main', 'secondary']);
    const mainProductEligibility = eligibilityStatuses.get('main');
    if (mainProductEligibility && mainProductEligibility.status === IntroEligibilityStatus.ELIGIBLE) {
        // handle result here
    }
} catch (error) {
    // handle error here
}

Overview

Get Started

Testing

Features

No-Code Builder

Remote Config

Experiments

Platform Resources

Stores Setup

SDK Migration Guides

AI-Ready

API Reference Guide

API Reference Guide v4

How to display products with the Qonversion SDK

Local cache

Get the list of available products

The Product object

How to check trial and introductory offer eligibility

​Local cache

​Get the list of available products

​The Product object

​How to check trial and introductory offer eligibility

Local cache

Get the list of available products

The Product object

How to check trial and introductory offer eligibility