Autheo SDK

A Flutter SDK for KYC verification — ID card capture, liveness selfie, OTP, and address verification.

Requirements

	Minimum
Flutter	3.16.0
Dart	3.2.0
Android	API 21 (Android 5.0)
iOS	12.0

---

Installation

Add to your pubspec.yaml:

dependencies:
  autheo_sdk: <latest-version>

Then run:

flutter pub get

---

Platform Setup

Android

Add the following permissions to android/app/src/main/AndroidManifest.xml:

<uses-permission android:name="android.permission.CAMERA"/>
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>

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

minSdkVersion 21

iOS

Add the following keys to ios/Runner/Info.plist:

<key>NSCameraUsageDescription</key>
<string>Required to capture ID card and selfie for verification</string>

<key>NSLocationWhenInUseUsageDescription</key>
<string>Required to verify your location for address verification</string>

<key>NSPhotoLibraryUsageDescription</key>
<string>Required to select proof of residence document</string>

Set minimum deployment target to iOS 12.0 or higher in ios/Podfile:

platform :ios, '12.0'

---

Usage

import 'package:autheo_sdk/autheo_sdk.dart';

final result = await AutheoSDK.startVerification(
  context,
  apiKey: 'your-api-key',
  firstName: 'John',
  lastName: 'Doe',
  businessId: 'your-business-id',
  verificationType: 'ID Verification',
  isAddressCheck: false,
  isAmlCheck: false,
  isCreditCheck: false,
  isOtpRequired: true,
  idType: 'Ghana Card',
  idNumber: 'GHA-123456789-0',
  // Optional
  email: 'john@example.com',
  phone: '0244123456',
  addressCheckType: 'digital', // 'standard' | 'digital' | 'physical'
);

if (result.isSuccess) {
  debugPrint('Verification passed: ${result.message}');
} else {
  debugPrint('Verification failed: ${result.message}');
}

---

Parameters

Parameter	Type	Required	Default	Description
apiKey	String	Yes	—	Your Autheo API key
firstName	String	Yes	—	Candidate first name
lastName	String	Yes	—	Candidate last name
businessId	String	Yes	—	Your business account ID
verificationType	String	Yes	—	e.g. 'ID Verification'
isAddressCheck	bool	Yes	—	Include address verification step
isAmlCheck	bool	Yes	—	Run AML/blacklist check
isCreditCheck	bool	Yes	—	Run credit history check
isOtpRequired	bool	Yes	—	Require OTP before proceeding
email	String	No	''	Candidate email
phone	String	No	''	Candidate phone number
idType	String	Yes	—	ID document type e.g. 'Ghana Card'
idNumber	String	Yes	—	ID document number
addressCheckType	String	No	'digital'	'standard', 'digital', or 'physical'

---

Result

VerificationResult is returned with:

Field	Type	Description
isSuccess	bool	true if verification completed successfully
message	String?	Human-readable status message
data	Map<String, dynamic>?	Verification response data
error	String?	Error detail if verification failed

---

Troubleshooting

Camera not opening on Android — ensure CAMERA permission is declared and minSdkVersion is at least 21.

Face detection not working on certain devices — the SDK automatically caps resolution and uses NV21 format with row-padding stripped for compatibility with Samsung and Sony devices.

Firebase duplicate class error — if your app uses firebase-messaging, this SDK is safe. The google_ml_kit meta-package (which caused this conflict) has been replaced with the specific google_mlkit_face_detection package.