eNROLL Neo

Our in-house developed eNROLL Neo platform serves as a technological compliance solution. A solution that is now familiarized across the globe in countries with big populations, where falsification of identity, signatures, and phishing is very common.

The software utilizes a set of AI-powered technologies, like the OCR (Optical Character Recognition), to cut back on the risks of human-based errors and the time needed for identification.

REQUIREMENTS

Android

Minimum Flutter version 3.3.4
Android minSdkVersion 24
Kotlin Version 2.1.0

iOS

iOS Deployment Target 15.5+

2. INSTALLATION

1- Install the package

Run this command with Flutter:

flutter pub add enroll_neo_plugin

This will add a line like this to your package's pubspec.yaml:

dependencies:
  enroll_neo_plugin: ^latest_version

You can find the latest version here:

https://pub.dev/packages/enroll_neo_plugin/versions

2.1. Android Setup

Step 1: Update minSdkVersion

Upgrade minSdkVersion to 24 in android/app/build.gradle:

android {
    defaultConfig {
        minSdkVersion 24
    }
}

Step 2: Add Maven Repositories

Add JitPack repository to your project-level android/build.gradle:

allprojects {
    repositories {
        google()
        mavenCentral()
        maven { url 'https://jitpack.io' }
    }
}

If your project uses the newer Gradle structure, add it to android/settings.gradle instead:

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

Step 3: (Optional) Add R8 Optimization

Add the following to android/settings.gradle for better code optimization:

buildscript {
    repositories {
        mavenCentral()
        maven {
            url = uri("https://storage.googleapis.com/r8-releases/raw")
        }
    }
    dependencies {
        classpath("com.android.tools:r8:8.2.24")
    }
}

2.2. iOS Setup

Step 1: Update Info.plist

Add the following permissions to your ios/Runner/Info.plist:

<key>NSCameraUsageDescription</key>
<string>We need camera access to capture your ID and face for verification</string>

<key>NSLocationWhenInUseUsageDescription</key>
<string>We need your location for security compliance</string>

<key>NSAppTransportSecurity</key>
<dict>
    <key>NSAllowsArbitraryLoads</key>
    <true/>
</dict>

Step 2: Add Pod Sources

Add these sources to your ios/Podfile (before platform :ios):

source 'https://github.com/LuminSoft/eNROLL-Neo-Core-specs.git'
source 'https://github.com/CocoaPods/Specs.git'
source 'https://github.com/AndyQ/NFCPassportReader.git'

Step 3: Update Deployment Target

Ensure iOS deployment target is at least 15.5 in your ios/Podfile:

platform :ios, '15.5'

2.3. Final Setup Steps

Step 1: Get Dependencies

flutter pub get

Step 2: Install iOS Pods

cd ios && pod install && cd ..

Step 3: Clean Build (If Needed)

flutter clean
flutter pub get
cd ios && pod install && cd ..

If you are upgrading from an older Android SDK/plugin version and Gradle still resolves stale dependencies, refresh Android dependencies as well:

cd android
./gradlew --refresh-dependencies
cd ..

3. IMPORT

import 'package:enroll_neo_plugin/enroll_neo_plugin.dart';

4. USAGE

Create a widget and return EnrollNeoPlugin inside the build function:

return EnrollNeoPlugin(
  mainScreenContext: context,
  tenantId: 'TENANT_ID',
  tenantSecret: 'TENANT_SECRET',
  enrollMode: EnrollMode.onboarding,
  enrollEnvironment: EnrollEnvironment.staging,
  localizationCode: EnrollLocalizations.en,
  onSuccess: (applicantId) {
    WidgetsBinding.instance.addPostFrameCallback((_) {
      debugPrint("success: $applicantId");
    });
  },
  onError: (error) {
    WidgetsBinding.instance.addPostFrameCallback((_) {
      debugPrint("Error: ${error.toString()}");
    });
  },
  onGettingRequestId: (requestId) {
    WidgetsBinding.instance.addPostFrameCallback((_) {
      debugPrint("requestId:: $requestId");
    });
  },
  applicationId: 'APPLICATION_ID',
  levelOfTrust: 'LEVEL_OF_TRUST_TOKEN',
  googleApiKey: 'GOOGLE_API_KEY',
  correlationId: 'correlationId',
  requestId: 'requestId',
  skipTutorial: false,
  enrollColors: EnrollColors(
    primary: DynamicColor(r: 0, g: 0, b: 0, opacity: 1.0),
    secondary: DynamicColor(r: 255, g: 255, b: 255, opacity: 1.0),
  ),
  enrollForcedDocumentType:
      EnrollForcedDocumentType.nationalIdOrPassport,
  templateId: 'templateId',
  contractParameters: 'contractParameters',
  enrollExitStep: EnrollStepType.phoneOtp,
);

