Android In-App Products Setup

🚧

Google Play Billing Library 5.0 Update

We are working on supporting updates announced during Google IO 2022.

  • Please do not use new subscription features, including multiple offers and base plans per subscription or a multi-quantity pricing model.

  • Existing products will continue to work as Google has updated existing subscription products to the new format with backward compatibility.

The Backwards Compatible features mentioned in the Google Play Console with the "Backwards Compatible" badge will continue to work. You can create a new subscription or new subscription with a free trial, but you shouldn't add more than one offer or base plan to a subscription until we release support for these features.

Feel free to contact us if you have any questions.

📘

Creating in-app products before granting users access or linking Google Cloud Project to the service account may cause problems with the receipt validation using Google Play Developer API. Google Play Developer API can return the following error "The current user has insufficient permissions to perform the requested operation."

When encountering this issue, open the In-app products or Subscription tab respectively on the Google Play Console and make any updates. For example, edit the product description and save it.

In order to create an in-app purchase navigate to Google Play Developer Console and select the 'All apps' tab. Then select your app from the list.

16401640

Select Products. You can select either In-app products or Subscriptions.

14141414

1. In-app products

Let's choose the In-app products tab. Click the Create product button. You have to provide Product ID, Name, and Description.

18441844

🚧

Note

You can’t change the product ID after the product has been created.

Set the price at the bottom of the page and apply changes.

17921792

🚧

Note

Qonversion doesn't yet support multi-quantity purchases, so leave that option unselected.

Finally, check the tax and compliance settings and then click Save.

18501850

Once you have created a product, it has an Inactive status. Click the Activate button.

15761576 22802280

2. Subscriptions

Let's choose the Subscriptions tab. Click the Create subscription button. Provide Product ID and Name.

12241224

Now the subscription is created but it is not configured yet. There are four steps to configure it. Two of them are optional.

14621462

The first step is optional. You can add up to four custom strings explaining what users get when they subscribe.

18241824

For the next two steps, you should create base plans and offers, if necessary. The base plan contains basic information about the subscription such as duration, price, renewal type, grace period, etc.

🚧

Multiple base plans and offers are not yet supported

Qonversion does not currently support multiple base plans and offers. To use a subscription with Qonversion, make sure it has one backward compatible base plan, which also may not have more than one backward compatible offer. All other plans and offers for the same subscription will be ignored.

📘

You can check our blog post for the details of the new subscription model of Google Play.

To create a base plan click Add a base plan either from the task list or from the base plans and offers section.

27902790

Enter the base plan identifier and configure its renewal type with billing and grace periods. You may also add tags that are used to distinguish base plans from the API side. This is not required with one base plan per subscription.

16941694

The last step is to set the price. Navigate to Prices and availability section and click Set prices, select regions the subscription will be available in and press Set price.

28582858

Enter the price and click Update. Save changes.

852852

Once you have created a base plan, it has a draft status. Click the Activate button to make it available to users.

28382838

Your base plan is ready to use.

27842784

You can use the created subscription. You can also add options like a trial period or discounts to your subscriptions. This is where offers come in. Offers belong to base plans.

🚧

Multiple offers are not supported

Qonversion does not yet support multiple offers. Only one backward compatible base plan and one backward compatible offer for that base plan is supported at the moment.

Click Add offer to create an offer .

27822782

Select the base plan to which the new offer will belong and click Add offer.

12181218

Specify offer identifier and select eligibility criteria. There are several options available: users who never bought this or any other subscriptions; those, who upgraded from other subscriptions; developer-determined.

🚧

Developer-determined criteria is backward-incompatible and thus can not be used with Qonversion.

You may also add tags as for the base plan.

18961896

The final step is phases. You can configure up to two phases which will be used before the base plan purchasing. For example, you can add a free trial for a week and a 10% discount for the next week before the user will buy the original subscription.
To create a phase click the Add phase button in the Phases section.

28082808

Choose the phase type, duration, and, if you chose discount type, prices. In the example below we create a 10% discount price for a week.

34003400

Press Apply and Save to create an offer. The offer has a draft status. Press Activate.

28462846

After you have done all the above steps your subscription is ready to use. Make sure you have Backwards compatible tags for both the base plan and offer, if it exists.

28042804