Native SDKs

​

SDK Availability

​

What’s new in 4.9.0

​

How a verification session flows

1. Your backend calls POST /v3/session/ with workflow_id plus any optional context (vendor_data, contact_details, expected_details, metadata, callback).
2. Didit returns a session_id, a short-lived session_token, and a hosted url.
3. Your mobile app receives the session_token from your backend and passes it to the SDK (startVerification(token: …)).
4. The native SDK opens the verification UI, the user completes the steps, and the SDK returns a result with the session’s terminal status (Approved, Declined, In Review, etc.).
5. Your backend receives the full decision via a webhook (webhook_type: "status.updated") and persists it.

​

iOS SDK

• SwiftUI and UIKit support
• NFC passport/ID reading (iOS 15+; the no-NFC Core and AutoDetection variants strip NFC and OpenSSL, and deploy to iOS 13+)
• 53 languages supported
• Customizable UI theming
• Session token or workflow ID integration

import DiditSDK

// Start verification
DiditSdk.shared.startVerification(token: "your-session-token")

// Handle result
.diditVerification { result in
    switch result {
    case .completed(let session):
        print("Status: \(session.status)")
    case .cancelled:
        print("Cancelled")
    case .failed(let error, _):
        print("Error: \(error)")
    }
}

​

Android SDK

• Kotlin and Jetpack Compose support
• NFC passport/ID reading (opt-in me.didit:didit-sdk-core artifact strips NFC dependencies)
• ML-based document and face auto-detection on API 24+ (graceful manual-capture fallback on API 23)
• 53 languages supported
• Customizable UI theming
• Session token or workflow ID integration

import me.didit.sdk.DiditSdk
import me.didit.sdk.VerificationResult

// Initialize in Application.onCreate()
DiditSdk.initialize(this)

// Start verification
DiditSdk.startVerification(token = "your-session-token") { result ->
    when (result) {
        is VerificationResult.Completed -> Log.d("Didit", "Status: ${result.session.status}")
        is VerificationResult.Cancelled -> Log.d("Didit", "Cancelled")
        is VerificationResult.Failed -> Log.e("Didit", "Error: ${result.error.message}")
    }
}

​

React Native SDK

• Single TypeScript API for both iOS and Android
• Expo support with zero-config config plugin (development build required — no Expo Go)
• React Native CLI support
• NFC passport/ID reading (toggle off with DIDIT_SDK_IOS_NFC_ENABLED=false / diditSdkAndroidNfcEnabled=false)
• 53 languages supported (inherited from native SDKs)
• Session token or workflow ID integration

import { startVerification, VerificationStatus } from '@didit-protocol/sdk-react-native';

const result = await startVerification('your-session-token');

switch (result.type) {
  case 'completed':
    console.log('Status:', result.session.status);
    break;
  case 'cancelled':
    console.log('Cancelled');
    break;
  case 'failed':
    console.log('Error:', result.error.message);
    break;
}

​

Flutter SDK

• Single Dart API for both iOS and Android
• Platform channel integration with native SDKs
• NFC passport/ID reading (toggle off with DIDIT_SDK_IOS_NFC_ENABLED=false / diditSdkAndroidNfcEnabled=false)
• 53 languages supported (inherited from native SDKs)
• Session token or workflow ID integration

import 'package:didit_sdk/sdk_flutter.dart';

final result = await DiditSdk.startVerification('your-session-token');

switch (result) {
  case VerificationCompleted(:final session):
    print('Status: ${session.status}');
  case VerificationCancelled():
    print('Cancelled');
  case VerificationFailed(:final error):
    print('Error: ${error.message}');
}

​

Web SDK (JavaScript)

• Programmatic session management and event callbacks
• React, Vue, Angular, Next.js, Nuxt, Svelte, and vanilla JS support
• Full TypeScript support
• Modal & inline (embedded) modes
• State management for custom UI

import { DiditSdk } from '@didit-protocol/sdk-web';

DiditSdk.shared.onComplete = (result) => {
  switch (result.type) {
    case 'completed':
      console.log('Status:', result.session?.status);
      break;
    case 'cancelled':
      console.log('Cancelled');
      break;
    case 'failed':
      console.error('Error:', result.error?.message);
      break;
  }
};

DiditSdk.shared.startVerification({
  url: 'https://verify.didit.me/session/session-token'
});

​

Choosing an integration