When Products and Entitlements are set, you can start making purchases with the purchase() method (Swift) / purchaseWithResult: (Objective-C) on iOS, and purchase() on Android and the cross-platform SDKs.
Qonversion.shared().purchase(product) { (result) in if result.isSuccessful { if let premium: Qonversion.Entitlement = result.entitlements["premium"], premium.isActive { // Grant user access to premium features } } else if result.isCanceledByUser { // Handle canceled purchase } else if result.isPending { // Handle pending purchase } else { // Handle errors }}
Where “product” is the Qonversion Product created in the Dashboard. See the previous step to display Products.
Google Play Billing Library allows you to sell a subscription with different offers. You can get information about available offers from QProduct.storeDetails. Use one of the following options to provide the chosen offer for the purchase.
// Specify the concrete offer:final QProductOfferDetails productOfferDetails = ...; // Choose an offer from `storeDetails`final QPurchaseOptions purchaseOptions = new QPurchaseOptions.Builder() .setOffer(productOfferDetails) .build();// or specify only the offer ID:final QPurchaseOptions purchaseOptions = new QPurchaseOptions.Builder() .setOfferId("offer_id") .build();// and then provide created `QPurchaseOptions` to the `purchase` method:Qonversion.getSharedInstance().purchase(this, product, purchaseOptions, new QonversionPurchaseCallback() { ...});
If provided, we will try to find and purchase the offer with the specified ID for the requested Qonversion product. If there is no offer with the specified ID, an error will be returned. If no offer ID is provided for the subscription purchase of Qonversion product with a specified base plan ID, then we will choose the most profitable offer for the client from all the available offers. We calculate the cheapest price for the client by comparing all the trial or intro phases and the base plan. For old Qonversion products (where the base plan ID is not specified), as well as for in-app products, the offer ID is ignored.You can also remove any intro/trial offer from the purchase (to keep only a base plan). For that purpose, you should call removeOffer method of purchase options builder:
final QPurchaseOptions purchaseOptions = new QPurchaseOptions.Builder() .removeOffer() .build();
The purchase method returns a result object on every platform. Inspect its status flags - isSuccess / isCanceled / isPending (or IsSuccess / IsCanceled / IsPending on Unity) - and, when successful, look up the relevant entitlement on result.entitlements. See the per-platform examples above.Entitlement IDs are the keys to the entitlements map. The values are objects of the Qonversion.Entitlement class.
Upgrading, downgrading, or changing a subscription on Google Play Store requires setting additional options through the PurchaseOptions builder. See Google Play Documentation for more details.
final QPurchaseOptions purchaseOptions = new QPurchaseOptions.Builder() .setOldProduct(oldProduct) .build();Qonversion.getSharedInstance().purchase(this, product, purchaseOptions, new QonversionPurchaseCallback() { ...});
Also, Qonversion supports providing any replacement mode for the old purchase. Just provide the necessary purchase update policy while building purchase options as follows:
final QPurchaseOptions purchaseOptions = new QPurchaseOptions.Builder() .setOldProduct(oldProduct) .setUpdatePolicy(QPurchaseUpdatePolicy.WithTimeProration) .build();
Purchase update policy can be one of the following values:
Name
Description
ChargeFullPrice
The new plan takes effect immediately, and the user is charged full price of new plan and is given a full billing cycle of subscription, plus remaining prorated time from the old plan.
ChargeProratedPrice
The new plan takes effect immediately, and the billing cycle remains the same.
WithTimeProration
The new plan takes effect immediately, and the remaining time will be prorated and credited to the user.
Deferred
The new purchase takes effect immediately, the new plan will take effect when the old item expires.
WithoutProration
The new plan takes effect immediately, and the new price will be charged on next recurrence time.
When buying in-app products, you have the option to choose how many items you want to purchase. On Android, you can adjust the quantity directly in the purchase pop-up. However, on iOS, you’ll need to set the quantity beforehand. You can do it while building purchase options as follows:
let purchaseOptions = Qonversion.PurchaseOptions(quantity: quantity)Qonversion.shared().purchase(product, options: purchaseOptions) { (result) in ...}
When users, for example, upgrade to a new phone, they need to restore purchases so they can keep access to your premium features.Call the restore() method to restore purchases:
Qonversion.shared().restore { [weak self] (entitlements, error) in if let error = error { // Handle error } if let entitlement: Qonversion.Entitlement = entitlements["plus"], entitlement.isActive { // Restored and entitlement is active }}
How to handle consumable in-app purchases in your application.Since consumable in-app purchases do not make sense to tie to a specific entitlement, when making a purchase, you only need to look at the purchase outcome (success/error). If there is an error, do not grant bonuses for the consumable purchase; if the purchase is successful, then grant bonuses. Let’s go through the scenario step by step:
The customer initiates the consumable in-app purchase.
You call the Qonversion purchase method.
You receive a response after the purchase is made.
Is the response successful? Grant the user bonuses.
Was there an error? No bonuses should be granted.
On iOS and Android, you can also use the purchased transaction from the store.
Qonversion.shared().purchase(product) { (result) in if result.isSuccessful { // Grant coins here // Also check the store transaction if necessary if let transaction = result.transaction { } } else if result.isCanceledByUser { // Handle canceled purchase } else if result.isPending { // Handle pending purchase } else { // Handle errors }}