Passer au contenu principal
La bibliothèque officielle Didit pour Java et Kotlin. Elle nécessite Java 11 ou une version ultérieure et dépend uniquement de java.net.http, Jackson et des annotations de nullabilité JSpecify. Chaque méthode dispose d’une variante ...Async qui renvoie un CompletableFuture. Consultez la vue d’ensemble des SDK serveur pour découvrir ce que partagent tous les SDK.

Installation

L’artefact est me.didit:didit-java sur Maven Central. Son code source et son journal des modifications se trouvent dans didit-protocol/sdk-java sur GitHub.

Configurer le client

new Didit() lit DIDIT_API_KEY depuis l’environnement. Utilisez le builder pour la surcharger, ou pour définir les identifiants d’organisation et d’application requis par les appels à portée d’application (dossiers, réseaux, rapports réglementaires).
Les types de requête sont des builders dont le build() valide les champs obligatoires. Les champs de réponse optionnels sont des valeurs Optional ; en Kotlin, lisez-les avec .getOrNull(). Les extraits de code sur cette page et sur chaque page de la référence API représentent le corps d’une méthode, précédé des imports nécessaires.

Créer une session

Créez une session de vérification pour un workflow et redirigez votre utilisateur vers son URL.

Lire la décision

Lorsque l’utilisateur a terminé (ou à la réception du webhook), lisez la décision. Chaque résultat de fonctionnalité est une liste contenant une entrée par nœud de workflow.

Vérifier un webhook

Transmettez le corps brut, exactement tel qu’il a été reçu, ainsi que les en-têtes de la requête. Webhooks.verify lève WebhookVerificationException pour tout ce qui n’est pas une livraison valide et récente, et renvoie un événement typé dans le cas contraire.
Dans Spring Boot, récupérez le corps sous la forme @RequestBody byte[] body et les en-têtes sous la forme @RequestHeader Map<String, String> headers. Pour accepter deux secrets pendant que vous en renouvelez un, transmettez VerifyOptions. Consultez Webhooks pour connaître les événements et le mécanisme de signature.

Filtrer une transaction

Soumettez un paiement, un retrait ou un transfert crypto à la surveillance des transactions ; la réponse contient son statut et son score de risque.

Vérifier les tokens Authentication

Authentication vérifie les tokens d’accès signés par votre émetteur d’Authentication, dans votre backend, sans appeler Didit pour chaque requête. Il permet également d’échanger des codes, de rafraîchir des tokens, de vérifier et de révoquer des sessions, et d’effectuer des authentifications renforcées.
La vérification de token effectue les contrôles décrits dans Vérifier un token sur votre serveur, par rapport à l’émetteur et aux clés de signature de votre application.

Erreurs

Chaque exception hérite de l’exception non contrôlée DiditException.

Listes et fichiers

Les pages des endpoints serveur de la référence API proposent un exemple en Java pour leur opération, à l’exception des endpoints et des champs qu’aucune version 1.0.1 n’intègre encore, répertoriés dans la vue d’ensemble.
Dernière modification le 7 novembre 2026