Enums

Enum types for verification statuses and error codes.

SeonVerificationStatus

Enum representing the possible verification outcomes returned by startVerification().

enum SeonVerificationStatus {
  completed,
  completedSuccess,
  completedPending,
  completedFailed,
  interruptedByUser,
  error,
  missingLocationPermission,
}

Values

Value	Description
completed	Verification process completed (generic completion status)
completedSuccess	Verification completed successfully — user is verified
completedPending	Verification completed but requires manual review
completedFailed	Verification completed but user failed verification
interruptedByUser	User cancelled or interrupted the verification flow
error	An error occurred during verification (check errorMessage for native error codes)
missingLocationPermission	Verification cannot proceed due to missing location permission (Android only)

Usage

import 'package:seon_orchestration_flutter/seon_orchestration_flutter.dart';

final result = await SeonOrchestration.startVerification();

switch (result.status) {
  case SeonVerificationStatus.completedSuccess:
    // Handle success
    break;
  case SeonVerificationStatus.completedPending:
    // Handle pending review
    break;
  case SeonVerificationStatus.completedFailed:
    // Handle failure
    break;
  case SeonVerificationStatus.interruptedByUser:
    // Handle user cancellation
    break;
  case SeonVerificationStatus.error:
    print(result.errorMessage);
    break;
  case SeonVerificationStatus.missingLocationPermission:
    // Prompt user to enable location (Android)
    break;
  default:
    break;
}

---

Native SDK Error Messages

When status is error, the errorMessage field contains a message from the native SEON SDK describing what went wrong. Common causes include expired sessions, network failures, and invalid configuration. Refer to the SEON documentation for the full list of native error messages.

final result = await SeonOrchestration.startVerification();

if (result.status == SeonVerificationStatus.error) {
  print('Native SDK error: ${result.errorMessage}');
}

---

SeonErrorCode

Enum representing the error codes used on the code property of SeonException. The rawCode string property on SeonException preserves the original platform string for logging.

enum SeonErrorCode {
  eNotInitialized,
  eInitializationFailed,
  eNoActivity,
  eVerificationFailed,
  eVerificationInProgress,
  eInvalidArgs,
  unknown;

  static SeonErrorCode fromString(String raw) { ... }
}

Values

Code	String Equivalent	Description	Thrown By
eNotInitialized	E_NOT_INITIALIZED	initialize() must be called before startVerification()	startVerification()
eInitializationFailed	E_INITIALIZATION_FAILED	SDK initialization failed — check configuration	initialize()
eNoActivity	E_NO_ACTIVITY	No activity available to launch verification (Android only)	startVerification()
eVerificationFailed	E_VERIFICATION_FAILED	Verification process failed unexpectedly	startVerification()
eVerificationInProgress	E_VERIFICATION_IN_PROGRESS	Cannot start a new verification while one is already running	startVerification()
eInvalidArgs	E_INVALID_ARGS	Invalid arguments passed to a method	initialize()
unknown	(any other string)	Unrecognized error code from the platform	Any method

Usage

import 'package:seon_orchestration_flutter/seon_orchestration_flutter.dart';

try {
  await SeonOrchestration.startVerification();
} on SeonException catch (e) {
  if (e.code == SeonErrorCode.eNotInitialized) {
    print('Call initialize() first');
  } else if (e.code == SeonErrorCode.eVerificationInProgress) {
    print('A verification is already running');
  } else {
    print('Unexpected error (${e.rawCode}): ${e.message}');
  }
}