Passer au contenu principal
POST
curl
Utilisez ce prompt lorsque le lien précédent ne fonctionne plus : la session a été supprimée, ou elle a expiré avant que la personne ne la démarre. Les sessions supprimées sont éligibles même si la personne avait déjà commencé ou terminé la vérification. Les sessions importées ne sont pas éligibles en cas d’expiration ; elles doivent avoir été supprimées. Une session qui n’a pas été supprimée et que la personne avait déjà commencée n’est pas éligible en cas d’expiration. La nouvelle session est liée à la même partie, de sorte que son résultat est pris en compte dans la vérification des personnes clés comme l’aurait été celui de la session d’origine. Son lien reste valide pendant la durée d’expiration de la session du workflow KYC qu’elle exécute (de 1 heure à 4 semaines), et non pendant celle de la session d’entreprise. Consultez la partie et ses sessions enfants dans la décision de session d’entreprise. Si la personne ne doit pas être vérifiée du tout, ignorez la partie à la place. Voir Personnes clés pour savoir comment les parties et leurs vérifications fonctionnent.

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 parente de Vérification d'entreprise (KYB).

Exemple:

"33333333-4444-5555-6666-777777777777"

partyUuid
string<uuid>
requis

UUID de la partie « personnes clés » (key_people_checks[].submitted.parties[].uuid sur la décision de la session d'entreprise). Doit appartenir à la session référencée par sessionId.

Exemple:

"0a3f1e2c-7c2f-4a1b-9d55-2f8d2a5d6b41"

Réponse

Nouvelle session KYC créée. Renvoie la partie mise à jour avec sa nouvelle session enfant, qui expire après le délai d'expiration de session de son workflow KYC.

Une personne clé d'une session de Vérification d'entreprise (KYB), avec sa vérification enfant. La même partie apparaît dans key_people_checks[].submitted.parties[] de la décision de session d'entreprise.

uuid
string<uuid>
requis

Identifiant de la partie.

entity_type
enum<string>
requis

Indique si la partie est un particulier ou une entreprise.

Options disponibles:
person,
company
source
enum<string>
requis

REGISTRY : provient du registre des sociétés. USER : saisi dans l'écran Key People.

Options disponibles:
REGISTRY,
USER
name
string
requis

Nom d'affichage de la partie.

is_active
boolean
requis

Indique si la partie est active.

is_skipped
boolean
requis

Indique si la partie est exemptée de vérification. Une régénération l'efface.

requires_verification
boolean
requis

Indique si les règles de rôle et d'actionnariat exigent une vérification pour cette partie.

roles
object[]
requis

Rôles que la partie détient dans l'entreprise.

kyc_session_deleted
boolean
requis

La session KYC enfant a été supprimée, elle ne pourra donc jamais aboutir.

kyb_sub_session_deleted
boolean
requis

Équivalent côté entreprise de kyc_session_deleted.

first_name
string | null

Prénom (personnes physiques).

last_name
string | null

Nom de famille (personnes physiques).

company_name
string | null

Nom de l'entreprise (parties de type entreprise).

registration_number
string | null

Numéro d'immatriculation de l'entreprise (parties de type entreprise).

email
string<email> | null

E-mail auquel le lien de vérification est envoyé.

nationality
string | null

Nationalité pour les personnes physiques, pays de constitution pour les entreprises.

phone_number
string | null

Numéro de téléphone recueilli pour la partie.

date_of_birth
string<date> | null

Date de naissance (personnes).

position
string | null

Intitulé de poste en texte libre (personnes physiques).

custom_fields
object

Champs personnalisés définis par le workflow collectés pour la partie, indexés par clé de champ.

kyc_session_id
string<uuid> | null

Session KYC individuelle enfant (personnes).

kyc_session_status
enum<string> | null

Statut de la session KYC enfant. Une session supprimée conserve le statut qu'elle avait au moment de sa suppression.

Options disponibles:
Not Started,
In Progress,
Approved,
Declined,
In Review,
Expired,
Abandoned,
Kyc Expired,
Resubmitted,
Awaiting User,
null
kyc_session_url
string<uri> | null

Lien hébergé de la session KYC enfant. null lorsqu'il n'y en a pas ou qu'elle a été supprimée, ainsi que pour une clé API restreinte sans sessions: write.

kyb_sub_session_id
string<uuid> | null

Session KYB enfant (parties morales).

kyb_sub_session_status
enum<string> | null

Statut de la session KYB enfant.

Options disponibles:
Not Started,
In Progress,
Approved,
Declined,
In Review,
Expired,
Abandoned,
Kyc Expired,
Resubmitted,
Awaiting User,
null
kyb_sub_session_url
string<uri> | null

Lien hébergé de la session KYB enfant, avec les mêmes règles de valeur null que kyc_session_url.

verification_workflow_type
enum<string> | null

Type de workflow exécuté par la session enfant.

Options disponibles:
kyc,
kyb,
adaptive_age_verification,
biometric_authentication,
address_verification,
questionnaire_verification,
email_verification,
phone_verification,
null
verification_workflow_id
string<uuid> | null

Workflow exécuté par la session enfant.

verification_workflow_label
string | null

Libellé de ce workflow.

verification_workflow_features
object[] | null

Fonctionnalités du workflow de la session enfant avec leur statut actuel.

didit_internal_id
string<uuid> | null

Identifiant Didit de la personne vérifiée, une fois connue.

Dernière modification le 7 novembre 2026