trueid_sdk 1.0.0

Flutter plugin for TrueID identity verification via Ghana Card (NIA). Captures selfie with face detection and verifies against NIA records.

TrueID SDK for Flutter

A Flutter plugin for identity verification via Ghana Card (NIA). Captures a selfie with ML Kit face detection, submits it alongside a Ghana Card PIN to TrueID, and returns the verification result.

Features

• End-to-end verification — PIN entry, selfie capture, and NIA verification in one call
• Standalone selfie capture — Use just the camera + face detection
• ML Kit face detection with real-time alignment guidance
• Simple async Dart API

Platform Support

Platform	Supported
Android	Yes
iOS	No (planned)

Installation

dependencies:
  trueid_sdk: ^1.0.0

Then run:

flutter pub get

Android Setup

Add JitPack to your android/build.gradle (or settings.gradle.kts):

allprojects {
    repositories {
        // ...
        maven { url 'https://jitpack.io' }
    }
}

Or in settings.gradle.kts:

dependencyResolutionManagement {
    repositories {
        google()
        mavenCentral()
        maven { url = uri("https://jitpack.io") }
    }
}

Ensure your minSdkVersion is at least 24 in android/app/build.gradle:

android {
    defaultConfig {
        minSdkVersion 24
    }
}

Quick Start

1. Initialize

import 'package:trueid_sdk/trueid_sdk.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await TrueIdSdk.initialize(apiKey: 'your-api-key');
  runApp(MyApp());
}

2. Verify Identity

Future<void> verifyIdentity() async {
  try {
    final result = await TrueIdSdk.verify(
      config: VerificationConfig(
        forceNia: false,
        enforceFaceComparison: true,
        transactionType: 'onboarding',
      ),
    );

    if (result == null) {
      print('User cancelled');
      return;
    }

    if (result.isSuccess) {
      print('Verified: ${result.fullName}');
      print('Document: ${result.documentNumber}');
      print('DOB: ${result.dateOfBirth}');
    } else {
      print('Failed: ${result.errorMessage}');
    }
  } on TrueIdException catch (e) {
    print('Error: ${e.code} - ${e.message}');
  }
}

3. Standalone Selfie Capture

No API key required for just the camera:

Future<void> takeSelfie() async {
  final result = await TrueIdSdk.captureSelfie(
    config: SelfieCaptureConfig(
      captureMode: CaptureMode.auto,
      resultFormat: ResultFormat.base64,
    ),
  );

  if (result != null) {
    print('Got selfie: ${result.base64?.length} chars');
  }
}

API Reference

TrueIdSdk

Method	Description
initialize({apiKey, environment, customBaseUrl})	Initialize with your API key. Call once before verify().
verify({config})	Launch full verification flow. Returns VerificationResult?.
captureSelfie({config})	Launch standalone selfie capture. Returns SelfieCaptureResult?.

VerificationConfig

Parameter	Type	Default	Description
forceNia	bool	false	Force NIA lookup even if local match exists
enforceFaceComparison	bool	true	Require face match on local lookups
transactionType	String?	null	Optional label for your records
captureConfig	SelfieCaptureConfig	default	Selfie camera settings

VerificationResult

Field	Type	Description
verified	bool	Whether identity was verified
isSuccess	bool	verified && errorMessage == null
fullName	String?	Full name from Ghana Card
documentNumber	String?	Ghana Card number
nationality	String?	Nationality
dateOfBirth	String?	Date of birth
gender	String?	Gender
expiryDate	String?	Card expiry date
phoneNumber	String?	Phone number on record
email	String?	Email on record
selfieUrl	String?	URL of captured selfie
niaPhotoUrl	String?	URL of NIA photo on file
errorMessage	String?	Error description (if failed)
errorCode	String?	Error code (if failed)

Environments

// Production (default)
TrueIdSdk.initialize(apiKey: 'key');

// Staging
TrueIdSdk.initialize(
  apiKey: 'key',
  environment: TrueIdEnvironment.staging,
);

// Custom
TrueIdSdk.initialize(
  apiKey: 'key',
  environment: TrueIdEnvironment.custom,
  customBaseUrl: 'https://your-server.com',
);

Permissions

The SDK handles these automatically:

• CAMERA — For selfie capture
• INTERNET — For API calls

You must handle the runtime camera permission in your app before calling verify() or captureSelfie().

Getting an API Key

Sign up at app.trueid.info to get your API key.

License

MIT License. See LICENSE for details.