Authmatech Flutter SDK #

A professional cellular-data-based identity verification plugin for Flutter, enabling mobile network operator (MNO) detection over a cellular connection on both Android and iOS.

Overview #

Authmatech Flutter SDK lets you perform seamless identity verification by forcing your app’s HTTP requests over the device’s cellular data network. Under the hood, it leverages native Android and iOS SDKs to request an encrypted Authmatech code from your backend.

Features #

• 🚀 Cross-platform: single Dart API for Android & iOS
• 📡 Force cellular data: bypass Wi-Fi or other interfaces
• 🔒 Encrypted MNO detection: fetch Authmatech Code via your operator
• ⚙️ Rich debugging: optional trace logs and device info
• 🔄 Automatic retries & redirects (up to 10)
• 📱 Min SDK: Android 8.0+ / iOS 12.0+

Installation #

Add the SDK to your Flutter app:

flutter pub add authmatech_sdk_flutter

Or in your pubspec.yaml:

dependencies:
  authmatech_sdk_flutter: ^1.0.0

Then run:

flutter pub get

Usage #

1. Import the plugin #

import 'package:authmatech_sdk_flutter/authmatech_sdk_flutter.dart';

2. Initialize (optional) #

If you need global debug tracing, call once:

await AuthmatechSdkFlutter.initialize(
  debug: true,                 // enable trace collection & console logs
  timeout: Duration(seconds: 5)
);

3. Make a request #

final uri = Uri.parse('https://api.example.com/verify');
final result = await AuthmatechSdkFlutter.open(
  url: uri,
  accessToken: 'your_bearer_token',   // optional
  operators: '6553565535,6553565535',  // optional MNO hints
);

if (result.error != null) {
  // Error path
  print('Error code: ${result.error}');
  print('Description: ${result.errorDescription}');
  if (result.debugInfo != null) {
    print('Trace: ${result.debugInfo!.urlTrace}');
  }
} else {
  // Success path
  final body = result.responseBody!;
  print('Status: ${result.httpStatus}');
  print('AuthmatechCode: ${body.authmatechCode}');
  print('MNO ID: ${body.mnoId}');
}

Response Format #

Success #

{
  "httpStatus": 200,
  "responseBody": {
    "authmatechCode": "base64-string",
    "mnoId": "1",
    "errorCode": "0",
    "errorDesc": "Authmatech Code successfully fetched"
  },
  "debugInfo": {
    "deviceInfo": "iPhone13,4; iOS/18.4.1",
    "urlTrace": "...trace logs..."
  }
}

Error #

{
  "error": "sdk_no_data_connectivity",
  "errorDescription": "Data connectivity not available",
  "debugInfo": { /* optional trace */ }
}

Error Codes #

Platform Support #

• Android

  • Min SDK: 26 (Android 8.0)
  • Recommended: 30+ (Android 11+)

• iOS

  • Min OS: 12.0

Authmatech Detection Policy #

1. SDK forces HTTP requests over cellular only.
2. A GET to your URL returns an encrypted Authmatech code in the response JSON.
3. Your backend must respond on HTTPS and include fields encMSISDN, opId, etc., in JSON.

Requirements

• Active cellular data plan
• Supported MNO on network
• Internet permission (Android) / ATS exceptions if needed (iOS)

Security & Privacy #

• 🔐 All requests use TLS (HTTPS only)
• 🔒 Authmatech data is encrypted by the network operator
• 🚫 No personal data retained in SDK logs
• ⚙️ Debug logs are off by default in release builds

Example #

See the fully working example app in this repo under example/.

License #

Distributed under the MIT License. See LICENSE for details.