Web2Wave #

Web2Wave is a lightweight Flutter package that provides a simple interface for managing user subscriptions and properties through a REST API.

Features #

• Fetch subscription status for users
• Check for active subscriptions
• Manage user properties
• Set third-parties profiles
• Thread-safe singleton design
• Async/await API support
• Built-in error handling

Installation #

Pub.dev #

Add the following to your pubspec.yaml file:

  web2wave: ^1.0.0

or run

  flutter pub add web2wave

Setup #

Before using Web2Wave, you need to configure API key:

  Web2Wave.shared.initialize(apiKey: 'your-api-key');

Usage #

Checking Subscription Status #

  // Fetch subscriptions
  final subscriptions = await Web2Wave.shared.fetchSubscriptions(web2waveUserId: 'userID');

  // Check if user has an active subscription
  final isActive = await Web2Wave.shared.hasActiveSubscription(web2waveUserId: 'userID');

External Subscription Cancel/Refund #

  // Cancel subscription in external Stripe/Paddle/PayPal
  final resultCancelSubscription = await Web2Wave.shared.cancelSubscription(
      paySystemId: 'sub_1PzNJzCsRq5tBi2bbfNsAf86 or I-H7HC902MYM49', comment: 'may be null');
  switch (resultCancelSubscription.isSuccess) {
    case true:
      print('Subscription canceled');
    case false:
      print(
          'Failed to cancel subscription with error - ${resultCancelSubscription.errorMessage}');
  }

  // Refund subscription with invoiceID in external Stripe/Paddle/PayPal
  final resultRefundSubscription = await Web2Wave.shared.refundSubscription(
      paySystemId: 'sub_1PzNJzCsRq5tBi2bbfNsAf86 or I-H7HC902MYM49',
      invoiceId: 'your_invoice_id',
      comment: 'may be null');
  switch (resultRefundSubscription.isSuccess) {
    case true:
      print('Subscription redunded');
    case false:
      print(
          'Failed to refund subscription with error - ${resultRefundSubscription.errorMessage}');
  }

Managing User Properties #

  // Fetch user properties
  final properties = await Web2Wave.shared.fetchUserProperties(web2waveUserId: 'userID');

  // Update a user property
  final result = await Web2Wave.shared.updateUserProperty(
      web2waveUserId: userID,
      property: 'preferredTheme',
      value: 'dark');

  switch (result.isSuccess) {
    case true:
      print('Property updated successfully');
    case false:
      print('Failed to update property with error - ${result.errorMessage}');
  }

Managing third-party profiles #

  // Save Adapty profileID
  final resultAdapty = await Web2Wave.shared.setAdaptyProfileID(
      web2waveUserId: userID,
      adaptyProfileId: "{adaptyProfileID}");

  switch (resultAdapty.isSuccess) {
    case true:
      print('Adapty profileID saved');
    case false:
      print(
          'Failed to save Adapty profileID with error - ${result.errorMessage}');
  }

  // Save Revenue Cat profileID
  final resultRevcat = await Web2Wave.shared.setRevenuecatProfileID(
      web2waveUserId: userID, revenuecatProfileId: "{revenueCatProfileID}");

  switch (resultRevcat.isSuccess) {
    case true:
      print('RevenueCat profileID saved');
    case false:
      print(
          'Failed to save RevenueCat profileID with error - ${result.errorMessage}');
  }

  // Save Qonversion profileID
  final resultQonversion = await Web2Wave.shared.setQonversionProfileID(
      web2waveUserId: userID,
      qonverionProfileId: "{qonversionProfileID}");

  switch (resultQonversion.isSuccess) {
    case true:
      print('Qonversion profileID saved');
    case false:
      print(
          'Failed to save Qonversion profileID with error - ${result.errorMessage}');
  }

Working with quiz or landing web page #

  //Extend Web2WaveWebListener class to recieve events
  class EventListener extends Web2WaveWebListener {
    @override
    void onEvent({required String event, Map<String, dynamic>? data}) {
      print("\n $event - [$data] \n");
    }

    @override
    void onClose(Map<String, dynamic>? data) {
      print("\n onClose - [$data] \n");
      Web2Wave.shared.closeWebPage();
    }

    @override
    void onQuizFinished(Map<String, dynamic>? data) {
      print("\n onQuizFinished - [$data] \n");
      Web2Wave.shared.closeWebPage();
    }
  }

  //Open web page with your url
  Web2Wave.shared.openWebPage(
            context: context,
            webPageURL: 'your-url',
            allowBackNavigation: true
            listener: EventListener())

  //Close web page
  Web2Wave.shared.closeWebPage();

API Reference #

Web2Wave.shared #

The singleton instance of the Web2Wave client.

Methods #

Future<List<dynamic>?> fetchSubscriptions({required String web2waveUserId})

Fetches the subscription status for a given user ID.

Future<bool> hasActiveSubscription({required String web2waveUserId})

Checks if the user has an active subscription (including trial status).

Future<Map<String, String>?> fetchUserProperties({required String web2waveUserId})

Retrieves all properties associated with a user.

Future<Web2WaveResponse> updateUserProperty({required String web2waveUserId, required String property, required String value})

Updates a specific property for a user.

Future<Web2WaveResponse> chargeUser({required String web2waveUserId, required int priceId})

Charge existing user with saved payment method

Future<Web2WaveResponse> cancelSubscription({required String paySystemId, String? comment})

Cancel external subscription

Future<Web2WaveResponse> refundSubscription({required String paySystemId, required String invoiceId, String? comment})

Refund external subscription

Future<Web2WaveResponse> setRevenuecatProfileID({required String web2waveUserId, required String revenuecatProfileId})

Set Revenuecat profileID

Future<Web2WaveResponse> setAdaptyProfileID({required String web2waveUserId, required String adaptyProfileId})

Set Adapty profileID

Future<Web2WaveResponse> setQonversionProfileID({required String web2waveUserId, required String qonverionProfileId})

Set Qonversion ProfileID

void openWebPage({required BuildContext context, required String webPageURL, required bool allowBackNavigation, Web2WaveWebListener? listener})

Open web quiz or landing page

void closeWebPage()

Close web quiz or landing page

Requirements #

• Flutter SDK >= 3.0.0

License #

MIT