Adhere Flutter SDK

This page is not linked from the navigation and describes a package that is not part of the current SDK release set. The maintained mobile SDKs are Android and iOS. Treat what follows as unverified against a shipping build.

A powerful Flutter package for Adhere identity verification and facial liveness detection. Our SDK delivers a drop-in UI that seamlessly orchestrates BVN/NIN verification (Nigeria), Document parsing (International), and video-based ML Kit facial liveness challenges.

Features

Drop-in UI Integration — sdk.open(context) launches our polished UI module natively on top of your app.
Dynamic Client Configuration — Fetches available document types securely from your Adhere Dashboard rules.
One-Time Use Policy System — Verifications are securely bound utilizing a single-use parameter.
Identity Onboarding — Verifies BVN & NIN directly via national APIs, or scans Passports & National ID Cards.
Liveness Detection: A passive face scan (blink plus natural head movement) with a 20 second cap, backed by Google ML Kit. The actions are never named to the user.

Installation

In your app’s pubspec.yaml:

dependencies:
  smartcomply_sdk: ^0.1.0

Then run flutter pub get.

Platform Setup

Android

In android/app/src/main/AndroidManifest.xml, ensure your app has permission to access the camera:

<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.INTERNET" />

Set the minimum SDK version in android/app/build.gradle:

android {
    defaultConfig {
        minSdk 21
    }
}

iOS

In ios/Runner/Info.plist, declare the camera usage description:

<key>NSCameraUsageDescription</key>
<string>Camera is needed for liveness verification.</string>

Quick Start (Recommended)

The simplest way to integrate our SDK is to use the full wrapper widget. Upon launching, the SDK will automatically prompt the user for their Client ID.

import 'package:smartcomply_sdk/smartcomply_sdk.dart';

// 1. Create the SDK instance using your secret API Key
final sdk = SmartComply(
  const SDKConfig(
    apiKey: 'your_live_api_key',
    environment: Environment.production, // Use Environment.sandbox for testing
  )
);

// 2. Wrap the execution in an asynchronous callback
void startVerification(BuildContext context) async {
  try {
    // Open the Adhere UI
    final result = await sdk.open(context);

    if (result.success) {
      print('Verification passed! Live Session Token: ${result.sessionToken}');
    } else {
      print('Failed or Canceled: ${result.errorMessage}');
    }
  } catch (e) {
    print("Fatal App Error processing SDK: $e");
  }
}

The SDK handles everything automatically:

Shows an initial Client ID input screen.
Identifies the user’s origin and prompts for ID types (BVN, NIN, Passport, etc).
Requests camera permissions.
Guides the user through liveness face capturing.
Securely revokes the session to enforce single-use policy.

Advanced Usage (Headless Architecture)

If you are building your own UI from scratch instead of using our wrapper, you drive the endpoints yourself. The Client ID is the one from your dashboard: the same permanent value the wrapper uses:

// 1. Open a session with your SDK Config's Client ID.
//    This is issued by Adhere and is permanent: reuse it for every
//    verification. Generating a UUID here returns 404 SDK_CONFIG_NOT_FOUND
//    on the very first call, because the server resolves it against an
//    existing SDK Config record.
final session = await sdk.createSession("YOUR_CLIENT_ID");

// 2. Verify identity directly via backend API
final identity = await sdk.onboarding.verify(
  onboardingType: OnboardingType.bvn,
  idNumber: '22012345678',
);

// 3. Mount the Camera UI Liveness Checker Widget directly in your app tree
if (identity.isVerified) {
  final liveness = await sdk.liveness.startCheck(
    context,
    identifier: '22012345678',
    identifierType: 'bvn',
    country: 'nigeria',
    challengeActions: [ChallengeAction.blink, ChallengeAction.turnLeft],
  );
  print('Liveness: ${liveness.status}');
}

Supported Liveness Actions

Our engine can dynamically challenge users based on your Dashboard rules:

Action	Enum Value	Detection Method
Blink	`ChallengeAction.blink`	ML Kit eye open probability tracking
Turn left	`ChallengeAction.turnLeft`	ML Kit `headEulerAngleY` analysis
Turn right	`ChallengeAction.turnRight`	ML Kit `headEulerAngleY` analysis
Turn head	`ChallengeAction.turnHead`	ML Kit `headEulerAngleY` analysis
Open mouth	`ChallengeAction.openMouth`	ML Kit classification

​Adhere Flutter SDK

​Features

​Installation

​Platform Setup

​Android

​iOS

​Quick Start (Recommended)

​Advanced Usage (Headless Architecture)

​Supported Liveness Actions

Adhere Flutter SDK

Features

Installation

Platform Setup

Android

iOS

Quick Start (Recommended)

Advanced Usage (Headless Architecture)

Supported Liveness Actions