API de suppression de session : droit à l'oubli RGPD

​

Prise en charge KYC et KYB

​

Comportement

• La session est supprimée avec toutes les tentatives de vérification qu’elle contient, y compris les résultats remplacés par une nouvelle soumission : sa décision, ses données extraites, ses enregistrements associés aux fonctionnalités (vérifications d’identité, contrôles de registre, documents, AML, analyse IP, etc.), ses examens et son journal d’activité, ainsi que tous ses fichiers stockés.
• La suppression d’une session Vérification d’entreprise (KYB) supprime aussi, de manière récursive, les vérifications créées pour ses personnes clés (KYC) et ses propriétaires d’entreprise (KYB). La réponse indique leur nombre dans deleted_child_verifications. Une vérification à laquelle la session n’est que liée, comme un KYC approuvé existant qu’elle a réutilisé, n’est pas supprimée.
• Les données de signature électronique sont supprimées avec la session : les documents à signer et leurs fichiers Word d’origine, les PDF signés, les PDF de preuve, les images de signature et toutes les valeurs des champs. Leurs chemins de téléchargement renvoient 404.
• La session disparaît immédiatement des réponses de liste et de décision, et les URL des médias émises avant l’appel cessent de fonctionner.
• Les livraisons de webhook encore en file d’attente pour la session, ainsi que leurs nouvelles tentatives, sont abandonnées.
• La surveillance AML continue et la surveillance du registre KYB démarrées par les vérifications supprimées s’arrêtent.
• La suppression est définitive et irréversible. Il n’existe aucun endpoint de restauration : exportez donc tout ce dont vous avez besoin, comme un PDF de décision, avant d’appeler cet endpoint.
• La réponse est 200 OK, envoyée une fois la suppression terminée, avec un corps JSON qui indique ce qu’il est advenu des données biométriques faciales de la session. Consultez Migration si votre client attend encore un 204.

​

Données d’un rapport réglementaire finalisé

{
  "detail": "This session is part of a finalized regulatory report, so it cannot be deleted.",
  "code": "in_filed_report",
  "reports": [
    {
      "uuid": "5ec00000-0000-4000-8000-000000000007",
      "report_number": "SAR-0001",
      "report_type": "SAR",
      "case_uuid": "c1a5e000-0000-4000-8000-000000000001"
    }
  ]
}

​

Données biométriques faciales : supprimer ou conserver

1. Politique de l’application dans Business Console → App Settings → Data retention ou via PATCH /v3/webhook/ (face_retention_policy, face_retention_days). Voir Conservation des données.
2. Dérogation par appel avec retain_face_embeddings sur cet endpoint et sur Suppression de sessions par lot.
3. Classe d’instruction avec deletion_instruction. Une instruction privacy_erasure l’emporte toujours : elle purge chaque gabarit conservé pour cet utilisateur et n’en conserve jamais de nouveau.

​

Corps de la requête

​

Réponse

{
  "session_id": "4c5c7f3a-3b1d-4b7e-9c39-2b4f7e6a1d02",
  "session_number": 1024,
  "face_retention_outcome": "retained_with_user",
  "biometric_template_uuid": "9d2f4b6e-1c3a-4e8f-b7d5-0a1c2e3f4a5b",
  "biometric_template_expires_at": "2027-10-09T10:15:00Z",
  "deleted_child_verifications": 0
}

​

Durée de conservation et expiration

1. face_retention_days de la requête, ou le face_retention_days de l’application lorsque la requête ne le fournit pas ;
2. la fenêtre générale de conservation des données de l’application, lorsqu’elle est configurée ;
3. face_retention_deadline de la requête, lorsqu’il est fourni.

​

Effacement au titre de la vie privée

​

Ce qui n’est pas affecté

