Saltar al contenido principal
La biblioteca oficial de Didit para Node.js y TypeScript. Funciona en Node.js 18 o posterior, Bun, Deno y entornos de ejecución edge con fetch, incluye versiones para módulos ES y CommonJS, y no tiene dependencias en tiempo de ejecución. Consulta la visión general de los SDK de servidor para ver lo que comparten todos los SDK.

Instalación

El paquete es @didit-protocol/sdk-node en npm. Su código fuente y su registro de cambios están en didit-protocol/sdk-node en GitHub.

Configurar el cliente

new Didit() lee DIDIT_API_KEY del entorno en Node.js, Bun y Deno (con --allow-env). Los entornos de ejecución edge no tienen entorno de proceso, así que ahí pasa la clave como opción: new Didit({ apiKey: env.DIDIT_API_KEY }). Pasa opciones para sobrescribirla o para definir los ID de organización y de aplicación que necesitan las llamadas con ámbito de aplicación (casos, redes, informes regulatorios). El tiempo de espera se indica en milisegundos.
Con CommonJS, usa const { Didit } = require("@didit-protocol/sdk-node");.

Crear una sesión

Crea una sesión de verificación para un workflow y envía a tu usuario a su URL. Los campos de la solicitud conservan los nombres propios de la API.

Leer la decisión

Cuando el usuario termine (o cuando llegue el webhook), lee la decisión. Cada resultado de función es una lista con una entrada por cada nodo del flujo, y las fechas y horas son objetos Date.

Verificar un webhook

Pasa el cuerpo sin procesar (no el JSON ya parseado) y los encabezados de la solicitud: un objeto req.headers de Node.js o Express, un objeto Headers de Fetch o pares [name, value] (el tipo WebhookHeaders). verify devuelve una promesa que se rechaza con WebhookVerificationError ante cualquier cosa que no sea una entrega válida y reciente.
Con Express, lee el cuerpo con express.raw({ type: "application/json" }) y llama a handleWebhook(req.body, req.headers). Mientras rotas el secreto, pasa ambos: [newSecret, oldSecret]. Consulta Webhooks para conocer los eventos y el esquema de firma.

Analizar una transacción

Envía un pago, un retiro o una transferencia de criptomonedas a la monitorización de transacciones; la respuesta incluye su estado y su puntuación de riesgo.

Verificar tokens de Authentication

Authentication comprueba los tokens de acceso que firma tu emisor de Authentication, en tu backend, sin realizar una solicitud a Didit en cada solicitud. También intercambia códigos, renueva tokens, comprueba y revoca sesiones, y ejecuta verificaciones adicionales (step-ups).
La verificación de tokens realiza las comprobaciones descritas en Verificar un token en tu servidor, contra el emisor y las claves de firma de tu aplicación.

Errores

Listas y archivos

Las páginas de endpoints de servidor de la referencia de la API incluyen un ejemplo en Node.js para utilizarlos, salvo los endpoints y campos que todavía no tiene ninguna versión 1.0.1, indicados en la visión general.
Última modificación el 1 de noviembre de 2026