Saltar al contenido principal
La biblioteca oficial de Didit para Java y Kotlin. Requiere Java 11 o posterior y solo depende de java.net.http, Jackson y las anotaciones de nulidad de JSpecify. Cada método tiene una variante ...Async que devuelve un CompletableFuture. Consulta la visión general de los SDK de servidor para ver lo que comparten todos los SDK.

Instalación

El artefacto es me.didit:didit-java en Maven Central. Su código fuente y su registro de cambios están en didit-protocol/sdk-java, en GitHub.

Configurar el cliente

new Didit() lee DIDIT_API_KEY del entorno. Usa el builder 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).
Los tipos de solicitud son builders cuyo build() comprueba los campos obligatorios. Los campos opcionales de la respuesta son valores Optional; en Kotlin, léelos con .getOrNull(). Los fragmentos de esta página y de cada página de la referencia de la API son el cuerpo de un método, con los imports que necesitan encima.

Crear una sesión

Crea una sesión de verificación para un workflow y envía a tu usuario a su URL.

Leer la decisión

Cuando el usuario termine (o cuando llegue el webhook), lee el resultado. Cada resultado de función es una lista con una entrada por nodo del flujo.

Verificar un webhook

Pasa el cuerpo sin procesar, exactamente como se recibió, y los encabezados de la solicitud. Webhooks.verify lanza WebhookVerificationException ante cualquier cosa que no sea una entrega válida y reciente, y en caso contrario devuelve un evento tipado.
En Spring Boot, recibe el cuerpo como @RequestBody byte[] body y los encabezados como @RequestHeader Map<String, String> headers. Para aceptar dos secretos mientras rotas uno, pasa VerifyOptions. 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 para su monitorización de transacciones; la respuesta incluye su estado y su puntuación de riesgo.

Verificar tokens de Authentication

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

Errores

Todas las excepciones extienden la excepción no comprobada DiditException.

Listas y archivos

Las páginas de endpoints de servidor de la referencia de la API incluyen un ejemplo en Java para su uso, salvo los endpoints y campos que aún no están disponibles en ninguna versión 1.0.1, indicados en la visión general.
Última modificación el 1 de noviembre de 2026