4.1. Icon Customization

You can fully replace the SDK's default logo, step illustrations, popup glyphs, field icons, and UI icons by passing an EnrollTheme to EnrollNeoPlugin.

The EnrollTheme parameter takes priority over enrollColors.

If you only need to customize colors, you can continue using enrollColors.

4.1.1. Android Icon Customization

Step 1: Add your custom drawables

Place your PNG/XML drawables inside:

android/app/src/main/res/drawable/

Example:

example/android/app/src/main/res/drawable/my_logo.png
example/android/app/src/main/res/drawable/my_location_icon.xml

Reference them by name (without extension) using EnrollStepIcon.assetName.

Step 2: Build an EnrollTheme

final EnrollTheme myTheme = EnrollTheme(
  colors: EnrollColors(
    primary: const Color(0xFF1D56B8),
    secondary: const Color(0xFF5791DB),
  ),
  icons: const EnrollIcons(
    logo: EnrollLogoConfig(
      mode: EnrollLogoMode.custom,
      assetName: 'my_logo',
      renderingMode: EnrollIconRenderingMode.original,
    ),
    location: EnrollLocationIcons(
      tutorial: EnrollStepIcon(assetName: 'my_location_icon'),
    ),
    common: EnrollCommonIcons(
      termsAndConditions: EnrollStepIcon(assetName: 'my_terms_icon'),
      popups: EnrollPopupIcons(
        successIcon: EnrollStepIcon(assetName: 'my_success_icon'),
      ),
    ),
  ),
);

Step 3: Pass it to the plugin

EnrollNeoPlugin(
  // ...other parameters...
  enrollTheme: myTheme,
);

4.1.2. iOS Icon Customization

You can also fully replace the SDK's default logo, step illustrations, popup glyphs, field icons, and UI icons on iOS using the same EnrollTheme API.

Step 1: Add your custom assets to iOS

Open your iOS project:

ios/Runner.xcworkspace

Navigate to:

Runner → Assets.xcassets

Add your image assets (PNG/SVG supported).
Make sure:

The asset is included in the Runner target.
The asset name exactly matches the value passed in assetName.
The asset is configured correctly for all required scales (1x, 2x, 3x) if using PNG files.

Example:

ios/Runner/Assets.xcassets/my_logo.imageset
ios/Runner/Assets.xcassets/my_location_icon.imageset

After adding the assets, they are immediately ready to use inside the SDK theme configuration.

Step 2: Build an EnrollTheme

final EnrollTheme myTheme = EnrollTheme(
  colors: EnrollColors(
    primary: const Color(0xFF1D56B8),
    secondary: const Color(0xFF5791DB),
  ),
  icons: const EnrollIcons(
    logo: EnrollLogoConfig(
      mode: EnrollLogoMode.custom,
      assetName: 'my_logo',
      renderingMode: EnrollIconRenderingMode.original,
    ),
    location: EnrollLocationIcons(
      tutorial: EnrollStepIcon(assetName: 'my_location_icon'),
    ),
    common: EnrollCommonIcons(
      termsAndConditions: EnrollStepIcon(assetName: 'my_terms_icon'),
      popups: EnrollPopupIcons(
        successIcon: EnrollStepIcon(assetName: 'my_success_icon'),
      ),
    ),
  ),
);

Step 3: Pass it to the plugin

EnrollNeoPlugin(
  // ...other parameters...
  enrollTheme: myTheme,
);

Rendering modes

EnrollIconRenderingMode.original

Keeps original asset colors.
Recommended for logos and colorful illustrations.

EnrollIconRenderingMode.template

Applies SDK tint color to the asset.
Recommended for monochrome icons.

