Passer au contenu principal
La bibliothèque officielle Didit pour Node.js et TypeScript. Elle fonctionne sur Node.js 18 ou version ultérieure, Bun, Deno et les runtimes edge avec fetch, fournit des builds ES module et CommonJS, et ne comporte aucune dépendance d’exécution. Consultez la vue d’ensemble des SDK serveur pour connaître les éléments communs à tous les SDK.

Installer

Le paquet est @didit-protocol/sdk-node sur npm. Son code source et son journal des modifications se trouvent dans didit-protocol/sdk-node sur GitHub.

Configurer le client

new Didit() lit DIDIT_API_KEY depuis l’environnement sur Node.js, Bun et Deno (avec --allow-env). Les runtimes edge n’ont pas d’environnement de processus, vous devez donc y transmettre la clé en option : new Didit({ apiKey: env.DIDIT_API_KEY }). Transmettez des options pour la remplacer, ou pour définir les identifiants d’organisation et d’application nécessaires aux appels limités à une application (dossiers, réseaux, rapports réglementaires). Le délai d’expiration est exprimé en millisecondes.
Avec CommonJS, utilisez const { Didit } = require("@didit-protocol/sdk-node");.

Créer une session

Créez une session de vérification pour un workflow et redirigez votre utilisateur vers son URL. Les champs de la requête conservent les noms définis par l’API.

Lire la décision

Lorsque l’utilisateur termine (ou à l’arrivée du webhook), lisez la décision. Chaque résultat de fonctionnalité est une liste contenant une entrée par nœud de workflow, et les dates et heures sont des objets Date.

Vérifier un webhook

Transmettez le corps brut (pas le JSON analysé) et les en-têtes de la requête : un objet req.headers Node.js ou Express, un objet Headers Fetch ou des paires [name, value] (le type WebhookHeaders). verify renvoie une promesse et la rejette avec WebhookVerificationError pour tout ce qui n’est pas une livraison valide et récente.
Avec Express, lisez le corps avec express.raw({ type: "application/json" }) et appelez handleWebhook(req.body, req.headers). Pendant la rotation du secret, transmettez les deux : [newSecret, oldSecret]. Consultez Webhooks pour connaître les événements et le mécanisme de signature.

Analyser 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 l’émetteur de votre Authentication, sur 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 révoquer des sessions, et d’exécuter des étapes de renforcement de l’authentification.
La vérification de token applique 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

Listes et fichiers

Les pages des endpoints serveur de la référence API proposent un exemple Node.js pour leur opération, à l’exception des endpoints et champs pas encore inclus dans une version 1.0.1, mentionnés dans la vue d’ensemble.
Dernière modification le 7 novembre 2026