• Les entrées de la liste de blocage créées à partir de la session (visage ou document) restent en place. Supprimez-les depuis la liste de blocage. Une entrée de liste de blocage faciale conserve sa propre entrée biométrique, indépendante de tout gabarit conservé.
• Les jetons de partage déjà émis pour la session ne sont pas révoqués, mais il n’y a plus rien à importer : une importation avec l’un de ces jetons renvoie 400 avec {"share_token": ["Original session does not exist."]}.
• Les webhooks déjà livrés pour la session ne sont pas affectés. Les livraisons encore en file d’attente, ainsi que leurs nouvelles tentatives, sont abandonnées. Aucun webhook n’est émis pour la suppression elle-même.
• Les crédits déjà consommés par la vérification ne sont pas remboursés.
• Les copies signées déjà envoyées par e-mail à un signataire lors d’une étape de signature électronique se trouvent dans la boîte de messagerie du signataire et ne sont pas affectées.
• L’entité parente Utilisateur ou Entreprise n’est pas supprimée. Utilisez Supprimer des utilisateurs ou Supprimer des entreprises pour ceux-ci. Si le portrait de profil de l’Utilisateur provient de la session supprimée, ce portrait est supprimé.
• Un gabarit biométrique conservé (uniquement si vous avez choisi cette option) reste en place jusqu’à son expiration ou jusqu’à ce que vous le purgiez. Purgez-le avec l’API des gabarits biométriques, en supprimant l’Utilisateur, ou en répétant la suppression d’une autre session du même Utilisateur avec deletion_instruction: "privacy_erasure".

​

Exemples

curl -X DELETE https://verification.didit.me/v3/session/4c5c7f3a-.../delete/ \
  -H "x-api-key: YOUR_API_KEY"

{
  "session_id": "4c5c7f3a-3b1d-4b7e-9c39-2b4f7e6a1d02",
  "session_number": 1024,
  "face_retention_outcome": "deleted",
  "biometric_template_uuid": null,
  "biometric_template_expires_at": null,
  "deleted_child_verifications": 0
}

curl -X DELETE https://verification.didit.me/v3/session/4c5c7f3a-.../delete/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"retain_face_embeddings": true, "face_retention_days": 365, "instruction_id": "cleanup-2026-08-0142"}'

{
  "session_id": "4c5c7f3a-3b1d-4b7e-9c39-2b4f7e6a1d02",
  "session_number": 1024,
  "face_retention_outcome": "retained_with_user",
  "biometric_template_uuid": "9d2f4b6e-1c3a-4e8f-b7d5-0a1c2e3f4a5b",
  "biometric_template_expires_at": "2027-10-09T10:15:00Z",
  "deleted_child_verifications": 0
}

curl -X DELETE https://verification.didit.me/v3/session/4c5c7f3a-.../delete/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"retain_face_embeddings": false}'

{
  "session_id": "4c5c7f3a-3b1d-4b7e-9c39-2b4f7e6a1d02",
  "session_number": 1024,
  "face_retention_outcome": "deleted",
  "biometric_template_uuid": null,
  "biometric_template_expires_at": null,
  "deleted_child_verifications": 0
}

curl -X DELETE https://verification.didit.me/v3/session/4c5c7f3a-.../delete/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"deletion_instruction": "privacy_erasure", "instruction_id": "dsar-2026-0142"}'

{
  "session_id": "4c5c7f3a-3b1d-4b7e-9c39-2b4f7e6a1d02",
  "session_number": 1024,
  "face_retention_outcome": "deleted",
  "biometric_template_uuid": null,
  "biometric_template_expires_at": null,
  "deleted_child_verifications": 0
}

curl -X DELETE https://verification.didit.me/v3/session/7a1e9c2d-.../delete/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"retain_face_embeddings": true, "face_retention_days": 365}'

{
  "session_id": "7a1e9c2d-5f4b-4c3a-8e2d-1b0a9f8e7d6c",
  "session_number": 1031,
  "face_retention_outcome": "ineligible_no_vendor_user",
  "biometric_template_uuid": null,
  "biometric_template_expires_at": null,
  "deleted_child_verifications": 0
}

curl -X DELETE https://verification.didit.me/v3/session/bs-01HJX1.../delete/ \
  -H "x-api-key: YOUR_API_KEY"

{
  "session_id": "0f3c9b7e-2d1a-4e5f-8c6b-7a9d8e1f2c3b",
  "session_number": 88,
  "face_retention_outcome": "none",
  "biometric_template_uuid": null,
  "biometric_template_expires_at": null,
  "deleted_child_verifications": 3
}

​

Erreurs

​

Autorisation

​

Suppression par lots

​

Migration depuis les réponses 204

​

Voir aussi

• Gabarits biométriques
• Conservation des données
• Vue d’ensemble des sessions