Hapus Sesi API: Hak untuk Dilupakan GDPR

​

Dukungan KYC dan KYB

​

Perilaku

• Sesi dihapus beserta setiap percobaan verifikasi yang dimilikinya, termasuk hasil yang digantikan oleh pengajuan ulang: keputusannya, data yang diekstrak, catatan fitur terkait (verifikasi ID, pemeriksaan registri, dokumen, AML, analisis IP, dan seterusnya), catatan peninjauannya, log aktivitasnya, serta semua file yang tersimpan.
• Menghapus sesi Verifikasi Bisnis (KYB) juga menghapus verifikasi yang dibuat untuk pihak kunci (KYC) dan pemilik perusahaannya (KYB), secara rekursif. Respons melaporkan jumlahnya di deleted_child_verifications. Verifikasi yang hanya ditautkan, misalnya KYC yang sudah disetujui dan digunakan kembali, tidak dihapus.
• Data Tanda Tangan Elektronik ikut terhapus: dokumen yang akan ditandatangani beserta file Word aslinya, PDF yang sudah ditandatangani, PDF bukti, gambar tanda tangan, dan setiap nilai kolom. Jalur unduhnya mengembalikan 404.
• Sesi langsung hilang dari respons daftar dan respons keputusan, dan URL media yang diterbitkan sebelum pemanggilan berhenti berfungsi.
• Pengiriman webhook yang masih antre untuk sesi tersebut, beserta percobaan ulangnya, dibatalkan.
• Pemantauan AML Berkelanjutan dan pemantauan registri KYB yang dimulai oleh verifikasi yang dihapus ikut berhenti.
• Penghapusan bersifat permanen dan tidak dapat dibatalkan. Tidak ada endpoint pemulihan, jadi ekspor apa pun yang Anda perlukan, misalnya PDF keputusan, sebelum memanggil endpoint ini.
• Respons berupa 200 OK, dikirim setelah penghapusan selesai, dengan badan JSON yang melaporkan apa yang terjadi pada data biometrik wajah sesi tersebut. Lihat Migrasi jika klien Anda masih mengharapkan 204.

​

Data dalam laporan regulasi yang sudah final

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

​

Data biometrik wajah: hapus atau pertahankan

1. Kebijakan aplikasi di Business Console → App Settings → Data retention atau melalui PATCH /v3/webhook/ (face_retention_policy, face_retention_days). Lihat Data retention.
2. Override per panggilan dengan retain_face_embeddings pada endpoint ini dan pada Batch Delete Sessions.
3. Kelas instruksi dengan deletion_instruction. Instruksi privacy_erasure selalu didahulukan: instruksi ini menghapus permanen setiap templat yang dipertahankan untuk Pengguna tersebut dan tidak pernah mempertahankan templat baru.

​

Isi permintaan

​

Respons

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

​

Durasi retensi dan kedaluwarsa

1. face_retention_days dari permintaan, atau face_retention_days aplikasi jika permintaan tidak menyertakannya;
2. periode retensi data umum aplikasi, jika dikonfigurasi;
3. face_retention_deadline dari permintaan, jika disediakan.

​

Penghapusan privasi

​

Yang tidak terpengaruh

• Entri daftar blokir yang dibuat dari sesi (wajah atau dokumen) tetap ada. Hapus dari daftar blokir. Entri daftar blokir wajah tetap memiliki entri biometriknya sendiri, terlepas dari templat yang disimpan mana pun.
• Token berbagi yang sudah diterbitkan untuk sesi tidak dicabut, tetapi tidak ada yang tersisa untuk diimpor: impor dengan token tersebut mengembalikan 400 dengan {"share_token": ["Original session does not exist."]}.
• Webhook yang sudah terkirim untuk sesi tidak terpengaruh. Pengiriman yang masih antre, beserta percobaan ulangnya, dibatalkan. Tidak ada webhook yang dikirim untuk penghapusan itu sendiri.
• Kredit yang sudah terpakai oleh verifikasi tidak dikembalikan.
• Salinan bertanda tangan yang sudah dikirim melalui email kepada penandatangan pada langkah Tanda Tangan Elektronik tetap berada di kotak surat penandatangan dan tidak terpengaruh.
• Entitas induk Pengguna atau Bisnis tidak dihapus. Gunakan Hapus Pengguna atau Hapus Bisnis untuk itu. Jika potret profil Pengguna berasal dari sesi yang dihapus, potret tersebut akan dihapus.
• Templat biometrik yang disimpan (hanya jika Anda memilih untuk ikut serta) tetap ada sampai kedaluwarsa atau Anda menghapusnya. Hapus dengan API Templat Biometrik, dengan menghapus Pengguna, atau dengan mengulangi penghapusan sesi lain dari Pengguna yang sama dengan deletion_instruction: "privacy_erasure".

​

Contoh

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
}

​

Galat

​

Izin

​

Penghapusan massal

​

Migrasi dari respons 204

​

Terkait

• Templat biometrik
• Retensi data
• Ikhtisar sesi