> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # SDK de Java y Kotlin para KYC, AML y transacciones > Guía rápida del SDK oficial de Didit para Java y Kotlin: builders tipados, llamadas síncronas y asíncronas, verificación de webhooks y tokens. 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](https://docs.didit.me/es/integration/server-sdks/overview.md) para ver lo que comparten todos los SDK. ## Instalación ```kotlin Gradle theme={null} implementation("me.didit:didit-java:1.0.1") ``` ```xml Maven theme={null} me.didit didit-java 1.0.1 ``` El artefacto es [`me.didit:didit-java` en Maven Central](https://central.sonatype.com/artifact/me.didit/didit-java). Su código fuente y su registro de cambios están en [didit-protocol/sdk-java](https://github.com/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). ```java theme={null} import java.time.Duration; import me.didit.Didit; import me.didit.core.RequestOptions; import me.didit.types.SessionsRetrieveDecisionParams; Didit client = Didit.builder() .apiKey(System.getenv("DIDIT_API_KEY")) .organizationId(System.getenv("DIDIT_ORGANIZATION_ID")) .applicationId(System.getenv("DIDIT_APPLICATION_ID")) .timeout(Duration.ofSeconds(30)) .maxRetries(2) .build(); // Options for a single call. var decision = client.sessions().retrieveDecision("11111111-2222-3333-4444-555555555555", SessionsRetrieveDecisionParams.builder().build(), RequestOptions.builder().timeout(Duration.ofSeconds(5)).build()); System.out.println(decision.status().orElse(null)); ``` 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](https://docs.didit.me/es/api-reference/overview.md) son el cuerpo de un método, con los imports que necesitan encima. ## Crear una sesión Crea una [sesión de verificación](https://docs.didit.me/es/sessions-api/create-session.md) para un workflow y envía a tu usuario a su URL. ```java theme={null} import me.didit.Didit; import me.didit.types.SessionsCreateParams; Didit client = new Didit(); var session = client.sessions().create(SessionsCreateParams.builder() .workflowId("11111111-2222-3333-4444-555555555555") .vendorData("user-123") .callback("https://example.com/verification/done") .build()); System.out.println(session.url()); ``` ## Leer la decisión Cuando el usuario termine (o cuando llegue el webhook), [lee el resultado](https://docs.didit.me/es/sessions-api/retrieve-session.md). Cada resultado de función es una lista con una entrada por nodo del flujo. ```java theme={null} import java.util.List; import me.didit.Didit; Didit client = new Didit(); var decision = client.sessions().retrieveDecision("11111111-2222-3333-4444-555555555555"); decision.status().ifPresent(status -> System.out.println(status)); for (var verification : decision.idVerifications().orElse(List.of())) { System.out.println(verification.status().orElse(null)); } ``` ## 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. ```java theme={null} import java.util.Map; import me.didit.errors.WebhookVerificationException; import me.didit.webhooks.SessionStatusUpdatedEvent; import me.didit.webhooks.WebhookEvent; import me.didit.webhooks.Webhooks; public class DiditWebhookHandler { private final String secret = System.getenv("DIDIT_WEBHOOK_SECRET"); public int handle(byte[] rawBody, Map headers) { WebhookEvent event; try { event = Webhooks.verify(rawBody, headers, secret); } catch (WebhookVerificationException e) { System.out.println("rejected: " + e.reason()); return 400; } if (event instanceof SessionStatusUpdatedEvent) { SessionStatusUpdatedEvent updated = (SessionStatusUpdatedEvent) event; System.out.println(updated.sessionId().orElse("") + " " + updated.status().orElse("")); } return 200; } } ``` En Spring Boot, recibe el cuerpo como `@RequestBody byte[] body` y los encabezados como `@RequestHeader Map headers`. Para aceptar dos secretos mientras rotas uno, pasa `VerifyOptions`. Consulta [Webhooks](https://docs.didit.me/es/integration/webhooks.md) 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](https://docs.didit.me/es/transaction-monitoring/overview.md); la respuesta incluye su estado y su puntuación de riesgo. ```java theme={null} import me.didit.Didit; import me.didit.types.TransactionsCreateParams; Didit client = new Didit(); var transaction = client.transactions().create(TransactionsCreateParams.builder() .transactionId("txn-1001") .transactionCategory(TransactionsCreateParams.TransactionCategory.of("finance")) .transactionDetails(TransactionsCreateParams.TransactionDetails.builder() .direction(TransactionsCreateParams.TransactionDetails.Direction.of("outbound")) .amount(1500.0) .currency("EUR") .build()) .subject(TransactionsCreateParams.Subject.builder() .entityType("individual") .vendorData("user-123") .fullName("Maria Garcia") .build()) .build()); System.out.println(transaction.status().orElse(null) + " " + transaction.score().orElse(null)); ``` ## Verificar tokens de Authentication `Authentication` comprueba en tu backend los tokens de acceso que firma tu emisor de [Authentication](https://docs.didit.me/es/authentication/overview.md), sin llamar a Didit en cada solicitud. También intercambia códigos, renueva tokens, comprueba y revoca sesiones y ejecuta step-ups. > [!NOTE] > > La verificación de tokens realiza las comprobaciones de [Verificar un token en tu servidor](https://docs.didit.me/es/authentication/tokens-and-jwks.md#verificar-un-token-en-tu-servidor), con el emisor y las claves de firma de tu aplicación. ```java theme={null} import me.didit.authentication.AccessTokenClaims; import me.didit.authentication.Authentication; import me.didit.errors.TokenVerificationException; public class CurrentUser { // The publishable key (pk_live_... or pk_test_...) carries your issuer URL. private final Authentication auth = Authentication.builder() .publishableKey("pk_live_...") .clientId("your-application-id") .build(); public String subject(String accessToken) { try { AccessTokenClaims claims = auth.verifyAccessToken(accessToken); return claims.subject(); } catch (TokenVerificationException e) { System.out.println("rejected: " + e.reason()); return null; } } } ``` ## Errores Todas las excepciones extienden la excepción no comprobada `DiditException`. ```java theme={null} import me.didit.Didit; import me.didit.errors.ApiStatusException; import me.didit.errors.NotFoundException; Didit client = new Didit(); try { client.sessions().retrieveDecision("11111111-2222-3333-4444-555555555555"); } catch (NotFoundException e) { System.out.println("no such session"); } catch (ApiStatusException e) { System.out.println(e.statusCode() + " " + e.requestId().orElse("")); } ``` ## Listas y archivos ```java theme={null} import java.nio.file.Path; import me.didit.Didit; import me.didit.types.IdVerificationVerifyParams; import me.didit.types.SessionsListParams; Didit client = new Didit(); // Lists page through every result. for (var session : client.sessions().list(SessionsListParams.builder().status("Approved").build())) { System.out.println(session); } // Uploads take a Path or a FileUpload (bytes or a stream). var result = client.idVerification().verify(IdVerificationVerifyParams.builder() .frontImage(Path.of("id-front.jpg")) .backImage(Path.of("id-back.jpg")) .build()); System.out.println(result); ``` Las páginas de endpoints de servidor de la [referencia de la API](https://docs.didit.me/es/api-reference/overview.md) 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](https://docs.didit.me/es/integration/server-sdks/overview.md). This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.