Passer au contenu principal
GET
cURL

Prise en charge de KYC et KYB

Cette fonctionnalité fonctionne pour les sessions Vérification des utilisateurs (KYC) et Vérification d’entreprise (KYB). Didit achemine automatiquement chaque session vers le modèle de PDF approprié :
  • Session Vérification des utilisateurs (KYC) → rapport avec des sections consacrées à la vérification d’identité, à la détection du vivant, à la correspondance faciale, à l’AML et au justificatif de domicile (POA).
  • Session Vérification d’entreprise (KYB) → rapport avec registre des sociétés, personnes clés (bénéficiaires effectifs et dirigeants), documents, AML, questionnaire, téléphone, e-mail et analyse de l’IP, lorsque ces fonctionnalités font partie du workflow.
Les deux types utilisent le même pipeline de génération de PDF et prennent en charge la personnalisation en marque blanche (logo, URL de la politique de confidentialité).

Convention de nommage des fichiers

Le fichier est renvoyé dans l’en-tête Content-Disposition: attachment; filename=....

Exigence de statut

La session doit être dans l’état APPROVED, DECLINED ou IN_REVIEW pour générer un PDF. Les sessions en cours ou non démarrées renvoient 403.

Exemples

Marque blanche

Lorsque la personnalisation en marque blanche est activée pour l’application, le PDF utilise votre logo et votre URL de politique de confidentialité. Configurez-les dans Console → Customization.

Autorisation

Requiert read:sessions. La même portée s’applique aux deux types.

Voir aussi

Autorisations

x-api-key
string
header
requis

La clé API de votre application, issue de Développeurs -> Clés API dans la Business Console. La clé principale dispose d'un accès complet. Une clé nommée peut être restreinte : aucun, lecture ou écriture par ressource, limitée à certains workflows ou aux sessions approuvées, à une liste d'adresses IP et à une date d'expiration. 401 signifie que la clé est incorrecte, révoquée ou expirée ; 403 signifie qu'aucune clé n'a été envoyée, que la clé n'a pas accès à cette ressource ou action, ou que la requête provient d'une adresse hors de sa liste d'IP ; 404 sur une route de session signifie que la session est hors des workflows ou des statuts de la clé. Une clé sans accès aux médias reçoit les URL d'images, de vidéos et de PDF à null, et une clé sans accès en écriture aux sessions reçoit les liens et tokens de session à null. Voir https://docs.didit.me/console/api-keys.

Paramètres de chemin

sessionId
string<uuid>
requis

UUID de la session de Vérification des utilisateurs (KYC) ou de Vérification d'entreprise (KYB) à générer — le session_id renvoyé par POST /v3/session/. Le même chemin fonctionne pour les deux types de session ; utilisez le nom de fichier dans Content-Disposition sur la réponse pour identifier le type de rapport que vous avez reçu.

Doit être un UUID bien formé en minuscules. La route ne correspond qu'aux UUID valides ; par conséquent, une valeur mal formée est rejetée par le routeur d'URL avant même l'exécution du code de l'application, et la réponse est une page HTML 404 plutôt que l'enveloppe JSON {"detail": ...} illustrée ci-dessous. Le convertisseur d'UUID de la route ne correspond qu'à la forme canonique en minuscules — les UUID avec des valeurs hexadécimales en majuscules sont rejetés avec l'erreur HTML 404.

Exemple:

"11111111-2222-3333-4444-555555555555"

Réponse

Le document PDF généré, renvoyé directement au format binaire application/pdf — il n'y a pas d'encapsulation JSON ni d'indirection par URL de téléchargement. Le corps commence par les octets magiques %PDF (PDF 1.7). Enregistrez-le dans un fichier .pdf ou transmettez-le à votre appelant sous forme de flux.

The response is of type file.

Dernière modification le 7 novembre 2026