Zum Hauptinhalt springen
Die offizielle Didit-Bibliothek für Java und Kotlin. Sie erfordert Java 11 oder höher und hängt ausschließlich von java.net.http, Jackson sowie den JSpecify-Nullness-Annotationen ab. Jede Methode verfügt über eine ...Async-Variante, die ein CompletableFuture zurückgibt. In der Übersicht über die Server-SDKs erfahren Sie, was alle SDKs gemeinsam haben.

Installieren

Das Artefakt ist me.didit:didit-java auf Maven Central. Der Quellcode und das Changelog befinden sich in didit-protocol/sdk-java auf GitHub.

Den Client konfigurieren

new Didit() liest DIDIT_API_KEY aus der Umgebung aus. Verwenden Sie den Builder, um diesen zu überschreiben oder um die Organisations- und Anwendungs-IDs festzulegen, die für anwendungsbezogene Aufrufe (Fälle, Netzwerke, aufsichtsrechtliche Berichte) erforderlich sind.
Anfragetypen sind Builder, deren build()-Methode die erforderlichen Felder prüft. Optionale Antwortfelder sind Optional-Werte; in Kotlin lesen Sie diese mit .getOrNull() aus. Die Snippets auf dieser Seite und auf den einzelnen Seiten der API-Referenz stellen den Rumpf einer Methode dar, mit den jeweils benötigten Imports darüber.

Eine Sitzung erstellen

Erstellen Sie eine Verifizierungssitzung für einen Workflow und leiten Sie Ihren Benutzer an deren URL weiter.

Die Entscheidung abrufen

Wenn der Benutzer den Vorgang abschließt (oder wenn der Webhook eintrifft), rufen Sie die Entscheidung ab. Jedes Funktionsergebnis ist eine Liste mit einem Eintrag pro Workflow-Knoten.

Einen Webhook verifizieren

Übergeben Sie den Roh-Body exakt so, wie er empfangen wurde, sowie die Anfrage-Header. Webhooks.verify wirft eine WebhookVerificationException für alles, was keine gültige, aktuelle Zustellung ist, und gibt andernfalls ein typisiertes Ereignis zurück.
Nehmen Sie den Body in Spring Boot als @RequestBody byte[] body und die Header als @RequestHeader Map<String, String> headers entgegen. Um zwei Secrets zu akzeptieren, während Sie eines rotieren, übergeben Sie VerifyOptions. Siehe Webhooks für die Ereignisse und das Signaturschema.

Eine Transaktion screenen

Übermitteln Sie eine Zahlung, eine Auszahlung oder einen Krypto-Transfer an die Transaktionsüberwachung; die Antwort enthält deren Status und den Risiko-Score.

Authentication-Token verifizieren

Authentication überprüft die Zugriffstoken, die Ihr Authentication-Issuer signiert, in Ihrem Backend, ohne Didit bei jeder Anfrage aufzurufen. Es tauscht außerdem Codes aus, aktualisiert Token, prüft und widerruft Sitzungen und führt Step-ups durch.
Die Token-Verifizierung führt die in Token auf Ihrem Server verifizieren beschriebenen Prüfungen anhand des Issuers und der Signaturschlüssel Ihrer Anwendung durch.

Fehler

Jede Exception erbt von der ungeprüften DiditException.

Listen und Dateien

Die Server-Endpoint-Seiten der API-Referenz enthalten für ihre jeweilige Operation ein Java-Beispiel, mit Ausnahme der im Überblick genannten Endpoints und Felder, die bisher in keinem 1.0.1-Release enthalten sind.
Zuletzt geändert am 7. November 2026