Passer au contenu principal
La gem officielle de Didit pour Ruby. Elle nécessite Ruby 3.1 ou une version ultérieure et utilise net/http de la bibliothèque standard. Consultez la vue d’ensemble des SDK serveur pour connaître les éléments communs à tous les SDK.

Installation

La gem est didit-sdk sur RubyGems. Son code source et son journal des modifications sont disponibles dans didit-protocol/sdk-ruby sur GitHub. Vous pouvez aussi ajouter gem "didit-sdk" à votre Gemfile et exécuter bundle install. Chargez-la avec require "didit".

Configurer le client

Didit::Client.new lit DIDIT_API_KEY depuis l’environnement. Passez des arguments nommés pour le remplacer, ou pour définir les identifiants d’organisation et d’application dont ont besoin les appels à portée d’application (dossiers, réseaux, rapports réglementaires). Les champs de requête sont des arguments nommés portant les noms propres à l’API ; les réponses sont des objets dotés d’un accesseur par champ, [:field] et to_h.

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 dès que le webhook arrive), lisez la décision. Chaque résultat de fonctionnalité est une liste contenant une entrée par nœud du workflow.

Vérifier un webhook

Transmettez le corps brut, tel que reçu, et les en-têtes de la requête. verify lève Didit::WebhookVerificationError pour toute livraison qui n’est pas à la fois valide et récente, et renvoie un événement webhook typé dans le cas contraire.
Dans Rails, appelez handle_webhook(request.raw_post, request.headers). Pendant la rotation du secret, transmettez les deux : [new_secret, old_secret]. Consultez Webhooks pour les événements et le schéma de signature.

Filtrer une transaction

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

Vérifier les tokens Authentication

Didit::Authentication vérifie, côté backend et sans appeler Didit à chaque requête, les tokens d’accès signés par votre émetteur Authentication. Elle permet aussi d’échanger des codes, de rafraîchir les tokens, de vérifier et révoquer des sessions, et de lancer des étapes de renforcement.
La vérification des tokens effectue les contrôles décrits dans Vérifier un token sur votre serveur, avec l’émetteur et les clés de signature de votre application.

Erreurs

Listes et fichiers

Les pages d’endpoints serveur de la référence API comportent un exemple Ruby pour leur opération, à l’exception des endpoints et des champs qu’aucune version 1.0.1 ne propose encore, mentionnés dans la vue d’ensemble.
Dernière modification le 7 novembre 2026