Important Notes for iOS

Asset names are case-sensitive.
SVG assets are not supported directly in Assets.xcassets.
PDF vector assets are recommended.
If an asset cannot be resolved, the SDK automatically falls back to the default built-in asset.
EnrollTheme takes priority over enrollColors.

Available icon groups

Group	Icons
`logo`	Splash and app-bar logo (`EnrollLogoConfig`)
`location`	`tutorial`, `requestAccess`, `accessError`, `grab`
`nationalId`	`tutorial`, `tutorialIdOrPassport`, `preScan`, `scanError`, `choose`
`passport`	`tutorial`, `preScan`, `ePassportPreScan`, `choose`
`phone`	`tutorial`, `select`, `validateOtp`
`email`	`tutorial`, `select`, `validateOtp`
`faceMatching`	`tutorial`, `preScan`, `error`
`securityQuestions`	`tutorial`, `authScreen`
`password`	`tutorial`, `authScreen`
`signature`	`tutorial`
`common.backgrounds`	`main`, `layer1`, `layer2`, `layer3`, `blur`, `header`, `footer`
`common.popups`	`background`, `warningIcon`, `errorIcon`, `successIcon`
`common.fieldIcons`	`user`, `calendar`, `gender`, `issuingAuthority`, `nationality`, `num`, `passport`, `address`, `idCard`, `profession`, `religion`, `maritalStatus`
`common.ui`	`visibility`, `visibilityOff`, `mobile`, `mail`, `answer`, `error`, `info`, `edit`, `activePhone`
`common.termsAndConditions`	Single icon
`update`	`modeIcon`, `idCard`, `passport`, `mobile`, `email`, `device`, `address`, `securityQuestions`, `password`
`forget`	`modeIcon`, `nationalId`, `passport`, `phone`, `email`, `device`, `location`, `securityQuestions`, `password`

If a drawable or asset cannot be resolved at runtime, the SDK logs a warning and falls back to its built-in asset automatically.

4.2. Text Customization And Localization Overrides

Customize the SDK's fonts and text through EnrollTheme.typography (EnrollTypography). The example app includes full English and Arabic override files copied from the native Android and native iOS SDKs

Font family and size

final EnrollTheme theme = EnrollTheme(
  typography: const EnrollTypography(
    // Android: a `res/font` resource name (no extension).
    fontFamily: 'my_custom_font',
    // Respect the device font scale. Defaults to true.
    dynamicTypeEnabled: true,
    // EnrollFontSizes.defaultSize | medium | large
    sizes: EnrollFontSizes.medium,
  ),
);

EnrollNeoPlugin(
  // ...other parameters...
  enrollTheme: theme,
);

Localization overrides

Override SDK strings by passing JSON files bundled with your app. Pass the file names without the .json extension:

final EnrollTheme theme = EnrollTheme(
  typography: const EnrollTypography(
    localizationOverrides: EnrollLocalizationOverrides(
      englishFileName: 'enroll_localizations_en',
      arabicFileName: 'enroll_localizations_ar',
    ),
  ),
);

The JSON format is:

{
  "localizationOverrides": {
    "en": {
      "skip": "Skip",
      "continue_to_next": "Continue"
    },
    "ar": {
      "skip": "تخطي",
      "continue_to_next": "استمرار"
    }
  }
}

Android setup

Place the JSON files under:

android/app/src/main/assets/

Android loads these files from app assets. If the filename has no extension, .json is assumed.

iOS setup

Place the same JSON files in the iOS app bundle and add them to the Runner target's Copy Bundle Resources phase.

The example already contains iOS reference files:

example/ios/Runner/enroll_localizations_en.json
example/ios/Runner/enroll_localizations_ar.json

These files are intentionally left as iOS-side references. The iOS native implementation owner should update their contents when needed.

Notes

The active language is selected by localizationCode.
You can include only the keys you want to change.
Some protected native keys (vendor capture instructions, NFC keys, sample keys, and app_name) are reference-only and are not applied as overrides.

5. ENROLL MODES

enum EnrollMode {
  onboarding,
  auth,
  update,
  signContract
}

