SDK Java e Kotlin di Didit per KYC, AML e transazioni

La libreria ufficiale di Didit per Java e Kotlin. Richiede Java 11 o successivo e dipende solo da java.net.http, Jackson e dalle annotazioni di nullabilità JSpecify. Ogni metodo ha una variante ...Async che restituisce un CompletableFuture. Consulta la panoramica degli SDK server per ciò che tutti gli SDK hanno in comune.

Installazione

implementation("me.didit:didit-java:1.0.1")

<dependency>
  <groupId>me.didit</groupId>
  <artifactId>didit-java</artifactId>
  <version>1.0.1</version>
</dependency>

L’artefatto è me.didit:didit-java su Maven Central. Il suo codice sorgente e il registro delle modifiche si trovano in didit-protocol/sdk-java su GitHub.

Configura il client

new Didit() legge DIDIT_API_KEY dall’ambiente. Usa il builder per sovrascrivere il valore, oppure per impostare gli ID dell’organizzazione e dell’applicazione necessari alle chiamate con ambito applicativo (casi, reti, report normativi).

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));

I tipi di richiesta sono builder il cui build() verifica i campi obbligatori. I campi opzionali della risposta sono valori Optional; in Kotlin, leggili con .getOrNull(). I frammenti di codice di questa pagina e di ogni pagina del riferimento API sono il corpo di un metodo, con gli import necessari sopra di essi.

Crea una sessione

Crea una sessione di verifica per un workflow e invia il tuo utente al relativo URL.

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());

Leggi la decisione

Quando l’utente termina (o quando arriva il webhook), leggi la decisione. Ogni risultato di una funzionalità è una lista con una voce per ogni nodo del workflow.

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));
}

Verifica un webhook

Passa il corpo grezzo, esattamente come ricevuto, e le intestazioni della richiesta. Webhooks.verify lancia WebhookVerificationException per qualsiasi consegna che non sia valida e recente, e altrimenti restituisce un evento tipizzato.

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<String, String> 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;
    }
}

In Spring Boot, ricevi il body come @RequestBody byte[] body e le intestazioni come @RequestHeader Map<String, String> headers. Per accettare due segreti mentre ne ruoti uno, passa VerifyOptions. Consulta Webhooks per gli eventi e lo schema di firma.

Sottoponi una transazione a screening

Invia un pagamento, un prelievo o un trasferimento di criptovalute al monitoraggio delle transazioni; la risposta riporta il suo stato e il punteggio di rischio.

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));

Verifica i token di Authentication

Authentication verifica i token di accesso firmati dal tuo emittente di Authentication, nel tuo backend, senza chiamare Didit per ogni richiesta. Inoltre scambia i codici, aggiorna i token, controlla e revoca le sessioni ed esegue verifiche aggiuntive.

La verifica del token esegue i controlli descritti in Verifica un token sul tuo server, con l’emittente e le chiavi di firma della tua applicazione.

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;
        }
    }
}

Errori

Ogni eccezione estende DiditException, un’eccezione non controllata.

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(""));
}

Liste e file

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);

Le pagine degli endpoint server dell’API reference hanno un esempio Java per la loro operazione, tranne per gli endpoint e i campi che non sono ancora presenti in alcuna versione 1.0.1, indicati nella panoramica.

Guide

Autenticazione

Model Context Protocol (MCP)

SDK web

SDK nativi

SDK server

Integrazioni

SDK Java e Kotlin di Didit per KYC, AML e transazioni

Installazione

Configura il client

Crea una sessione

Leggi la decisione

Verifica un webhook

Sottoponi una transazione a screening

Verifica i token di Authentication

Errori

Liste e file

​Installazione

​Configura il client

​Crea una sessione

​Leggi la decisione

​Verifica un webhook

​Sottoponi una transazione a screening

​Verifica i token di Authentication

​Errori

​Liste e file

Installazione

Configura il client

Crea una sessione

Leggi la decisione

Verifica un webhook

Sottoponi una transazione a screening

Verifica i token di Authentication

Errori

Liste e file