API per eliminar sessions: dret a l'oblit (RGPD)

​

Suport per a KYC i KYB

​

Comportament

• La sessió s’elimina juntament amb tots els intents de verificació que conté, inclosos els resultats que una nova presentació ha substituït: la seva decisió, les dades extretes, els registres de les funcionalitats associades (verificacions d’identitat, consultes al registre, documents, AML, anàlisi d’IP, etc.), les revisions i el registre d’activitat, i tots els seus fitxers emmagatzemats.
• Eliminar una sessió de Verificació d’empreses (KYB) també elimina, de manera recursiva, les verificacions que s’han creat per a les seves persones clau (KYC) i per als seus propietaris corporatius (KYB). La resposta indica quantes n’hi ha al camp deleted_child_verifications. Una verificació només enllaçada, com un KYC aprovat existent que s’hagi reutilitzat, no s’elimina.
• Les dades de signatura electrònica s’eliminen amb la sessió: els documents per signar i els seus fitxers originals de Word, els PDF signats, els PDF d’evidències, les imatges de signatura i tots els valors dels camps. Les seves rutes de descàrrega retornen 404.
• La sessió deixa d’aparèixer immediatament a les respostes de llista i de decisió, i les URL de contingut multimèdia emeses abans de la crida deixen de resoldre’s.
• Els lliuraments de webhook pendents de la sessió, i els seus reintents, es descarten.
• El monitoratge AML continu i el monitoratge del registre KYB iniciats per les verificacions eliminades s’aturen.
• L’eliminació és permanent i irreversible. No hi ha cap endpoint per restaurar la sessió, de manera que has d’exportar tot el que necessitis, com ara un PDF de la decisió, abans de cridar-lo.
• La resposta és 200 OK, enviada un cop completada l’eliminació, amb un cos JSON que indica què ha passat amb les dades biomètriques facials de la sessió. Consulta la Migració si el teu client encara espera 204.

​

Dades en un informe regulatori finalitzat

{
  "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"
    }
  ]
}

​

Dades biomètriques facials: eliminar o conservar

1. Política de l’aplicació a Business Console → App Settings → Data retention o mitjançant PATCH /v3/webhook/ (face_retention_policy, face_retention_days). Consulta Conservació de dades.
2. Substitució per crida amb retain_face_embeddings en aquest endpoint i a Eliminar sessions en lot.
3. Classe d’instrucció amb deletion_instruction. Una instrucció privacy_erasure sempre preval: purga totes les plantilles retingudes d’aquest usuari i mai no en retén de noves.

​

Cos de la sol·licitud

​

Resposta

{
  "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
}

​

Durada de la retenció i caducitat

1. face_retention_days de la sol·licitud o, quan la sol·licitud l’omet, el face_retention_days de l’aplicació;
2. la finestra general de conservació de dades de l’aplicació, quan n’hi ha una de configurada;
3. face_retention_deadline de la sol·licitud, quan se n’ha proporcionat un.

​

Esborrat per motius de privacitat

​

Què no es veu afectat

• Les entrades de la llista de bloqueig creades a partir de la sessió (facial o de document) es mantenen. Elimina-les de la llista de bloqueig. Una entrada facial a la llista de bloqueig conserva la seva pròpia entrada biomètrica, independent de qualsevol plantilla retinguda.
• Els tokens de compartició ja emesos per a la sessió no es revoquen, però ja no hi ha res que puguin importar: una importació amb un d’aquests tokens retorna 400 amb {"share_token": ["Original session does not exist."]}.
• Els webhooks ja lliurats de la sessió no es veuen afectats. Els lliuraments encara pendents a la cua, i els seus reintents, es descarten. No s’emet cap webhook per l’esborrament en si.
• Els crèdits ja consumits per la verificació no es reemborsen.
• Les còpies signades ja enviades per correu electrònic a un signant mitjançant un pas de signatura electrònica són a la safata d’entrada del signant i no es veuen afectades.
• L’entitat pare Usuari o Empresa no s’esborra. Utilitza Esborrar usuaris o Esborrar empreses per a aquestes. Si el retrat del perfil de l’usuari provenia de la sessió esborrada, el retrat s’elimina.
• Una plantilla biomètrica retinguda (només si hi has optat) es manté fins que caduca o fins que la purgues. Purga-la amb l’API de plantilles biomètriques, esborrant l’usuari, o repetint l’esborrament d’una altra sessió del mateix usuari amb 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
}

​

Errors

​

Permís

​

Esborrament en lot

​

Migració des de respostes 204

​

Relacionat

• Plantilles biomètriques
• Conservació de dades
• Visió general de les sessions