The web2wave Mobile SDK helps you synchronize data between your web funnel and mobile application without building the direct integration from raw API calls.

The SDK is a lightweight wrapper around our API. It helps you avoid bugs caused by incorrect parameter passing, misunderstandings of platform logic, and manual setup work. It helps your integration follow platform best practices and can reduce setup time from several days to a few hours by providing ready-made methods.

📘
Installing the SDK is not mandatory for launch. You can choose either direct HTTP requests to our API or the SDK if you prefer not to add additional dependencies to your project.

General flow

Mandatory steps

Install the package
Add the SDK through your stack's package manager: Gradle, SPM, pub.dev, npm, or Unity Package Manager.
Initialize the SDK
Call initialize(apiKey) or initWith(apiKey) on app launch to set your API key. Do this once before any other SDK calls.
Get user_id
Extract the user_id from the deeplink the user arrived through. If the deeplink is unavailable and your SDK supports identify() (Flutter only), call it as a fallback to resolve the user ID through device fingerprinting.

Optional: Additional steps

Link third-party profiles
If you use Adapty, RevenueCat, or Qonversion, pass your paywall system's profileID to web2wave through setAdaptyProfileID, setRevenuecatProfileID, or setQonversionProfileID. This associates the user across systems.
Check subscription status
Call hasActiveSubscription(userID) and show the appropriate screen based on the result: locked content or a paywall.
Open a web page
To display a quiz or landing page inside the app, use showWebView or openWebPage, passing the URL and a listener to handle close events.
Manage subscriptions
Handle cancellation, refund, or re-charge through cancelSubscription, refundSubscription, and chargeUser with the corresponding Stripe, Paddle, or PayPal identifiers.

Key features

Subscription status retrieval
Active subscription check
User properties management
User identification via device fingerprinting (Flutter SDK only)
Third-party profile binding (Adapty, RevenueCat, Qonversion)
External subscription cancellation and refund (Stripe, Paddle, PayPal)
User charge via saved payment method
In-app web page, quiz, or landing page display
Web page event handling

Available SDKs

Repository: web2wave/web2wave_swift

A Swift Package Manager (SPM) library designed for UIKit-based iOS apps. SwiftUI apps can use the SDK, but WebView methods require a UIViewControllerRepresentable wrapper because they are UIKit-based.

Requirements

iOS 13.0+
macOS 10.15+
Swift 5.5+
Xcode 13.0+

Important: This SDK is under development and currently does not support user subscription refund or cancellation.