Skip to main content
Integrate Didit verification into your web application. We offer multiple methods to fit your architecture and user experience requirements.

Choose your integration method: From quick no-code iframes to full programmatic control with our JavaScript SDK.


Integration Methods

MethodStatusSetup TimeBest For
JavaScript SDK✅ Available3 minutesFull control, React/Vue/Angular/NextJS/Nuxt/Svelte
InContext (Iframe)✅ Available< 1 minuteQuick setup, embedded experience
Redirect✅ Available5 minutesCross-device flows

Recommendation: For production apps, we recommend the JavaScript SDK (when available) or InContext iframe for the best user experience. Use Redirect for simpler integrations or when cross-device verification is needed.


JavaScript SDK

The Didit JavaScript SDK will provide a programmatic way to integrate verification with full control over the user experience. Key Features:
  • Session management and event callbacks
  • React, Vue, Angular, NextJS, Nuxt, Svelte and vanilla JS support
  • Full TypeScript support
  • Modal & inline modes
Quick Preview:
import { DiditSdk } from '@didit-protocol/sdk-web';

DiditSdk.shared.onComplete = (result) => {
  switch (result.type) {
    case 'completed':
      console.log('Verification completed!');
      console.log('Session ID:', result.session?.sessionId);
      console.log('Status:', result.session?.status);
      break;
    case 'cancelled':
      console.log('User cancelled verification');
      break;
    case 'failed':
      console.error('Verification failed:', result.error?.message);
      break;
  }
};

// Start verification with URL (from your backend or UniLink)
DiditSdk.shared.startVerification({
  url: 'https://verify.didit.me/session/session-token'
});
Full JavaScript SDK Documentation

InContext (Iframe)

Embed the verification flow directly within your application using an iframe. Seamless experience without redirecting users away from your site. Key Features:
  • UniLink (no backend required) - setup in < 1 minute
  • API Session (with backend) - full customization
  • Modal and inline implementations
  • React component examples
Quick Start:
<iframe 
  src="https://verify.didit.me/u/YOUR_WORKFLOW_ID_BASE64"
  style="width: 100%; height: 700px; border: none;" 
  allow="camera; microphone; fullscreen; autoplay; encrypted-media"
></iframe>
Full InContext Documentation

Redirect

Redirect users to the Didit-hosted verification page. After completion, users return to your callback URL. Key Features:
  • Maximum browser compatibility
  • Cross-device verification support
  • Simple integration
  • Works when iframe camera access is problematic
Quick Start:
// After creating a session via your backend
window.location.href = verificationUrl;
Full Redirect Documentation

Comparison

FeatureJavaScript SDKInContext (Iframe)Redirect
Setup Time3 min< 1 min5 min
Backend RequiredOptionalOptionalYes
Stays on Your Domain✅ Yes✅ Yes❌ No
Cross-Device Support✅ Yes✅ Yes✅ Yes
Full Programmatic Control✅ Yes⚠️ Limited❌ No
Event Callbacks✅ Real-time⚠️ postMessage❌ Callback only
White-label✅ Yes✅ Yes✅ Yes
Browser CompatibilityAllAllAll

Configuration

Required Iframe Permissions

For InContext iframe integrations, always include these permissions:
allow="camera; microphone; fullscreen; autoplay; encrypted-media"

Example Repositories