✅ Event: `onInitialized`

📘 Description

This event is emitted by the Ditto ID SDK to indicate that the SDK has been successfully initialized. It is typically the first confirmation the app receives after calling the initialize() API.

The event provides important data such as:

App session proxy and session ID
SDK settings (including IDVConfig)
Initialization status code
Threat configuration and environment flags

📱 Platform Support

Platform	Syntax
React Native	`rdnaEventRegistery.addListener('onInitialized', this.handler)`
Flutter	`rdnaClient.on(RdnaClient.onInitialized, onInitialized);`
Cordova	`document.addEventListener('onInitialized', this.handler, false);`
Native iOS	`(void)onInitialized:(RDNAError *)error;`
Native Android	`void onInitialized(RDNAError error);`

📤 Response Format

The onInitialized event provides information through its payload that your application needs to process. The structure may vary by platform but typically includes the following data:

Sample Payload

{
    "status": {
        "statusCode": 100,
        "statusMessage": ""
    },
    "session": {
        "sessionType": 0,
        "sessionID": "3EKQUL7IX9EJ41WQN8RVH0AMBP2D3WFHJDK4MD1DBGHN1M40RE"
    },
    "additionalInfo": {
        "DNAProxyPort": 0,
        "isAdUser": 0,
        "isDNAProxyLocalHostOnly": 0,
        "jwtJsonTokenInfo": "",
        "settings": "{}",
        "mtlsP12Bundle": "",
        "configSettings": "",
        "loginIDs": [],
        "availableGroups": [],
        "idvAuditInfo": "",
        "idvUserRole": "",
        "currentWorkFlow": "",
        "isMTDDownloadOnly": 0,
        "supportedLanguage": [
            {
                "lang": "en-US",
                "display_text": "English",
                "direction": "LTR"
            }
        ],
        "selectedLanguage": "en-US",
        "app_messages": {}
    },
    "challengeInfo": []
}

🔍 Field Definitions

This document describes the structure and meaning of the fields returned by the onInitialized event emitted by the Ditto ID SDK.

🧾 Top-Level Payload Fields

Field	Type	Description
`status`	Object	Contains status code and message indicating result of initialization.
`session`	Object	Information about the Ditto ID session such as session type and ID.
`additionalInfo`	Object	Extra metadata related to the session, environment, and runtime config.
`challengeInfo`	Array	Placeholder for any challenges configured to follow initialization.

🔍 `status` Object

Field	Type	Description
`statusCode`	Number	HTTP-like code (e.g., 100 = success).
`statusMessage`	String	Message associated with the status.

🆔 `session` Object

Field	Type	Description
`sessionType`	Number	Indicates type of session (e.g., primary = 0).
`sessionID`	String	Unique session identifier (JWT-related).

🧩 `additionalInfo` Object

Field	Type	Description
`DNAProxyPort`	Number	Port number used by the SDK's internal proxy.
`isAdUser`	Number	Flag indicating Active Directory-based login (0 = false).
`isDNAProxyLocalHostOnly`	Number	Indicates if proxy is restricted to localhost (1 = true).
`jwtJsonTokenInfo`	String	JWT token issued during initialization (may be empty initially).
`settings`	String	JSON-encoded configuration object (must be decoded separately).
`mtlsP12Bundle`	String	Base64-encoded client SSL certificate if mutual TLS is used.
`configSettings`	String	Optional app-wide config from backend, if any.
`loginIDs`	Array	List of remembered login IDs on the device.
`currentWorkFlow`	String	Denotes current workflow name, if any (used for IDV, etc.).
`supportedLanguage`	String	JSON arrya sting denotes the supported languages includes the lang(language name), display_text(display text for language) and the direction (direction for text)
`selectedLanguage`	String	Denotes current selected lanague for the SDK.
`app_messages`	String	Localized string messages required for App.

🧪 Decoded `settings` Field (as JSON)

Field	Type	Description
`nfcScanEnabled`	Boolean	Enables NFC scanning (for IDV).
`nfcScanTimeOut`	Number	Timeout in seconds for NFC scan.
`version`	String	Version of the IDV or settings schema.

💡
This structure helps you manage app session, feature toggles, and handle follow-up actions like user login or document verification.

🔧 Notes

IDVConfig is pulled from the Gateway Manager. If not configured, SDK uses default:

{
  "nfcScanEnabled": false,
  "authenticityChecksEnabled": false,
  "hologramCheckEnabled": false,
  "saveDebugLogs": false,
  "saveCroppedImages": false,
  "nfcScanTimeOut": 60,
  "version": "1.0"
}

This event is critical for accessing session-related data before any secured API call or workflow can begin.

📱 Platform-specific Integration

React Native

// Import the necessary modules
import RdnaClient from 'react-native-rdna-client';

// This is an event handler, not a method to call directly
// Set up event listener for onInitialized event
let onInitializedSubscription = rdnaEventRegistery.addListener(
  'onInitialized', (response) => {
    // Handle the response
    console.log("onInitialized event received:", response);
    // Implement your logic here
  }
);

// Don't forget to remove the event listener when component unmounts
componentWillUnmount() {
  onInitializedSubscription.remove();
}

Flutter

import 'package:flutter/material.dart';
import 'package:rdna_plugin/rdna_plugin.dart';

// This is an event handler, not a method to call directly
// Set up event listener for onInitialized event
rdnaClient.on(RdnaClient.onInitialized, onInitialized);

// Define the callback function
void onInitialized(RDNAInitialized response) {
  // Handle the response
  print("onInitialized event received");
  // Implement your logic here
}

Cordova

// This is an event handler, not a method to call directly
// Set up event listener for onInitialized event
document.addEventListener('onInitialized', onInitialized);

// Define the callback function
function onInitialized(response) {
  // Handle the response
  console.log("onInitialized event received:", response);
  // Implement your logic here
}

Native iOS

// Objective-C
// This is an event handler, not a method to call directly
// Implement the event handler method
- (void)onInitialized:(RDNAChallengeResponse *)response {
    // Handle the response
    NSLog(@"onInitialized event received");
    // Implement your logic here
}

// Swift
// This is an event handler, not a method to call directly
// Implement the event handler method
func onInitialized(_ response: RDNAChallengeResponse) {
    // Handle the response
    print("onInitialized event received")
    // Implement your logic here
}

Native Android

// This is an event handler, not a method to call directly
// Implement the event handler method
@Override
public void onInitialized(RDNA.RDNAChallengeResponse response, RDNAError error) {
    // Handle the response
    Log.d("DITTO-ID", "onInitialized event received");
    // Implement your logic here
}

✅ Next Steps

Use sessionID and settings to initialize app-level session.
Listen for follow-up events like getUser , onUserConsentThreats , or onTerminateWithThreats .

✅ Event: onInitialized

📘 Description

📱 Platform Support

📤 Response Format

Sample Payload

🔍 Field Definitions

This structure helps you manage app session, feature toggles, and handle follow-up actions like user login or document verification.

🔧 Notes

📱 Platform-specific Integration

✅ Next Steps

✅ Event: `onInitialized`