Sitzung löschen API: DSGVO-Recht auf Vergessenwerden

​

KYC- und KYB-Unterstützung

​

Verhalten

• Die Sitzung wird zusammen mit jedem darin enthaltenen Verifizierungsversuch gelöscht, einschließlich der Ergebnisse, die durch eine erneute Einreichung ersetzt wurden: ihre Entscheidung, ihre extrahierten Daten, ihre zugehörigen Funktionsdatensätze (Ausweisverifizierungen, Registerprüfungen, Dokumente, AML, IP-Analyse usw.), ihre Prüfungen und das Aktivitätsprotokoll sowie alle ihre gespeicherten Dateien.
• Das Löschen einer Sitzung der Unternehmensverifizierung (KYB) löscht auch die Verifizierungen, die sie für ihre Schlüsselpersonen (KYC) und ihre Unternehmenseigentümer (KYB) erstellt hat, und zwar rekursiv. Die Antwort gibt in deleted_child_verifications an, wie viele dies sind. Eine Verifizierung, auf die sie lediglich verlinkt, wie etwa ein bestehendes, genehmigtes KYC, das wiederverwendet wurde, wird nicht gelöscht.
• E-Signatur-Daten werden mitgelöscht: die zu unterzeichnenden Dokumente und ihre ursprünglichen Word-Dateien, die signierten PDFs, die Nachweis-PDFs, die Signaturbilder und jeder Feldwert. Ihre Download-Pfade geben 404 zurück.
• Die Sitzung verschwindet sofort aus Listen- und Entscheidungsantworten, und Medien-URLs, die vor dem Aufruf ausgestellt wurden, lassen sich nicht mehr auflösen.
• Webhook-Zustellungen, die sich noch in der Warteschlange für die Sitzung befinden, sowie deren Wiederholungsversuche werden verworfen.
• Die laufende AML-Überwachung und die KYB-Registerüberwachung, die durch die gelöschten Verifizierungen gestartet wurden, werden beendet.
• Die Löschung ist dauerhaft und unwiderruflich. Es gibt keinen Wiederherstellungs-Endpoint; exportieren Sie daher alles, was Sie benötigen, wie etwa ein Entscheidungs-PDF, bevor Sie ihn aufrufen.
• Die Antwort ist 200 OK und wird gesendet, sobald die Löschung abgeschlossen ist, mit einem JSON-Body, der angibt, was mit den biometrischen Gesichtsdaten der Sitzung geschehen ist. Siehe Migration, falls Ihr Client noch 204 erwartet.

​

Daten in einem finalisierten aufsichtsrechtlichen Bericht

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

​

Biometrische Gesichtsdaten: löschen oder aufbewahren

1. Anwendungsrichtlinie in Business Console → App Settings → Data retention oder über PATCH /v3/webhook/ (face_retention_policy, face_retention_days). Siehe Datenaufbewahrung.
2. Überschreibung pro Aufruf mit retain_face_embeddings an diesem Endpoint und bei Sitzungen stapelweise löschen.
3. Anweisungsklasse mit deletion_instruction. Eine privacy_erasure-Anweisung hat immer Vorrang: Sie bereinigt jedes aufbewahrte Template für diesen Benutzer und behält niemals ein neues auf.

​

Request-Body

​

Antwort

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

​

Aufbewahrungsdauer und Ablauf

1. face_retention_days aus der Anfrage oder face_retention_days der Anwendung, wenn die Anfrage diesen Wert weglässt;
2. das allgemeine Datenaufbewahrungsfenster der Anwendung, sofern eines konfiguriert ist;
3. face_retention_deadline aus der Anfrage, sofern angegeben.

​

Datenschutzrechtliche Löschung

​

Was nicht betroffen ist

• Sperrlisteneinträge, die aus der Sitzung erstellt wurden (Gesicht oder Dokument), bleiben bestehen. Entfernen Sie diese aus der Sperrliste. Ein Gesichts-Sperrlisteneintrag behält seinen eigenen biometrischen Eintrag, unabhängig von jedem gespeicherten Template.
• Bereits für die Sitzung ausgestellte Share-Token werden nicht widerrufen, aber es gibt für sie nichts mehr zu importieren: Ein Import mit einem solchen Token gibt 400 mit {"share_token": ["Original session does not exist."]} zurück.
• Bereits für die Sitzung zugestellte Webhooks sind nicht betroffen. Zustellungen, die sich noch in der Warteschlange befinden, sowie deren Wiederholungsversuche werden verworfen. Für die Löschung selbst wird kein Webhook ausgelöst.
• Bereits durch die Verifizierung verbrauchte Credits werden nicht zurückerstattet.
• Unterzeichnete Kopien, die bereits per E-Mail durch einen E-Signatur-Schritt an einen Unterzeichner gesendet wurden, verbleiben im Postfach des Unterzeichners und sind nicht betroffen.
• Die übergeordnete Entität Benutzer oder Unternehmen wird nicht gelöscht. Verwenden Sie dafür Delete Users oder Delete Businesses. Wenn das Profilporträt des Benutzers aus der gelöschten Sitzung stammte, wird das Porträt entfernt.
• Ein gespeichertes biometrisches Template (nur, wenn Sie sich dafür entschieden haben) bleibt bestehen, bis es abläuft oder Sie es löschen. Löschen Sie es mit der Biometric Templates API, indem Sie den Benutzer löschen oder indem Sie die Löschung einer anderen Sitzung desselben Benutzers mit deletion_instruction: "privacy_erasure" wiederholen.

​

Beispiele

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
}

​

Fehler

​

Berechtigung

​

Batch-Löschung

​

Migration von 204-Antworten

​

Ähnliche Themen

• Biometrische Templates
• Datenaufbewahrung
• Sitzungsübersicht