Passer au contenu principal
POST
curl

Prise en charge KYC et KYB

Fonctionne pour les sessions Vérification des utilisateurs (KYC) et Vérification d’entreprise (KYB). Didit résout le session_id pour les deux types de session et génère un token JWT de partage qui inclut :
Lorsque le partenaire destinataire importe le token, Didit clone la session du type correspondant (KYC ou KYB), avec ses relations.

Prérequis

  • La session doit être dans un statut terminé (APPROVED, DECLINED, IN_REVIEW).
  • Vous devez disposer du privilège write:sessions.
  • Le for_application_id doit correspondre à une application Didit valide (généralement celle d’un partenaire).

Exemples

Réponse :

Limites du TTL

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 source pour laquelle générer un token.

Exemple:

"11111111-2222-3333-4444-555555555555"

Corps

application/json
for_application_id
string<uuid>
requis

UUID de l'application Didit qui échangera le token. Doit exister, ne doit pas être supprimée et doit différer de l'application appelante. Retrouvez-le dans la Business Console sous Settings → Application.

Exemple:

"a5f3bca2-46e2-411e-90ef-a580900a57ee"

ttl_in_seconds
integer
défaut:3600

Durée de vie du token, en secondes. Minimum 60, maximum 86400 (24 h). Vaut par défaut 3600 (1 h).

Plage requise: 60 <= x <= 86400
Exemple:

3600

Réponse

Token de partage généré.

share_token
string

JWT signé avec HS256. Transmettez-le tel quel en tant que share_token à POST /v3/session/import-shared/ sur l'application cible.

Exemple:

"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

for_application_id
string<uuid>

Renvoie l'UUID de l'application cible à laquelle le token est associé.

Exemple:

"a5f3bca2-46e2-411e-90ef-a580900a57ee"

session_kind
enum<string>

Indique si la session source est une session de Vérification des utilisateurs (KYC) ou de Vérification d'entreprise (KYB).

Options disponibles:
user,
business
Dernière modification le 7 novembre 2026