SDKs web de verificación de identidad: JS e iframe

Estas guías cubren la verificación de identidad. Para el inicio de sesión del usuario final, usa las guías de la plataforma de autenticación; los nuevos paquetes de autenticación dependen de la versión.

Integra la verificación de Didit en tu aplicación web. Ofrecemos siete métodos de integración para ajustarnos a tu arquitectura y a los requisitos de experiencia de usuario: elige el que encaje con tu stack.

Elige tu método de integración: desde iframes rápidos sin código hasta el control programático total con nuestro SDK de JavaScript, o plugins listos para usar para WordPress, Shopify y Salesforce.

Métodos de integración

Método	Tiempo de configuración	¿Backend?	Ideal para
SDK de JavaScript	3 minutos	Opcional	Control total: React/Vue/Angular/Next.js/Nuxt/Svelte/vanilla
InContext (iframe)	< 1 minuto	Opcional	Experiencia integrada sin redirección
Redirección	5 minutos	Sí	Máxima compatibilidad, flujos entre dispositivos
WebView (iOS/Android)	15 minutos	Sí	Alternativa móvil cuando no hay un SDK nativo disponible
WordPress + WooCommerce	5 minutos	Sin código	Sitios de WordPress, tiendas de WooCommerce
Shopify	5 minutos	Sin código	Tiendas de Shopify: verificación en el pago o en la cuenta
Salesforce	10 minutos	Sin código	CRM de Salesforce: verificación de registros de contactos y leads

Recomendación: para aplicaciones web en producción, usa el SDK de JavaScript para obtener la mejor experiencia de usuario y el control programático total. Usa el iframe InContext para la configuración más rápida, la redirección cuando se necesite verificación entre dispositivos y las integraciones específicas de WordPress / Shopify / Salesforce si trabajas en esas plataformas.

SDK de JavaScript

El SDK de JavaScript de Didit ofrece una forma programática de integrar la verificación con control total sobre la experiencia de usuario. Funciones principales:

Gestión de sesiones y callbacks de eventos
Compatibilidad con React, Vue, Angular, NextJS, Nuxt, Svelte y JS vanilla
Compatibilidad total con TypeScript
Modos modal e integrado

Inicio rápido:

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 the `url` returned by POST /v3/session/ (or your UniLink)
DiditSdk.shared.startVerification({
  url: 'https://verify.didit.me/session/3FaJ9wLqX2Mz'
});

→ Documentación completa del SDK de JavaScript

InContext (iframe)

Inserta el flujo de verificación directamente en tu aplicación mediante un iframe. Una experiencia fluida, sin redirigir a los usuarios fuera de tu sitio. Funciones principales:

UniLink (sin backend): configuración en < 1 minuto
Sesión por API (con backend): personalización total
Implementaciones modal e integrada
Ejemplos de componentes de React

Inicio rápido:

<iframe 
  src="https://verify.didit.me/u/YOUR_WORKFLOW_ID_BASE64"
  style="width: 100%; height: 700px; border: none;" 
  allow="camera; microphone; geolocation; clipboard-write; fullscreen; autoplay; encrypted-media"
></iframe>

→ Documentación completa de InContext

Redirección

Redirige a los usuarios a la página de verificación alojada por Didit. Al terminar, los usuarios vuelven a tu URL de callback. Funciones principales:

Máxima compatibilidad con navegadores
Compatibilidad con la verificación entre dispositivos
Integración sencilla
Funciona cuando el acceso a la cámara en un iframe es problemático

Inicio rápido:

// After creating a session via your backend
window.location.href = verificationUrl;

→ Documentación completa de la redirección

Comparación

Función	SDK de JavaScript	InContext (iframe)	Redirección
Tiempo de configuración	3 min	< 1 min	5 min
Requiere backend	Opcional	Opcional	Sí
Permanece en tu dominio	Sí	Sí	No
Compatibilidad entre dispositivos	Sí	Sí	Sí
Control programático total	Sí	Limitado	Solo callback
Callbacks de eventos	En tiempo real	`postMessage`	Solo callback
Marca blanca	Sí	Sí	Sí
Compatibilidad con navegadores	Todos	Todos	Todos

Los tres métodos entregan resultados finales y firmados mediante webhooks: la comparación anterior describe la experiencia de usuario en el navegador, no cómo recibes la decisión de verificación.

Configuración

Permisos de iframe necesarios

En las integraciones con iframe InContext, incluye siempre estos permisos:

allow="camera; microphone; geolocation; clipboard-write; fullscreen; autoplay; encrypted-media"

Repositorios de ejemplo

Ejemplos del SDK web

Ejemplos en React, Vue, Angular, Next.js, Nuxt, Svelte y JS vanilla

Ejemplo de iframe

Ejemplos de iframe con UniLink y con sesión por API

Demo completa en Next.js

Integración de extremo a extremo en Next.js

Paquete de NPM

@didit-protocol/sdk-web en npm

Relacionado

Webhooks: recibe resultados de verificación firmados en tu backend
API Crear sesión: el endpoint detrás de cada SDK web
SDKs nativos: iOS, Android, React Native, Flutter

Guías

Model Context Protocol (MCP)

SDKs web

SDKs nativos

SDKs web de verificación de identidad: JS e iframe

Métodos de integración

SDK de JavaScript

InContext (iframe)

Redirección

Comparación

Configuración

Permisos de iframe necesarios

Repositorios de ejemplo

Ejemplos del SDK web

Ejemplo de iframe

Demo completa en Next.js

Paquete de NPM

Relacionado

​Métodos de integración

​SDK de JavaScript

​InContext (iframe)

​Redirección

​Comparación

​Configuración

​Permisos de iframe necesarios

​Repositorios de ejemplo

Ejemplos del SDK web

Ejemplo de iframe

Demo completa en Next.js

Paquete de NPM

​Relacionado

Métodos de integración

SDK de JavaScript

InContext (iframe)

Redirección

Comparación

Configuración

Permisos de iframe necesarios

Repositorios de ejemplo

Relacionado