ZeroSettle for Flutter

The official Flutter plugin for ZeroSettle — Merchant of Record infrastructure for mobile developers.

ZeroSettle lets you process payments via web checkout while we handle sales tax, VAT, compliance, and liability as the Merchant of Record.

Installation

From pub.dev

dependencies:
  zerosettle: ^0.0.1

From Git

dependencies:
  zerosettle:
    git:
      url: https://github.com/zerosettle/ZeroSettle-Flutter.git

Requirements

Flutter >= 3.3.0
iOS 17.0+

Quick Start

import 'package:zerosettle/zerosettle.dart';

final zeroSettle = ZeroSettle();

// Initialize with your API key
await zeroSettle.initialize('your-api-key');

Widgets

ZSMigrateTipView

A native iOS widget that encourages users with active StoreKit subscriptions to migrate to web billing for savings. The view is completely autonomous and self-contained:

Automatically shows only when applicable (user has StoreKit subscription but no web entitlement)
Handles its own checkout flow internally
Manages expansion/collapse animations
Dismisses itself when complete or cancelled
Returns empty view on Android or when not applicable

Usage:

ZSMigrateTipView(
  backgroundColor: Theme.of(context).colorScheme.surface,
  userId: 'user123',
)

Properties:

backgroundColor - Background color for the tip view
userId - Your app's user identifier

Note: This widget requires no callbacks or state management. It's a "set it and forget it" component that handles everything internally.

Platform Support

Platform	Status
iOS	Supported
Android	Coming soon

How It Works

This plugin is a thin Dart wrapper around the native ZeroSettleKit SDK. On iOS, it pulls ZeroSettleKit via CocoaPods — no xcframework is bundled in this repo.