In-App Subscriptions with Flutter - RevenueCat (2023)

Learn how to set up monthly and yearly subscriptions for a Flutter app in this complete guide to setting up Flutter subscriptions. We'll learn how to use RevenueCat to configure subscriptions for iOS and Android.

A major benefit of using RevenueCat is that it acts as a single source of information about a user's subscription status. You also don't have to worry about validating purchases or managing servers - which can be tedious and complicated.

Let's start!

Step 1: Setup

This tutorial uses theMagicWeatherExample RevenueCat Flutter applicationMarkets are soaringrepo To participate, you must clone the full repository and open the sample project.

Clone the repo as follows:

Git-Klon git@github.com:RevenueCat/purchases-flutter.git

Then open the project in Android Studio or VSCode. This tutorial uses Android Studio. After opening Android Studio, clickOpenClick the button and select itMarkets are soaringfolder you just created.

Note: If you don't already have Flutter installed in your code editor,Follow this guideto set up your development environment.

Open the terminal in Android Studio and run the following command:

He received flattery

You can now run the sample MagicWeather application that looks like the image below. This tutorial focuses on iOS and Android in-app subscriptions, so both types of devices will be used for testing.

Note: The MagicWeather sample app contains examples of using the Amazon app store. However, this tutorial only focuses on Google Play Store subscriptions for Android.

Note: The MagicWeather sample app provides a complete example of configuring subscriptions in Flutter. Step 6 below gives you more details on how to create a paywall and add subscriptions to your app.

Step 2: Configure the constants

RevenueCat Entitlement ID

clickAdd to, and your permission should now appear on the Permissions page.

Back to MagicWeather codebase, updateEntitlement IDimlib/src/constant.dartFile to match your new entitlement ID.

1compEntitlement ID= 'Gift';

App Store API Key

Start clickingApp StoreLink under Apps tab:

Fill in the three required fields and clickSave the changes.The You can find the package ID by opening the project in Xcode and clickingrunnertab on the left. In accordance withGenerallyIn the tab you will find itBundle-ID. If you're using the MagicWeather sample app, you'll need to change the package ID to a unique number:

Follow this guideto create itApp Store Connect shared secret for specific app:

Once the application is created, an API key is automatically generated. Navigate toAPI keysection in RevenueCat and copy the new oneapplication-specific public API keyfor the iOS app:

Update itappleApiKeyimlib/src/constant.dartFile with the new public API key you just copied:

1compappleApiKey= 'APPLE_API_KEY';

Google Play API Key

Start clickingLoad the gameLink under Apps tab:

Fill in the three required fields and clicksave the changes. For the Google Play package, seedefaultConfigimandroid/app/build.gradleFile. If you are using the MagicWeather sample app, you need to change the package name to something unique.Follow this guideTo generate the JSON credentials for the service account:

Once the app is built, the API key will be generated automatically. Navigate toAPI keyExtract and copy the new app-specific public API key for your Android app:

Update itgoogleApiKeyimlib/src/constant.dartFile with the new public API key you just copied:

1compgoogleApiKey= 'ANDROID_API_KEY';

Footer

The last constant you need to update tolib/src/constant.dartfile is theFooter. Learn more about what footer text is and what to includeHere. Setup for this tutorialFooterIn the following:

1compFooter= "" A purchase will be credited to your account once the selected amount is confirmed. Subscriptions automatically renew unless canceled within 24 hours of the end of the current period. You can cancel at any time through your account settings. Any unused portion of a free trial will be forfeited when you purchase a subscription.;

Step 3: Set up subscriptions

With RevenueCat we can organize all our products in one place and then decide which products to offer in our app. For more information on how it works, seethis article.

Simply put, we add subscription products to App Store Connect and Google Play, connect those products to RevenueCat, then package similar products and use them as part of an offer. The offer is what is ultimately presented to the user to buy.

Product setup

First, you need to add the subscriptions for both App Store Connect and Google Play. For this example, we'll add two different subscription types: one for a monthly subscription and one for an annual subscription. Both App Store Connect and Google Play must be configured with both subscriptions using the following information:

• Premium Month:
  • Product ID: rc_premium_month
  • Price: $9.99
• Premium year:
  • Product ID: rc_premium_year
  • Price: $99.99

If you need help setting up products in each store, see the guides below:

• iOS / App Store connection
• Android / Google Play Console

Note: You can complete the setup later with reviewer information. Now it's a matter of creating subscriptions and creating product IDs.

After creating the products in each store, your views should look something like this:

Configure products in RevenueCat

Now that you have set up the products in the stores, you can follow alongthis guideto add any product to the RevenueCat dashboard. After adding the products to RevenueCat, theProductsThe tab should look something like this:

Once all products are in RevenueCat, go to the entitlement you set up earliergift. A findLinked productsand clickconnect,afterward attach. Annex all four products. After that, the license should look something like this:

Create the offer

Follow alongthis guideto create a standard offer with two different packages. One package includes the monthly subscriptions for iOS and Android, while the second includes the annual subscriptions. The default offer should look something like this:

Note: When testing on an Android emulator, you must sign in to Google Play on the test device. If you're still getting errors when retrieving offers, make sure your app is on a test run. If you have further problems,read this.

Step 4: Try in-app subscriptions in Flutter

Now that the subscriptions are set up, we can make a test purchase. However, you need to create demo accounts first to make the purchase:

• Follow this guide for iOS
• Follow this guide for Android

Note: If you configure your own application, you must add itIn-app purchaseability in Xcode. To readthis articleLearn more about adding features to your app here.

Confirm that the purchase has been entered into RevenueCat by going toDashboard overviewand clicksandbox databox top right. You should see that you have an active subscription:

Note: Although emulator testing is possible, we recommend using a physical device.

Step 5: Renew in-app subscriptions in Flutter

iOS

A few steps are required to get it working properly. First, let's update the iOS test user to automatically refresh every 5 minutes. This is not required, but speeds up testing.

Note: The expiration time changed as we changed the test user from 1 hour to 5 minutes.

Android

Step 6: Understand how the sample application works

We have now configured the subscriptions for the MagicWeather app and they are working. This is a great example of a Flutter app whose features are hidden behind a paywall. In this section, we break down some of the core functionality of the sample app and show you how to apply the same concepts to your own app.

Note: The code below was taken from the sample app and modified. for a complete picture of how it all works,Check out the repo.

Configure the package in your application

Install itbuys_flutterPackage in your app to access RevenueCat. Next, configure the application to use the package. To do this, you can copy some files from the sample application to use in your own application.

Create the file lib/src/constant.dartand define the following constants. I seeStep 2: Configure the constantsFor more information on setting constants, see here.

1compEntitlement ID= "ENTITLEMENT_ID";2compFooter= 'LEG LINES';3compappleApiKey= 'APPLE_API_KEY';4compgoogleApiKey= "GOOGLE_API_KEY";

Create the filelib/store_config.dart and add the following code. This file defines theStoreConfigClass used to configure the iOS or Android store:

1Introduction 'Paket:flutter/foundation.dart';23count Save to computer {Apple Laden,Google Play}45Class StoreConfig {6 Final Save to computersave to computer;7 Final seriesAPI key;8 static StoreConfig_Example;910 Fabric StoreConfig({@necessary Save to computersave to computer, @necessary seriesAPI key}) {11_Example??= StoreConfig._Keep(save to computer,API key);12 turning around_Example;13 }1415 StoreConfig._Keep(The.save to computer, The.API key);1617 static StoreConfig receiveExample{18 turning around_Example;19 }2021 staticboolisForAppleStore() =>_Example.save to computer== Save to computer.Apple Laden;2223 staticboolisForGooglePlay() =>_Example.save to computer== Save to computer.Google Play;24}

now openmain.arrowand configure the store based on device type. Don't forget to enterstore_config.dartAndfixed.arrow.

