Saltar al contenido principal
Transcripción completa de Integra Didit en tu aplicación: API, SDK y webhooks (guía para desarrolladores): vídeo 8 de 10 de Didit Academy, 08:13. Ver en YouTube. Cada párrafo enlaza al momento exacto del vídeo.

​
Qué vas a conectar

00:04 En este vídeo vas a conectar Didit a tu propia aplicación. Así, tus usuarios se verifican directamente dentro de tu producto y cada resultado vuelve a tu sistema en el momento en que se produce. Este es el vídeo para desarrolladores, así que es un poco más técnico, pero es más sencillo de lo que crees. Y al final verás que puedes delegar la mayor parte directamente en Claude Code para que lo construya por ti. Así que lo veremos en el orden en que

​
SDK, API y webhook: las tres piezas

00:28 realmente lo construirías. Vamos a ello. Integrar Didit significa conectar tres cosas. El SDK muestra la cámara, la captura del documento, la lectura NFC y la interfaz de prueba de vida directamente dentro de tu aplicación. La API funciona de servidor a servidor, así que tu backend crea la sesión y lee la decisión definitiva. Y el webhook invoca tu endpoint HTTPS en el instante en que una sesión cambia de estado, lo que es mucho

​
La pestaña de integración

00:56 más rápido y completo que consultarlo periódicamente (polling). La forma más sencilla de integrarlo es ir a la pestaña de gestión, hacer clic en integración, y desde ahí podemos obtener toda la configuración, como nuestra clave de API. Podríamos crear una clave de API específica para esta aplicación concreta en la que estamos trabajando. Podemos crear y elegir el flujo de verificación (workflow) que queremos integrar. Podemos añadir un webhook, que es a donde se envían los resultados de la verificación. 01:24 Y el secreto de firma, que te enseñaré en un momento, es lo que va a

​
Elegir tu plataforma

01:28 van en tu archivo ENV. Después puedes conectarlo a tu aplicación. Aquí tenemos varias opciones: web JS, React Native, iOS, Android, Flutter y algunas otras. Así que puedes seleccionar la que corresponda a tu aplicación. Estos son los secretos del entorno que vas a poner en tu archivo ENV en tu

​
El prompt de configuración con IA

01:48 servidor. La forma fácil de configurarlo es usar el prompt de configuración con IA. Definimos toda la configuración aquí arriba y luego copiamos el prompt, con lo que se copiará toda la información relevante que necesitamos de la configuración que hemos completado aquí. Lo copiamos y pegamos en Cloud Code, Codex o donde sea que estés

​
Claves de API, una por entorno

02:09 construyendo tu aplicación. Tus claves de API están aquí, y cada fila contiene una clave. Una buena práctica es usar una clave distinta por entorno y por integración. Así puedes rotar o revocar una sin afectar a las demás. Por ejemplo, si vas a integrar un flujo concreto,

​
Crear una clave

02:27 quizá quieras tener una clave de API independiente para ese flujo. Ahora, si hago clic en crear clave de API, voy a poner simplemente “test” aquí y creo la clave de API. Ahora puedo copiarla, y no voy a volver a verla. Por eso es importante que la copies y quizá la anotes en algún sitio para poder usarla cuando hagas la integración. Cuando vas a la sección de integración y obtienes tu clave de API, por ejemplo, si cojo la clave de prueba y bajo, selecciono, a ver, este flujo de KYC. Podemos añadir un webhook. 03:05 Podemos conectar nuestra aplicación. Y luego podemos pegar este prompt de configuración aquí. Como ves, este prompt va a

​
Descripción general de los webhooks

03:13 incluir la clave de API. Pasemos brevemente a los webhooks. podemos configurar un webhook para prácticamente cualquier cosa que queramos. Por ejemplo, si quieres enviar un evento concreto a Slack, podemos

​
La documentación

03:25 añade la URL del webhook aquí. Bien, echemos un vistazo a parte de la documentación, porque tienes acceso a toda la documentación técnica. Solo tienes que ir a docs.didit.me, y vamos a ver algunas cosas

​
Crear sesión: el único campo obligatorio

03:37 aquí. Todo gira en torno a la creación de sesiones. Es una solicitud POST y es el inicio de una verificación. En la solicitud curl vemos el ID del flujo. Es el único campo obligatorio, y lo realmente útil es que este mismo endpoint crea tanto sesiones de KYC como de KYB. El

