API para excluir sessão: direito ao esquecimento do GDPR

​

Suporte a KYC e KYB

​

Comportamento

• A sessão é excluída junto com todas as tentativas de verificação que ela contém, incluindo resultados substituídos por um reenvio: sua decisão, seus dados extraídos, os registros dos recursos associados (verificações de identidade, consultas a registros, documentos, AML, análise de IP etc.), suas revisões e seu registro de atividades, além de todos os arquivos armazenados.
• Excluir uma sessão de Verificação de Empresas (KYB) também exclui, de forma recursiva, as verificações que ela criou para suas pessoas-chave (KYC) e para seus proprietários corporativos (KYB). A resposta informa quantas foram excluídas em deleted_child_verifications. Uma verificação à qual ela apenas faz referência, como um KYC aprovado já existente que foi reutilizado, não é excluída.
• Os dados de assinatura eletrônica também são excluídos: os documentos a assinar e seus arquivos Word originais, os PDFs assinados, os PDFs de evidências, as imagens das assinaturas e o valor de cada campo. Os caminhos de download desses arquivos retornam 404.
• A sessão desaparece imediatamente das respostas de listagem e de decisão, e as URLs de mídia emitidas antes da chamada deixam de funcionar.
• As entregas de webhook ainda na fila para a sessão, assim como suas novas tentativas, são descartadas.
• O monitoramento AML contínuo e o monitoramento de registros KYB iniciados pelas verificações excluídas são interrompidos.
• A exclusão é permanente e irreversível. Não existe endpoint de restauração, então exporte tudo de que você precisar, como o PDF de uma decisão, antes de fazer a chamada.
• A resposta é 200 OK, enviada quando a exclusão é concluída, com um corpo JSON que informa o que aconteceu com os dados biométricos faciais da sessão. Consulte Migração se o seu cliente ainda espera 204.

​

Dados em um relatório regulatório finalizado

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

​

Dados biométricos faciais: excluir ou reter

1. Política da aplicação em Business Console → App Settings → Data retention ou por meio de PATCH /v3/webhook/ (face_retention_policy, face_retention_days). Consulte Retenção de dados.
2. Substituição por requisição com retain_face_embeddings neste endpoint e em Excluir sessões em lote.
3. Classe de instrução com deletion_instruction. Uma instrução privacy_erasure sempre prevalece: ela remove todos os templates retidos desse Usuário e nunca retém um novo.

​

Corpo da requisição

​

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
}

​

Duração e expiração da retenção

1. o face_retention_days da requisição, ou o face_retention_days da aplicação quando a requisição o omite;
2. a janela geral de retenção de dados da aplicação, quando houver uma configurada;
3. o face_retention_deadline da requisição, quando informado.

​

Apagamento por privacidade

​

O que não é afetado

• As entradas da lista de bloqueio criadas a partir da sessão (de rosto ou de documento) permanecem. Remova-as da lista de bloqueio. Uma entrada de rosto na lista de bloqueio mantém o seu próprio registro biométrico, independente de qualquer template retido.
• Os tokens de compartilhamento já emitidos para a sessão não são revogados, mas não resta nada para eles importarem: uma importação com um deles retorna 400 com {"share_token": ["Original session does not exist."]}.
• Os webhooks já entregues para a sessão não são afetados. As entregas ainda na fila e suas tentativas de reenvio são descartadas. Nenhum webhook é emitido para a exclusão em si.
• Os créditos já consumidos pela verificação não são reembolsados.
• As cópias assinadas já enviadas por e-mail a um signatário por uma etapa de Assinatura eletrônica estão na caixa de correio do signatário e não são afetadas.
• A entidade Usuário ou Empresa à qual a sessão pertence não é excluída. Use Excluir usuários ou Excluir empresas para isso. Se o retrato do perfil do Usuário veio da sessão excluída, o retrato é removido.
• Um template biométrico retido (somente quando você optou por isso) permanece até expirar ou até você eliminá-lo. Elimine-o com a API de templates biométricos, excluindo o Usuário ou repetindo a exclusão de outra sessão do mesmo Usuário com deletion_instruction: "privacy_erasure".

​

Exemplos

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
}

​

Erros

​

Permissão

​

Exclusão em lote

​

Migração das respostas 204

​

Relacionados

• Templates biométricos
• Retenção de dados
• Visão geral de sessões