Handling Deep Links

3. Web Checkout Post-Checkout Redirecting

You can deep link into your app with URL Schemes, Universal Links on iOS, or Android App Links on Android.

iOS

Open Xcode. In your info.plist, add a row called URL Types. Expand the automatically created Item 0, and inside the URL identifier value field, type your Bundle ID, e.g., com.superwall.Superwall-SwiftUI. Add another row to Item 0 called URL Schemes and set its Item 0 to a URL scheme you'd like to use for your app, e.g., exampleapp. Your structure should look like this:

With this example, the app will open in response to a deep link with the format exampleapp://. You can view Apple's documentation to learn more about custom URL schemes.

Android

Add the following to your AndroidManifest.xml file:

<activity android:name=".MainActivity">
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <data android:scheme="exampleapp" />
    </intent-filter>
</activity>

This configuration allows your app to open in response to a deep link with the format exampleapp:// from your MainActivity class.

Adding a Universal Link (iOS only)

Before configuring in your app, first create and configure your Stripe app on the Superwall Dashboard.

Add a new capability in Xcode

Select your target in Xcode, then select the Signing & Capabilities tab. Click on the + Capability button and select Associated Domains. This will add a new capability to your app.

Set the domain

Next, enter in the domain using the format applinks:[your-web-checkout-url]. This is the domain that Superwall will use to handle universal links. Your your-web-checkout-url value should match what's under the "Web Paywall Domain" section.

Testing

You can verify that your universal links are working a few different ways. Keep in mind that it usually takes a few minutes for the associated domain file to propagate:

1. Use Branch's online validator: If you visit branch.io's online validator and enter in your web checkout URL, it'll run a similar check and provide the same output.

2. Test opening a universal link: If the validation passes from either of the two steps above, make sure visiting a universal link opens your app. Your link should be formatted as https://[your web checkout link]/app-link/ — which is simply your web checkout link with /app-link/ at the end. This is easiest to test on device, since you have to tap an actual link instead of visiting one directly in Safari or another browser. In the iOS simulator, adding the link in the Reminders app works too:

In your pubspec.yaml file, add the uni_links package to your dependencies:

dependencies:
  uni_links: ^0.5.1

Then, run flutter pub get to install the package. Next, in your Flutter app, use the Superwall SDK to handle the deep link via Superwall.shared.handleDeepLink(theLink);. Here's a complete example:

import 'package:flutter/material.dart';
import 'package:superwallkit_flutter/superwallkit_flutter.dart';
import 'package:uni_links/uni_links.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatefulWidget {
  MyApp();

  @override
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  @override
  void initState() {
    super.initState();
    Superwall.configure('YOUR_SUPERWALL_API_KEY');
    _handleIncomingLinks();
  }

  void _handleIncomingLinks() {
    uriLinkStream.listen((Uri? uri) {
      if (uri != null) {
        Superwall.shared.handleDeepLink(uri);
      }
    }, onError: (Object err) {
      print('Error receiving incoming link: $err');
    });
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        body: Center(
          child: Text(
            'Deep Link Preview Example',
            style: TextStyle(fontSize: 24),
          ),
        ),
      ),
    );
  }
}

Handling Android App Links

Android App Links let the redemption link from a web checkout purchase open your Android app directly. Redeeming through App Links requires Flutter SDK 2.4.3 or later.

1. In your Stripe app's settings, fill in the Android configuration, including the SHA-256 fingerprints of your app's signing keys.
2. In android/app/src/main/AndroidManifest.xml, add this intent filter inside your main <activity> tag. Replace the host with your web paywall domain:

<intent-filter android:autoVerify="true">
    <action android:name="android.intent.action.VIEW" />

    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />

    <data android:scheme="https" />
    <data android:host="yourappdomain.superwall.app"
          android:pathPrefix="/redeem" />
</intent-filter>

3. Keep passing incoming links to Superwall.shared.handleDeepLink, as shown in Handling Deep Links. App Links arrive through the same link stream. Also pass the link that launched your app, from getInitialUri(), so a redemption link opened from a closed app is handled too.

Superwall generates the assetlinks.json file that Android uses to verify the link. To check it, open https://yourappdomain.superwall.app/.well-known/assetlinks.json.

• Handling Deep Links — Use handleDeepLink with the deepLink_open standard placement and dashboard campaign rules to present paywalls from deep links, without hardcoding routing logic in your app.
• Using Superwall Deep Links — Trigger paywalls or custom in-app behavior using Superwall-hosted URLs at *.superwall.app/app-link/....