Flutter – Subscription Status

Learn how to get info about user subscription status and grant access to the premium features of the app using Adapty iOS SDK

With Adapty you don't have to hardcode product ids to check subscription status. You just have to verify that the user has an active access level. To do this, you have to call .getProfile() method:

try {
  final profile = await Adapty().getProfile();
  // check the access
} on AdaptyError catch (adaptyError) {
  // handle the error
} catch (e) {
}

Response parameters:

  • Profile: an AdaptyProfile object. This model contains info about access levels, subscriptions, and non-subscription purchases. Generally, you have to check only access level status to determine whether the user has premium access to the app.

📘

The .getProfile method provides the most up-to-date result as it always tries to query the API. If for some reason (e.g. no internet connection), the Adapty SDK fails to retrieve information from the server, the data from cache will be returned. It is also important to note that the Adapty SDK updates AdaptyProfile cache on a regular basis, in order to keep this information as up-to-date as possible.

Below is a complete example of checking the user's access level.

try {
  final profile = await Adapty().getProfile();
  if (profile?.accessLevels['premium']?.isActive ?? false) {
        // grant access to premium features
    }
} on AdaptyError catch (adaptyError) {
  // handle the error
} catch (e) {
}

📘

You can have multiple access levels per app. For example, if you have a newspaper app and sell subscriptions to different topics independently, you can create access levels "sports" and "science". But most of the time, you will only need one access level, in that case, you can just use the default "premium" access level.

Read more about access levels in the Access Level section.

Listening for subscription status updates

In order to receive messages from Adapty, you need to subscribe for a stream. Whenever the user's subscription changes, Adapty will fire an event. This stream will also produce an event at the start of the application, and the cached profile will get into it:

Adapty().didUpdateProfileStream.listen((profile) {
  // handle any changes to subscription state
});

🚧

Make sure to set up App Store Server Notifications to receive subscription updates without significant delays.