Mode	Description	Requirements
`onboarding`	Registering a new user	`tenantId`, `tenantSecret`
`auth`	Verifying an existing user	`tenantId`, `tenantSecret`, `applicantId`, `levelOfTrustToken`
`update`	Updating user verification	`tenantId`, `tenantSecret`, `applicantId`
`signContract`	Contract signing	`tenantId`, `tenantSecret`, `applicantId`, and either `templateId` or `signContractFile`

5.1. SIGN CONTRACT

Use EnrollMode.signContract when the user needs to sign a contract. Two configurations are supported:

Configuration	When to use it	Required fields
Template contract	Backend generates the contract from a template.	`tenantId`, `tenantSecret`, `applicantId`, `templateId`. Optional: `contractParameters`.
PDF file contract	Your Flutter app already has the PDF bytes.	`tenantId`, `tenantSecret`, `applicantId`, `signContractFile`. Optional: `contractFileName`.

The native SDK chooses the signing type automatically:

If signContractFile is provided, the SDK sends the PDF as multipart file content.
If signContractFile is not provided, the SDK uses the template flow with templateId.
If contractFileName is omitted for a PDF file contract, the native SDK sends a timestamp filename like yyyyMMdd_HHmmss.pdf.

Template contract example

EnrollNeoPlugin(
  mainScreenContext: context,
  tenantId: 'TENANT_ID',
  tenantSecret: 'TENANT_SECRET',
  enrollMode: EnrollMode.signContract,
  enrollEnvironment: EnrollEnvironment.staging,
  localizationCode: EnrollLocalizations.en,
  applicationId: 'APPLICATION_ID',
  templateId: 'TEMPLATE_ID',
  contractParameters: '{"amount":"1000"}',
  onSuccess: (applicantId) => debugPrint('success: $applicantId'),
  onError: (error) => debugPrint('Error: $error'),
  onGettingRequestId: (requestId) {},
);

PDF file contract example

final ByteData data = await rootBundle.load('assets/pdf/contract.pdf');
final Uint8List contractBytes = data.buffer.asUint8List();

EnrollNeoPlugin(
  mainScreenContext: context,
  tenantId: 'TENANT_ID',
  tenantSecret: 'TENANT_SECRET',
  enrollMode: EnrollMode.signContract,
  enrollEnvironment: EnrollEnvironment.staging,
  localizationCode: EnrollLocalizations.en,
  applicationId: 'APPLICATION_ID',
  signContractFile: contractBytes,
  contractFileName: 'contract.pdf',
  onSuccess: (applicantId) => debugPrint('success: $applicantId'),
  onError: (error) => debugPrint('Error: $error'),
  onGettingRequestId: (requestId) {},
);

6. VALUES DESCRIPTION

Key	Description
`tenantId`	Required tenant ID
`tenantSecret`	Required tenant secret
`enrollMode`	SDK mode
`environment`	Staging or production
`enrollCallback`	Success/error callback
`localizationCode`	EN or AR
`googleApiKey`	Google Maps API key
`applicantId`	Applicant ID
`levelOfTrustToken`	Level of trust token
`skipTutorial`	Skip tutorial screens
`appColors`	Override SDK colors
`enrollTheme`	Unified theme customization (colors + icons + typography). Colors work on Android & iOS; typography & icons are Android (iOS pending).
`correlationId`	Correlation ID
`templateId`	Contract template ID (required for template-based `signContract` when `signContractFile` is not provided)
`contractParameters`	Contract parameters
`signContractFile`	PDF bytes (`Uint8List`) for file-based `signContract`. When provided, the native SDK sends the PDF as multipart file content.
`contractFileName`	Filename sent with `signContractFile`. If omitted, the native SDK uses a timestamp name like `yyyyMMdd_HHmmss.pdf`.
`enrollForcedDocumentType`	Force specific document type
`requestId`	Continue previous request
`enrollExitStep`	Exit SDK after specific step

7. ENROLL STEP TYPES

The SDK supports 13 step type defined in the EnrollStepType enum:

enum EnrollStepType {
  /// One-time password verification sent to the user's phone number.
  /// Used to validate phone ownership.
  phoneOtp,

  /// Confirms the user's personal information (e.g. national ID, passport).
  personalConfirmation,

  /// Performs smile-based liveness detection to ensure the user is physically present step.
  smileLiveness,

