Implement web paywalls in Android SDK

important

Before you begin, make sure you have configured your web paywall in the dashboard and installed Adapty SDK version 3.15 or later.

Open web paywalls

If you are working with a paywall you developed yourself, you need to handle web paywalls using the SDK method. The .openWebPaywall method:

1. Generates a unique URL allowing Adapty to link a specific paywall shown to a particular user to the web page they are redirected to.
2. Tracks when your users return to the app and then requests .getProfile at short intervals to determine whether the profile access rights have been updated.

This way, if the payment has been successful and access rights have been updated, the subscription activates in the app almost immediately.

note

After users return to the app, refresh the UI to reflect the profile updates. Adapty will receive and process profile update events.

Adapty.openWebPaywall(
    activity = activity,
    product = product,
) { error ->
    if (error == null) {
        // the web paywall was opened successfully
    } else {
        // handle the error
    }
}

note

There are two versions of the openWebPaywall method:

1. openWebPaywall(product) that generates URLs by paywall and adds the product data to URLs as well.
2. openWebPaywall(paywall) that generates URLs by paywall without adding the product data to URLs. Use it when your products in the Adapty paywall differ from those in the web paywall.

Open web paywalls in an in-app browser

By default, web paywalls open in the external browser.

To provide a seamless user experience, you can open web paywalls in an in-app browser. This displays the web purchase page within your application, allowing users to complete transactions without switching apps.

To enable this, set the presentation parameter to AdaptyWebPresentation.InAppBrowser:

Adapty.openWebPaywall(
    activity = activity,
    product = product,
    presentation = AdaptyWebPresentation.InAppBrowser,
) { error ->
    if (error == null) {
        // the web paywall was opened successfully
    } else {
        // handle the error
        val adaptyError = error
    }
}