initialize()

Initialize the SEON SDK with your configuration.

Initializes the SEON SDK with the provided configuration. Must be called before startVerification(). The SDK remains initialized until dispose() is called.

Signature

// On SeonOrchestration
static Future<void> initialize(SeonConfig config)

Parameters

config · SeonConfig · required

Configuration object for the SEON SDK. See SeonConfig for full details.

Show SeonConfig properties

baseUrl · String · required

The base URL for your SEON API endpoint. Use the URL for your region: https://api.seon.io/orchestration-api (EU), https://api.us-east-1-main.seon.io/orchestration-api (US), or https://api.ap-southeast-1-main.seon.io/orchestration-api (APAC).

token · String · required

Session token provided by your backend for this verification session.

language · String?

Language code for the SDK UI (e.g., 'en', 'es', 'de'). Defaults to device language.

theme · Map<String, dynamic>?

Theme configuration map for UI customization (colors, fonts). Automatically JSON-encoded before passing to the native SDK. See Theme Configuration for the full schema. Omit to use the default theme.

Returns

Future<void> — Completes when initialization is successful.

Errors

Throws SeonException on failure.

Error Code	Raw String	Description
SeonErrorCode.eInitializationFailed	E_INITIALIZATION_FAILED	SDK initialization failed. Check your configuration values.
SeonErrorCode.eInvalidArgs	E_INVALID_ARGS	Missing required baseUrl or token arguments.

Example

import 'package:seon_orchestration_flutter/seon_orchestration_flutter.dart';

try {
  await SeonOrchestration.initialize(const SeonConfig(
    baseUrl: 'https://api.seon.io/orchestration-api', // EU region
    token: 'your-session-token',
    language: 'en',
  ));
  print('SEON SDK initialized');
} on SeonException catch (e) {
  print('Initialization failed: $e');
}

Platform Behavior

iOS

• SDK is initialized with configuration and holds state in a Swift singleton (SeonOrchestrationImpl)
• All calls are dispatched to the main thread automatically

Android

• Configuration is passed directly to OrchestrationService.instance.initialize() in the Kotlin plugin
• Activity lifecycle ensures operations run on the UI thread