> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # Retenção e exclusão de dados: LGPD e GDPR > Configure por quanto tempo a Didit guarda dados de verificação, exclua sessões sob demanda e adote KYC com privacidade, residência na UE, GDPR e DPA. ## Papel e local de processamento | Aspecto | Detalhe | | - | - | | **Papel de operador** | A Didit atua como **operadora de dados**; você continua sendo o controlador dos dados. | | **Região de processamento** | UE por padrão. Contas Enterprise podem habilitar o **processamento no país** (residência local de dados), sujeito a disponibilidade e contrato. | | **Posicionamento regulatório** | Projetada para apoiar o **GDPR** e os regimes locais de proteção de dados. Configure a retenção abaixo para cumprir suas obrigações. | > [!NOTE] > > Precisa de um DPA, de TOMs ou de outras atestações de conformidade? Fale com o seu representante da Didit. *** ## Controles de retenção Configure a retenção em **Business Console → Configurações do aplicativo → Retenção de dados**. **1. Abra as configurações de retenção** Vá até **Business Console → Configurações do aplicativo → Retenção de dados**. **2. Escolha uma política de retenção** Selecione um período de **1 mês** a **10 anos**. **Ilimitado** e períodos personalizados estão disponíveis no Enterprise. Uma nova aplicação começa com o maior período que o seu plano inclui: **1 ano** no Free, **5 anos** no Growth, **10 anos** no Scale e **ilimitado** no Enterprise. **3. Salve** Clique em **Salvar** para aplicar a política a todas as sessões futuras e existentes. A política se aplica às entradas e saídas da verificação, aos resultados derivados e aos metadados operacionais armazenados pela Didit. Quando uma sessão chega ao fim do período, ela é excluída exatamente como por [Delete Session](https://docs.didit.me/sessions-api/delete-session.md), incluindo o embedding facial, a menos que você tenha habilitado a [retenção de template biométrico](#retenção-de-template-biométrico). ![Configurações de retenção de dados no Business Console](https://mintcdn.com/didit-0f962782/z6T2GHM4Zh-iSj-K/images/data-retention-settings.png?fit=max\&auto=format\&n=z6T2GHM4Zh-iSj-K\&q=85\&s=e2ca6a8e32ed8ec5a2cd910d3cdbaefc) *** ## Exclusão manual Exclua sessões individuais pelo console quando precisar de remoções pontuais. 1. Acesse **Painel → Verificações**. 2. Pesquise ou filtre a sessão desejada. 3. Clique no botão **Excluir** (canto superior direito) e confirme. ![Excluir uma sessão de verificação pelo console](https://mintcdn.com/didit-0f962782/z6T2GHM4Zh-iSj-K/images/data-retention-delete-session.png?fit=max\&auto=format\&n=z6T2GHM4Zh-iSj-K\&q=85\&s=ff1947059d7d9d60643b7568e189e3a6) *** ## Exclusão programática Exclua uma sessão pela API a qualquer momento chamando o endpoint [Delete Session](https://docs.didit.me/sessions-api/delete-session.md). ```bash theme={null} curl --request DELETE \ --url https://verification.didit.me/v3/session/{session_id}/delete/ \ --header 'x-api-key: YOUR_API_KEY' ``` | Resposta | Significado | | - | - | | `200 OK` | Sessão excluída. O corpo informa o que aconteceu com os dados biométricos faciais (`face_retention_outcome`). | | `404 Not Found` | A sessão já foi excluída ou o `session_id` é desconhecido. | Para uma solicitação de eliminação feita pelo titular dos dados, envie `{"deletion_instruction": "privacy_erasure"}` no corpo, para que qualquer template biométrico mantido dessa pessoa também seja eliminado. *** ## Retenção de template biométrico Toda sessão de KYC com uma selfie de prova de vida carrega um embedding facial que alimenta a detecção de duplicidade e a [busca facial 1:N](https://docs.didit.me/pt-br/core-technology/face-search/overview.md). Por padrão, esse embedding é excluído junto com a sessão, de modo que uma pessoa cuja sessão você excluiu pode verificar-se de novo sem ser sinalizada como duplicada. Fluxos cuja etapa de prova de vida tem a [busca facial automática desativada](https://docs.didit.me/pt-br/core-technology/face-search/overview.md#desativando-a-busca-facial-automática) nunca armazenam esse embedding, então não há nada para a retenção manter nas sessões deles. Se você exclui sessões logo após a aprovação, mas ainda precisa detectar cadastros repetidos, habilite a **retenção de template biométrico**. A Didit então exclui a sessão e todos os seus dados normalmente e mantém um único template biométrico facial, sem imagem e gerenciado separadamente, vinculado ao Usuário. > [!WARNING] > > Um template biométrico mantido é um dado biométrico. Ele não é anônimo, não é transitório e não é excluído com a sessão. Permanece até o vencimento programado, um prazo anterior previsto em lei aplicável, a exclusão do Usuário, uma solicitação de eliminação por privacidade ou uma purga explícita. Habilite a retenção somente quando a sua instrução como controlador e o seu aviso de privacidade a cobrirem, e escolha um período de retenção que atenda às leis aplicáveis aos seus usuários. ### Como habilitar **1. Abra as configurações de retenção** Vá até **Business Console → Configurações do aplicativo → Retenção de dados**. **2. Ative Manter template biométrico** Selecione **Manter até o vencimento programado ou uma exclusão anterior**. A configuração diz: *Mantém um template biométrico facial sem imagem para detecção de duplicatas no escopo da organização após a exclusão operacional da sessão. Ele continua sendo um dado biométrico e é excluído conforme seu cronograma configurado, um prazo legal aplicável, a exclusão do Usuário, uma solicitação de eliminação por privacidade ou uma purga explícita.* **3. Defina um período de retenção finito** Informe o número de dias (de 1 a 3650) pelos quais um template pode ser mantido. A configuração não pode ser salva sem isso. A Didit aplica o menor entre este período, a sua janela de retenção geral e qualquer prazo que você envie em uma chamada de exclusão. **4. Salve** A política se aplica às exclusões a partir de agora. Nenhum template existente é criado nem purgado ao alterar a configuração. Por programação, defina a mesma política com `PATCH /v3/webhook/`: ```bash theme={null} curl -X PATCH https://verification.didit.me/v3/webhook/ \ -H "x-api-key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"face_retention_policy": "retain_until_user_deleted", "face_retention_days": 365}' ``` | Campo | Valores | Descrição | | - | - | - | | `face_retention_policy` | `delete_with_session` (padrão), `retain_until_user_deleted` | O que acontece com o embedding facial quando uma sessão é excluída. | | `face_retention_days` | inteiro de 1 a 3650 | Período de retenção finito dos templates mantidos. Obrigatório quando a política é `retain_until_user_deleted`; sem ele, a requisição é rejeitada com `400`. | As aplicações existentes permanecem em `delete_with_session` até que você altere a política. Nada habilita a retenção em seu nome. ### O que é mantido e o que é eliminado | Excluído com a sessão | Mantido (somente por opção) | | - | - | | A decisão, os dados extraídos e cada registro de recurso | O template facial numérico usado para correspondência | | Imagens de documentos, retratos, selfies, vídeo de prova de vida, documentos de comprovante de endereço, envios extras | Um novo ID de template aleatório e uma referência de procedência opaca | | O ID da sessão, o número e seu vínculo com qualquer mídia | O Usuário titular, as datas de retenção, a classe e o ID da instrução e o ID do principal que agiu | O template mantido é restrito à organização e usado somente por instrução sua, para detecção de rostos duplicados e de várias contas, autenticação biométrica e suas próprias listas de rostos. Nunca é usado para treinamento de modelos, análises, correspondência entre organizações nem para o processamento antifraude da própria Didit. ### Controle por exclusão Toda exclusão informa seu resultado, e toda chamada de exclusão pode substituir a política: * **Console**: a confirmação de exclusão mostra se o template de cada sessão será mantido ou excluído. A confirmação diz: *Isso exclui a sessão e inicia a exclusão dos dados da sessão. Se a retenção de template biométrico estiver habilitada para essa exclusão operacional, um template biométrico sem imagem permanece separadamente até seu vencimento programado ou uma purga anterior. Solicitações de eliminação por privacidade também purgam o template.* Sessões sem Usuário não podem manter um template e são marcadas como tal. * **API**: envie `retain_face_embeddings`, `face_retention_days`, `face_retention_deadline`, `deletion_instruction` e `instruction_id` em [Delete Session](https://docs.didit.me/sessions-api/delete-session.md) ou [Batch Delete Sessions](https://docs.didit.me/management-api/sessions/batch-delete.md). ### Dois tipos de instrução de exclusão | Instrução | O que faz | | - | - | | Exclusão operacional de sessão (`operational_session_delete`, padrão) | Exclui a sessão e seus dados. Um template só é mantido quando a política ou a requisição determina, e a resposta informa o resultado. | | Eliminação por privacidade (`privacy_erasure`) | Exclui a sessão e purga todos os templates mantidos dessa pessoa. A política da aplicação não pode substituí-la. Use-a em solicitações de titulares de dados. | ### Quando um template é purgado * Você o purga em **Listas → Templates biométricos** ou pela [API de Biometric Templates](https://docs.didit.me/management-api/biometric-templates/overview.md). * Você exclui o Usuário com [Batch Delete Users](https://docs.didit.me/management-api/users/delete.md). * Você exclui qualquer sessão desse Usuário com `deletion_instruction: "privacy_erasure"`. * O período de retenção termina. A Didit o purga automaticamente. Voltar a política para **Excluir com a sessão** impede a criação de novos templates, mas não purga os existentes; purgue-os explicitamente. ### Onde vê-los * **Listas → Templates biométricos** mostra cada template com seu Usuário, origem, datas de retenção e de vencimento e status, com purga individual e em lote. * **Usuários → \[usuário] → Templates biométricos** mostra os templates vinculados a um único Usuário. * A [API de Biometric Templates](https://docs.didit.me/management-api/biometric-templates/overview.md) expõe os mesmos dados e ações, e cada retenção e purga é registrada na trilha de auditoria. > [!NOTE] > > Os templates mantidos são cobertos pelos termos de dados biométricos do seu DPA. Nada nesta página é aconselhamento jurídico: você continua responsável pela base legal, pelos avisos, pelo consentimento e pelo período de retenção aplicável aos seus usuários. *** ## Padrão de processar e purgar Para a máxima minimização de dados, processe os dados de verificação pela Didit e purgue-os imediatamente após receber os resultados por webhooks. **1. Crie uma sessão** Seu backend chama a API [Create Session](https://docs.didit.me/sessions-api/create-session.md). **2. A Didit executa as verificações** Identidade, prova de vida, AML e quaisquer outras verificações configuradas são executadas automaticamente. **3. Receba o webhook** A Didit envia um [webhook](https://docs.didit.me/integration/webhooks.md) com `status`, `session_id`, `vendor_data` e os dados completos da verificação. **4. Guarde apenas o que precisa** Armazene o mínimo de campos necessário para os seus registros (por exemplo, `status`, `vendor_data`). **5. Exclua da Didit** Chame a API [Delete Session](https://docs.didit.me/sessions-api/delete-session.md) para esse `session_id` para excluir a sessão e seus dados da Didit. Se você depende da detecção de duplicidade em cadastros futuros, habilite antes a [retenção de template biométrico](#retenção-de-template-biométrico); caso contrário, o embedding facial também é excluído. *** ## Segurança e garantias > **ISO/IEC 27001** > > ISMS implementado. Certificado e trechos disponíveis sob solicitação. > **Testes de intrusão** > > Testes de intrusão periódicos por terceiros, com remediação acompanhada. > **Nenhuma violação conhecida** > > Nenhuma violação de segurança registrada até hoje. > **Equipe interna de segurança** > > Equipe dedicada de cibersegurança, com acesso de privilégio mínimo e separação rigorosa de ambientes. > [!NOTE] > > Toda a atividade da API é registrada em **Registros de auditoria** para segurança, conformidade e solução de problemas. Os registros são mantidos por **365 dias** e depois excluídos automaticamente. *** ## Armazenamento com privacidade minimizada Estamos adicionando recursos que permitem **manter apenas campos de dados selecionados** - por exemplo, manter `status` e `vendor_data` enquanto artefatos mais pesados, como imagens e documentos, são purgados automaticamente. Isso dá um controle mais rigoroso às equipes que operam sob princípios de minimização de dados. > [!TIP] > > Quer acesso antecipado às regras de retenção por artefato? Fale com o seu representante da Didit. *** ## Perguntas frequentes > **Posso definir uma retenção diferente por ambiente?** > > Sim. Você pode configurar políticas de retenção diferentes para cada aplicação que tem na Didit. > **Posso exportar os dados antes de excluir?** > > Sim. Exporte os dados da sessão pelo console ou pela API e depois chame o endpoint Delete Session. > **Um usuário excluído ainda será detectado como duplicado?** > > Somente se você tiver habilitado a retenção de template biométrico antes de excluir a sessão dele. Por padrão, o embedding facial é excluído com a sessão e a pessoa pode verificar-se de novo sem sinalização de duplicidade. Veja [Retenção de template biométrico](#retenção-de-template-biométrico). > **Onde posso ver quem acessou o quê?** > > Use os **Registros de auditoria** no console. Filtre por usuário, endpoint ou intervalo de datas. Os registros são mantidos por **365 dias**. *** ## Checklist de implementação **1. Configure a retenção** Defina sua política de retenção em **Console → Configurações do aplicativo → Retenção de dados**. **2. Assine os webhooks** Configure os [webhooks](https://docs.didit.me/integration/webhooks.md) e verifique as assinaturas. **3. Guarde o mínimo de campos** Armazene apenas os campos de que o seu negócio precisa. **4. Implemente a exclusão programática** Chame a API [Delete Session](https://docs.didit.me/sessions-api/delete-session.md) se você usar o padrão de processar e purgar. **5. Confirme a região de processamento** Verifique sua região de processamento (UE por padrão, ou no país para Enterprise). **6. Separe os ambientes** Use chaves de API separadas para Sandbox e Live, com políticas de retenção independentes. Rotacione as chaves regularmente. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.