Удаление сессии API: право на забвение по GDPR

​

Поддержка KYC и KYB

​

Поведение

• Сессия удаляется вместе со всеми попытками верификации, которые она содержит, включая результаты, замененные повторной отправкой: её решение, извлечённые данные, связанные записи функций (верификации личности, проверки реестров, документы, AML, анализ IP и так далее), её ручные проверки и журнал активности, а также все её сохранённые файлы.
• Удаление сессии Верификация бизнеса (KYB) также удаляет верификации, созданные для её ключевых лиц (KYC) и корпоративных владельцев (KYB), рекурсивно. В ответе количество таких верификаций указано в deleted_child_verifications. Верификация, на которую сессия только ссылается, например уже одобренный KYC, который был повторно использован, не удаляется.
• Данные электронной подписи удаляются вместе с сессией: документы для подписания и их исходные файлы Word, подписанные PDF, PDF с доказательствами, изображения подписей и значения всех полей. Пути их загрузки возвращают 404.
• Сессия сразу исчезает из ответов списка и решений, а URL медиафайлов, выданные до вызова, перестают открываться.
• Доставки webhook, которые ещё стоят в очереди для сессии, и их повторные попытки отбрасываются.
• Постоянный AML-мониторинг и мониторинг реестров KYB, запущенные верификациями, которые были удалены, останавливаются.
• Удаление окончательное и необратимое. Эндпоинта для восстановления нет, поэтому экспортируйте всё необходимое, например PDF с решением, до вызова этого endpoint.
• Ответ имеет статус 200 OK, отправляется после завершения удаления и содержит JSON-тело, которое сообщает, что произошло с биометрическими данными лица сессии. См. Миграция, если ваш клиент всё ещё ожидает 204.

​

Данные в окончательно оформленном регуляторном отчёте

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

​

Биометрические данные лица: удалить или сохранить

1. Политика приложения в Business Console → App Settings → Data retention или через PATCH /v3/webhook/ (face_retention_policy, face_retention_days). См. Хранение данных.
2. Переопределение для отдельного вызова с помощью retain_face_embeddings в этом endpoint и в Пакетное удаление сессий.
3. Класс инструкции с помощью deletion_instruction. Инструкция privacy_erasure всегда имеет приоритет: она удаляет все сохранённые шаблоны этого пользователя и никогда не сохраняет новый.

​

Тело запроса

​

Ответ

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

​

Срок хранения и истечение

1. face_retention_days из запроса или face_retention_days приложения, если запрос его не содержит;
2. общий срок хранения данных, установленный для приложения, если он настроен;
3. face_retention_deadline из запроса, если он передан.

​

Удаление данных в целях защиты конфиденциальности

​

Что не затрагивается

• Записи блокировки, созданные из сессии (по лицу или по документу), остаются на месте. Удалите их в списке блокировки. Запись блокировки по лицу хранит собственную биометрическую запись, не зависящую от любого сохранённого шаблона.
• Токены общего доступа, уже выданные для сессии, не отзываются, но импортировать по ним больше нечего: импорт с таким токеном возвращает 400 с {"share_token": ["Original session does not exist."]}.
• Webhook-уведомления, уже доставленные для сессии, не затрагиваются. Доставки, которые ещё стоят в очереди, и их повторные попытки отбрасываются. Webhook для самого удаления не отправляется.
• Кредиты, уже списанные за верификацию, не возвращаются.
• Подписанные копии, уже отправленные подписанту по электронной почте на шаге «Электронная подпись», находятся в его почтовом ящике и не затрагиваются.
• Родительские сущности пользователь и компания не удаляются. Для них используйте удаление пользователей или удаление компаний. Если портрет профиля пользователя был получен из удаляемой сессии, портрет удаляется.
• Сохранённый биометрический шаблон (только если вы включили сохранение) остаётся до истечения срока или до очистки. Очистите его через API биометрических шаблонов, удалив пользователя или повторив удаление другой сессии того же пользователя с deletion_instruction: "privacy_erasure".

​

Примеры

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
}

​

Ошибки

​

Разрешения

​

Пакетное удаление

​

Миграция с ответов 204

​

Связанные материалы

• Биометрические шаблоны
• Хранение данных
• Обзор сессий