  /// One-time password verification sent to the user's email address.
  /// Used to validate email ownership.
  emailOtp,

  /// Registers and saves the current mobile device as a trusted device step.
  saveMobileDevice,

  /// Captures and verifies the user's device location for compliance and security step.
  deviceLocation,

  /// Creates or confirms the user's account password step.
  password,

  /// Verifies answers to predefined security questions for additional authentication step.
  securityQuestions,

  /// Performs Anti-Money Laundering (AML) checks against regulatory databases step.
  amlCheck,

  /// Displays and requires acceptance of the terms and conditions step.
  termsAndConditions,

  /// Captures the user's electronic signature for legal consent step.
  electronicSignature,

  /// Performs NTRA (National Telecom Regulatory Authority) verification step.
  ntraCheck,

  /// Performs CSO (Central Security Office) verification checks step.
  csoCheck,
}

8. SECURITY NOTES

Never hardcode tenantSecret, levelOfTrustToken, or API keys inside the application.
Use secure storage such as Android Keystore or iOS Keychain.
Always update the SDK to the latest stable version.
Rooted devices are blocked by default for security reasons.

9. ELECTRONIC PASSPORT (ePassport) CONFIGURATION

If you want to use NFC reading for electronic passports, follow these additional steps:

9.1. Android - ePassport Setup

The eNROLL Neo Android SDK already includes NFC support.

No additional configuration is needed for Android.

9.2. iOS - ePassport Setup

Step 1: Add NFC Capabilities to Info.plist

Add the following NFC configuration to your ios/Runner/Info.plist:

<key>com.apple.developer.nfc.readersession.felica.systemcodes</key>
<array>
    <string>A0000002471001</string>
</array>

<key>com.apple.developer.nfc.readersession.iso7816.select-identifiers</key>
<array>
    <string>A0000002471001</string>
</array>

<key>NFCReaderUsageDescription</key>
<string>We need NFC access to read your electronic passport</string>

Step 2: Enable NFC Capability in Xcode

Open your iOS project in Xcode (ios/Runner.xcworkspace)
Select your target → Signing & Capabilities
Click + Capability
Add:

Near Field Communication Tag Reading

NFC reading requires a physical iOS device and will not work on simulators.

⚠️ Important Notes

No MainActivity changes are needed.
The plugin handles Android namespace conflicts internally.
Android minSdkVersion 24 is required.
JitPack repository must be added to resolve Android dependencies.
ePassport/NFC support is optional.

👉 Full documentation: https://lumin-soft.gitbook.io/ekyc/integration-guide/mobile-plugin/enroll-neo-flutter-sdk

eNROLL Neo

REQUIREMENTS

Android

iOS

2. INSTALLATION

1- Install the package

2.1. Android Setup

Step 1: Update minSdkVersion

Step 2: Add Maven Repositories

Step 3: (Optional) Add R8 Optimization

2.2. iOS Setup

Step 1: Update Info.plist

Step 2: Add Pod Sources

Step 3: Update Deployment Target

2.3. Final Setup Steps

Step 1: Get Dependencies

Step 2: Install iOS Pods

Step 3: Clean Build (If Needed)

3. IMPORT

4. USAGE

4.1. Icon Customization

4.1.1. Android Icon Customization

Step 1: Add your custom drawables

Step 2: Build an EnrollTheme

Step 3: Pass it to the plugin

4.1.2. iOS Icon Customization

Step 1: Add your custom assets to iOS

Step 2: Build an EnrollTheme

Step 3: Pass it to the plugin

Rendering modes

Important Notes for iOS

Available icon groups

4.2. Text Customization And Localization Overrides

Font family and size

Localization overrides

Android setup

iOS setup

Notes

5. ENROLL MODES

5.1. SIGN CONTRACT

Template contract example

PDF file contract example

6. VALUES DESCRIPTION

7. ENROLL STEP TYPES

8. SECURITY NOTES

9. ELECTRONIC PASSPORT (ePassport) CONFIGURATION

9.1. Android - ePassport Setup

9.2. iOS - ePassport Setup

Step 1: Add NFC Capabilities to Info.plist

Step 2: Enable NFC Capability in Xcode

⚠️ Important Notes

Libraries

enroll_neo_plugin package