1Empty first of all() {// Add this if/else block to configure the correct memory2 If (platform.isiOS) {3 StoreConfig(4save to computer: Save to computer.Apple Laden,5API key:appleApiKey,6 );7 } anders If (platform.istAndroid) {8 StoreConfig(9save to computer: Save to computer.Google Play,10API key:googleApiKey,11 );12 }13 runApp(comp MagicWeatherFlutter());14}

The app is now ready to use RevenueCat! MagicWeather uses a simple class to store some values ​​that are specific to the current instance of the application. These values ​​could be stored in a database like Firebase, but for this example create a new file namedlib/src/model/app_data.dart and add the following code.

1Class App Data {2 static Final App Data_App Data= App Data._Keep();34bool entitlementIsActive= INACCURATE;5 seriesappUserID= '';67 Fabric App Data() {8 turning around_App Data;9 }10 App Data._Keep();11}1213FinalApp Data= App Data();

Note: MagicWeather uses this class to store the current temperature displayed to the user. In most cases you don't need this AppData class and instead store this information in a database.

Create your own paywall

The MagicWeather sample app has only one button: WhenChange the weatherWhen clicked and the user has a premium subscription, the app will change the temperature randomly. Likewise, your app likely has buttons that allow additional functionality if the user has a subscription. If the user is not registered, the button should show a paywall for the user to login.

Create a new file named lib/src/views/paywall.dartHere you can create your individual paywall. The code below shows a modified version of MagicWeather. The following important areas should be included:

• The widget is prepared with a required initializationSpecial offer.
• There is oneListView.builderThis will display all the products on offer.
• TheFooterexposed.

1Introduction 'Paket:flutter/material.dart';2Introduction 'Paket:purchases_flutter/purchases_flutter.dart';3Introduction 'Package:[YOUR_APP]/src/constant.dart';4Introduction 'Package:[YOUR_APP]/src/model/singletons_data.dart';56Class Paywall developed StatefulWidget {7 Final Special offerSpecial offer;89 comp Paywall({TasteTaste, @necessary The.Special offer}) : super(Taste:Taste);1011 @trample12_PaywallStateCreateState() => _PaywallState();13}1415Class_PaywallStatedeveloped Condition<Paywall> {16 @trample17 Widget build(BuildContextcontext) {18 turning around SingleChildScrollView(19Kind: Safe area(20Kind: Cover(21Kinder: <Widget>[22 Container(23Height: 70,0,24Wide:double.infinity,25decoration: comp Box decoration(Colour: Colored.Schwarz),26Kind: comp Centre(Kind: Text('APP NAME'))),27 comp wallpaper(28wallpaper:29 EdgeInsets.only(Blouse: 32,bottom: 16,connections: 16.0,Right: 16.0),30Kind: SizedBox(31Kind: Text('GIFT'),32Wide:double.infinity,33 ),34 ),35 list view.Baumeister(36number of tracks:Widget.Special offer.packages available.Long,37itemBuilder: (BuildContextcontext,int-Index) {38 Warmyproductlist=Widget.Special offer.packages available;39 turning around Map(40Colour: Colored.Schwarz,41Kind: ListTile(42in the tap: () asynchronous {43 attempt {44 customer informationcustomer information=45 expect shopping.purchase package(46myproductlist[Index]);47App Data.rightIsActive=customer information48 .expectations.in the[Entitlement ID].is active;49 } arrest (m) {50 type(m);51 }5253 setState(() {});54 Pilot.Crotos(context);55 },56title: Text(57myproductlist[Index].storeProduct.title,58 ),59subtitle: Text(60myproductlist[Index].storeProduct.Description,61 ),62after: Text(63myproductlist[Index].storeProduct.value string,64 ),65 ),66 );67 },68shrink wrap: TRUE,69physics: comp ClampingScrollPhysics(),70 ),71 comp wallpaper(72wallpaper:73 EdgeInsets.only(Blouse: 32,bottom: 16,connections: 16.0,Right: 16.0),74Kind: SizedBox(75Kind: Text(76Footer,77 ),78Wide:double.infinity,79 ),80 ),81 ],82 ),83 ),84 );85 }86}

View paywall based on subscription status

Now we have created the paywall view. Then we can display it conditionally depending on whether the current user is logged in or not. You can use the following line of code to get the current user's information from RevenueCat.

The code must be placed in the view containing the button that conditionally shows the premium feature or paywall to the user. Check how this is used in the sample applicationHere.

1​​customer informationcustomer information= expect shopping.getCustomerInfo();

To check if the user has an active subscription, use the following if/else statement. Note the use of EntitlementID here: this is the value we set tofixed.arrowfile earlier.

1If (customer information.expectations.in the[Entitlement ID] != Zero &&2customer information.expectations.in the[Entitlement ID].is active== TRUE) {3 // The user has a subscription, show them the function4} anders {5 // show paywall6}

Remember that the paywall requires an offer. So in order to show the paywall, we need to secure our offers first. Add this code to the else block where we will display the paywall.

1OffersOffers;2attempt {3Offers= expect shopping.getOfferings();4} One PlatformException arrest (m) {5 // Error finding the offers, fix the error.6}

Now that the offers are defined, we can go to the paywall view. In this example we will use a bottom leaf modal. Add the code below to set the offers.

Note that we persistOffers.currenton the pay wall; You can create multiple offers in the RevenueCat dashboard, but only one will be marked as current. This is very useful as you can change your offer in RevenueCat and your app will update without needing to reorder.

1If (Offers== Zero ||Offers.drift== Zero) {2 // Offers are empty, display a message to your user3} anders {4 // Current offer available, show paywall5 expect showModalBottomSheet(6Use RootNavigator: TRUE,7is rejected: TRUE,8isScrollControlled: TRUE,9background color: Colored.Schwarz,10Form: comp Rounded Rectangle Border(11boundary radius: BorderRadius.Vertical(Blouse: Radius.circular(25.0)),12 ),13context:context,14Baumeister: (BuildContextcontext) {15 turning around StatefulBuilder(16Baumeister: (BuildContextcontext, StateSettersetModalState) {17 turning around Paywall(18Special offer:Offers.drift,19 );20 });21 },22 );23}

Now you know how to set up a subscription paywall in your app. There is only one premium feature in this example, but you can easily add the same conditional logic to multiple areas of your app.

Because we haven't hard-coded any subscription or product IDs, it's easy to change what the entitlement ID provides access to. If your application is more complex, you could have multiple permission IDs that provide access to different functions.

restore purchases

Allowing users to restore their purchases anywhere in your app is essential. RevenueCat makes this super easy: The code below adds a "Restore Purchases" button. You must provide the followingbuys_flutterpackage in the file to make this work.

1TextButton(2onPressed: () asynchronous {3 expect shopping.restore purchases();4 },5Kind: Text("Restore Purchases"),6)

Final thoughts

Now you haveRecords configured in the Flutter appthis works for both iOS and Android. RevenueCat takes care of complex validation of purchases and gives you a single source of information about a user's subscription status.

A lot has been covered in this tutorial, but there are also several other features of RevenueCat that you can take advantage of. See the whole thingDocumentationto learn more. When you are ready to deploy, follow the steps inChecklist to get you startedto make sure everything is complete and ready to go.