​
Vendor data y URL de callback

04:00 El flujo es lo que decide cuál es cuál. Aquí abajo tenemos algunos campos adicionales, incluido vendor data, del que hemos hablado mucho en estos vídeos. Es el identificador único de cada usuario, y puedes definirlo como quieras, ya sea un correo electrónico o un identificador único, y luego tenemos aquí la URL de callback. Aquí es donde se redirigirá al usuario después de completar el flujo de verificación. Así que,

​
Probar el endpoint en vivo

04:24 Si bajamos aquí, podemos probarlo de verdad. Si hacemos clic en probar, podemos crear una sesión de verificación aquí mismo. Voy a pegar una de las claves de API. Voy a crear una completamente nueva, test two. La copio y la pego aquí. Necesitamos un ID de flujo, así que vamos aquí y copiamos este ID de flujo. Lo introducimos ahí. Los datos del proveedor no son obligatorios; pongamos una cadena de números aleatoria. 05:02 El callback podemos dejarlo igual. Por cierto, nada de esto es obligatorio. Creo que es porque aquí tengo una cuenta de prueba, pero si quisieras probar este endpoint, así es exactamente como lo harías. Ahora bien, si eres desarrollador y quieres respuestas concretas, puedes consultar la documentación. El MCP también tiene acceso a toda esta documentación, así que literalmente puedes integrar el MCP y hacerle a Claude cualquier pregunta sobre un aspecto técnico que probablemente se trate en estos documentos

​
Webhooks: por qué no usar polling

05:32 aquí dentro. Hablemos de los webhooks. En la sección de gestión tenemos una pestaña de webhooks, y es así como te llegan los resultados. Los webhooks son el canal recomendado porque el polling es bastante lento,

​
Añadir un destino y elegir eventos

05:44 te va a costar más solicitudes y se te van a escapar eventos. Así que aquí añadimos un nuevo destino. Podemos pegar una URL y elegir los eventos que queremos, es decir, todos los datos que queremos enviar a este endpoint en concreto. Didit te devuelve un secreto de firma de un solo uso, que te enseñaré en un segundo. La URL tiene que ser accesible directamente, así que nada de localhost ni de IP privadas. Voy a salir de aquí, nos desplazamos hacia la derecha y vemos que tenemos varias opciones. 06:16 Aquí vemos el número de eventos que escucha este webhook y podemos

​
El secreto de firma

06:19 copia el secreto de firma, que va a ser importante para tu integración. Cuando configuramos la integración en la pestaña de integraciones, como ya te mostré, tenemos un prompt, y el secreto de firma del webhook que hayas seleccionado en la configuración va a estar ahí dentro. Así que

​
El prompt del handler de webhooks

06:34 esta es otra forma de aprovechar la IA: hay un prompt ya preparado que encontré aquí, en la pestaña de webhooks. Podemos ver si quieres configurar tu handler de webhooks con IA. Podemos consultar la documentación y encontrar aquí un prompt de integración. Cubre la verificación de identidad, las entidades y las transacciones, y te lo construye todo. Lo detalla todo: qué construir, la verificación de los encabezados de firma y los tipos de evento de webhook que acabas de ver cuando configuramos un webhook antes. Tenemos el envoltorio del webhook y mucho más, y también podemos elegir dónde lo queremos pegar, es decir, qué herramienta estamos usando. 07:15 Así que, si quieres usar este prompt, es la forma más fácil de empezar y dejar configuradas tus integraciones. Todo lo que he explicado en este video está accesible y se puede consultar desde tu herramienta de IA si integras el servidor MCP. Así que solo tienes que explicar en lenguaje natural lo que quieres que pase, y Claude Code leerá la documentación y construirá la integración por ti. Tú solo revisas el trabajo y te aseguras de que funciona y

​
Resumen

07:41 trabajando en lugar de programarlo todo desde cero. Y así es Didit en tu aplicación: el SDK que ven tus usuarios, la API a la que llama tu backend y el webhook firmado que entrega el veredicto sobre el que construyes. Confía en el webhook, usa datos del proveedor en todas partes y apóyate en el prompt de configuración para no conectar a mano las partes tediosas. Puedes ir a didit.me, registrarte gratis y tener una verificación en marcha en minutos.
Última modificación el 1 de noviembre de 2026