Displaying Products

Qonversion SDK provides flexible cross-platform in-app purchase management for your app. You don’t need to save App Stores product IDs and respective prices on the client side. To manage in-app products promoted in your app from the Qonversion dashboard, you need to configure Products and Entitlements in Qonversion. Once you have everything configured, Qonversion provides the following ways of displaying products:

with a Remote Config holding your product IDs (recommended) — change products offered to your users without app release, target user segments, and run A/B tests. See the recommended payload structure and code samples.
with Qonversion Products directly — see Get The List of Available Products below

Local cache

Qonversion SDK caches the data on products and entitlements. This data is available when the internet connection is lost or there are server-side delays. Every time your application launches, SDK requests actual SkProduct/SkuDetails from the App Store or Google Play to get the most up-to-date product data.

Get The List of Available Products

Use the products method to get the list of the products available:

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 method returns the following two vars:

productsList – dictionary with available products
error - error

Qonversion Product IDs are the keys to the products’ dictionary objects. The values are the objects of the Qonversion.Product class. Qonversion.Product contains the following data:

Property	Description
`qonversionID`	Qonversion product ID. For example, main
`storeID`	App Stores Product ID
`basePlanID`	Android only. Identifier of the base plan for subscription product.
`type`	Product type. Values: 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.
`duration` (deprecated)	iOS only. Duration of a product. Values: unknown – non-renewable purchases; weekly; monthly; 3Months; 6Months; annual. Note: there is no 2-month duration option since Google Play does not have it. Deprecated: use `subscriptionPeriod` instead.
`subscriptionPeriod`	Subscription period for the product. Nil if the product is not a subscription. `SubscriptionPeriod` object contains two fields: `SubscriptionPeriodUnit`that may be `day/week/month/year`and Integer`unitCount`. For example, `SubscriptionPeriodUnit = .month` and `unitCount = 3` indicate that the subscription duration is 3 months. On Android and Cross-platform SDKs, there is also an `iso` field representing duration in ISO 8601 format, e.g. “P3M” for the above example.
`trialDuration` (deprecated)	iOS only. Duration of an introductory offer. Values: notAvailable – trial not available; unknown – no trial info; threeDays; week; twoWeeks; month; twoMonths; threeMonths; sixMonths; year; other – duration not in enum range, check `skuDetails` or `skProduct` directly. Deprecated: use `trialPeriod` instead.
`trialPeriod`	Trial period for the product. Nil if the product is not a subscription or trial not available. `SubscriptionPeriod` object contains two fields: `SubscriptionPeriodUnit`that may be `day/week/month/year`and Integer`unitCount`. For example, `SubscriptionPeriodUnit = .day` and `unitCount = 7` indicate that the trial duration is 7 days. On Android and Cross-platform SDKs, there is also an `iso` field representing duration in ISO 8601 format, e.g. “P3M” for the above example.
`skProduct`	iOS only. Contains `SKProduct` object received from StoreKit.
`skuDetail`	Android only. Contains skuDetails object received from Google Billing Client. Deprecated: use `storeDetails` instead.
`storeDetails`	Android only. Describes the store details of the product, containing all the information from Google Play including the offers for purchasing the base plan of this product (specified by `basePlanID`) in case of a subscription. The complete description can be found on this page.
`prettyPrice`	A localized product price with currency symbol provided by Apple or Google. It can be displayed to a user. For example, $99.99

Trial and introductory offer eligibility

You can check if a user is eligible for an introductory offer, including a free trial. It is calculated differently for iOS and Android users. On iOS, users who have not previously used an introductory offer for any products in the same subscription group are eligible for an introductory offer. On Android, eligibility is computed based on the store details. If Google Play Billing Library returned any of the trial or intro offers as a possible purchase option for a specific product, then it means that the user is eligible for it. You can show only a regular price for users not eligible for an introductory offer. Use the following function 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
}

Create Products Making Purchases

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

Local cache

Get The List of Available Products

Trial and introductory offer eligibility

​Local cache

​Get The List of Available Products

​Trial and introductory offer eligibility

Local cache

Get The List of Available Products

Trial and introductory offer eligibility