> ## 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.

# Conservação e eliminação de dados: controlos RGPD

> Configure a conservação de dados na Didit, elimine sessões a pedido e use KYC com privacidade em primeiro lugar, com residência na UE, RGPD e suporte a DPA.

## Função e local de tratamento

| Aspeto | Detalhe |
| - | - |
| **Função de subcontratante** | A Didit atua como **subcontratante**; você mantém-se como responsável pelo tratamento. |
| **Região de tratamento** | A [localização dos dados](https://docs.didit.me/pt/console/applications.md#localização-dos-dados) de cada aplicação, escolhida na criação da aplicação: União Europeia (Irlanda) por predefinição, com Austrália (Sydney) e México em breve. As contas Enterprise podem ativar o **tratamento no país** (residência local dos dados), sujeito à disponibilidade e ao contrato. |
| **Enquadramento regulatório** | Concebido para apoiar o **RGPD** e os regimes locais de proteção de dados. Configure a conservação abaixo para cumprir as suas obrigações. |

> [!NOTE]
>
> Precisa de um DPA, de TOMs ou de outras atestações de conformidade? Contacte o seu representante da Didit.

***

## Controlos de conservação

Configure a conservação em **Business Console → App Settings → Data retention**.

**1. Abrir definições de conservação**

Aceda a **Business Console → App Settings → Data retention**.

**2. Escolha uma política de conservação**

Selecione um período entre **1 mês** e **10 anos**. **Ilimitado** e períodos personalizados estão disponíveis no Enterprise.
Uma nova aplicação começa com o período mais longo incluído no seu plano: **1 ano** no Free, **5 anos** no Growth, **10 anos** no Scale e **Ilimitado** no Enterprise.

**3. Guardar**

Clique em **Guardar** para aplicar a política a todas as sessões futuras e existentes.

A política aplica-se aos dados de entrada e saída das verificações, aos resultados derivados e aos metadados operacionais armazenados pela Didit. Quando uma sessão atinge o fim do período, é eliminada exatamente como em [Eliminar sessão](https://docs.didit.me/pt/sessions-api/delete-session.md), incluindo o seu embedding facial, a menos que tenha ativado a [conservação de templates biométricos](#retenção-de-modelo-biométrico).

![Definições de conservação de dados na 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)

***

## Eliminação manual

Elimine sessões individuais a partir da Console quando precisar de remoções pontuais.

1. Abra **Verificações de utilizadores** (ou **Verificações de empresas**) na barra lateral.
2. Pesquise ou filtre a sessão pretendida.
3. Clique no botão **Eliminar** (canto superior direito) e confirme.

![Eliminar uma sessão de verificação a partir da 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)

***

## Eliminação programática

Elimine uma sessão através da API a qualquer momento, ao chamar o endpoint [Eliminar sessão](https://docs.didit.me/pt/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 eliminada. O corpo indica o que aconteceu aos dados biométricos faciais (`face_retention_outcome`). |
| `404 Not Found` | Sessão já eliminada ou `session_id` desconhecido. |

Para um pedido de apagamento por parte de um titular dos dados, envie `{"deletion_instruction": "privacy_erasure"}` no corpo do pedido, para que qualquer template biométrico conservado dessa pessoa seja também eliminado.

***

## Retenção de modelo biométrico

Toda a sessão KYC com selfie de prova de vida tem um embedding facial que alimenta a deteção de duplicados e a [Pesquisa facial 1:N](https://docs.didit.me/pt/core-technology/face-search/overview.md). Por predefinição, esse embedding é eliminado com a sessão, para que uma pessoa cuja sessão tenha sido eliminada possa voltar a verificar-se sem ser sinalizada como duplicado.

Os fluxos de trabalho cujo passo de prova de vida tem a [pesquisa facial automática desativada](https://docs.didit.me/pt/core-technology/face-search/overview.md#desativar-a-pesquisa-facial-automática) nunca guardam esse embedding, pelo que a retenção não tem nada a manter para as respetivas sessões.

Se eliminar as sessões logo após a aprovação, mas ainda precisar de detetar novos registos duplicados, ative a **retenção de modelo biométrico**. A Didit elimina então a sessão e todos os seus dados, como habitualmente, e mantém um modelo biométrico facial, gerido separadamente e sem imagens, associado ao utilizador.

> [!WARNING]
>
> Um modelo biométrico retido é dado biométrico. Não é anónimo, não é transitório e não é eliminado com a sessão. Mantém-se até à expiração programada, até ao prazo anterior imposto pela legislação aplicável, à eliminação do utilizador, a um pedido de apagamento por privacidade ou a uma purga explícita. Ative a retenção apenas quando a instrução do responsável pelo tratamento e o aviso de privacidade a cobrirem, e escolha um período de retenção que cumpra a legislação aplicável aos seus utilizadores.

### Ativar

**1. Abrir as definições de retenção**

Aceda a **Business Console → App Settings → Data retention**.

**2. Ativar Retain biometric template**

Selecione **Retain until scheduled expiry or earlier deletion**. A definição diz: *Mantém um modelo biométrico facial sem imagens para deteção de duplicados limitada à organização, após uma eliminação operacional de sessão. Continua a ser dado biométrico e é eliminado conforme o respetivo calendário, o prazo da legislação aplicável, a eliminação do utilizador, um pedido de apagamento por privacidade ou uma purga explícita.*

**3. Definir um período de retenção finito**

Introduza o número de dias (de 1 a 3650) durante os quais um modelo pode ser mantido. A definição não pode ser guardada sem este valor. A Didit aplica o mais curto de entre este período, a sua janela de retenção geral e qualquer prazo que envie num pedido de eliminação.

**4. Guardar**

A política aplica-se às eliminações a partir deste momento. Alterar a definição não cria nem purga nenhum modelo existente.

Por via programática, 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` (predefinido), `retain_until_user_deleted` | O que acontece ao embedding facial quando uma sessão é eliminada. |
| `face_retention_days` | inteiro de 1 a 3650 | Período de retenção finito para os modelos retidos. Obrigatório quando a política é `retain_until_user_deleted`; sem ele, o pedido é rejeitado com `400`. |

As aplicações existentes mantêm `delete_with_session` até alterar a política. Nada ativa a retenção em seu nome.

### O que é retido e o que é eliminado

| Eliminado com a sessão | Retido (apenas mediante ativação) |
| - | - |
| Decisão, dados extraídos e todos os registos de funcionalidades | O modelo facial numérico usado para correspondência |
| Imagens do documento, retratos, selfies, vídeo de prova de vida, documentos de comprovativo de morada e carregamentos adicionais | Um novo id aleatório de modelo e uma referência de proveniência opaca |
| O id da sessão, o número e a respetiva ligação a qualquer conteúdo multimédia | O utilizador associado, as datas de retenção, a classe e o id da instrução e o id do principal que atuou |

O modelo retido é limitado à organização e é usado apenas por instrução sua, para deteção de faces duplicadas e de contas múltiplas, autenticação biométrica e as suas próprias listas faciais. Nunca é usado para treino de modelos, análises, correspondência entre organizações ou o processamento de fraude próprio da Didit.

### Controlo por eliminação

Cada eliminação indica o respetivo resultado, e cada chamada de eliminação pode substituir a política:

* **Consola**: a confirmação de eliminação mostra se o modelo de cada sessão será retido ou eliminado. A confirmação diz: *Isto elimina a sessão e inicia a eliminação dos respetivos dados de sessão. Se a retenção de modelo biométrico estiver ativa para esta eliminação operacional, um modelo biométrico sem imagens permanece à parte até à expiração programada ou a uma purga antecipada. Os pedidos de apagamento por privacidade também purgam o modelo.* As sessões sem utilizador não podem reter um modelo e são assinaladas como tal.
* **API**: envie `retain_face_embeddings`, `face_retention_days`, `face_retention_deadline`, `deletion_instruction` e `instruction_id` em [Eliminar sessão](https://docs.didit.me/pt/sessions-api/delete-session.md) ou em [Eliminar sessões em lote](https://docs.didit.me/pt/management-api/sessions/batch-delete.md).

### Dois tipos de instrução de eliminação

| Instrução | O que faz |
| - | - |
| Eliminação operacional de sessão (`operational_session_delete`, predefinido) | Elimina a sessão e os respetivos dados. Um modelo só é retido quando a política ou o pedido o indicam, e a resposta indica o resultado. |
| Apagamento por privacidade (`privacy_erasure`) | Elimina a sessão e purga todos os modelos retidos dessa pessoa. A política da aplicação não o pode substituir. Use-o para pedidos de titulares dos dados. |

### Quando um modelo é purgado

* Purga-o em **Lists → Biometric templates** ou através da [API de modelos biométricos](https://docs.didit.me/pt/management-api/biometric-templates/overview.md).
* Elimina o utilizador com [Eliminar utilizadores em lote](https://docs.didit.me/pt/management-api/users/delete.md).
* Elimina qualquer sessão desse utilizador com `deletion_instruction: "privacy_erasure"`.
* O seu período de retenção termina. A Didit purga-o automaticamente.

Voltar a definir a política como **Eliminar com a sessão** impede a criação de novos modelos, mas não purga os existentes; purgue-os explicitamente.

### Onde os ver

* **Lists → Biometric templates** lista todos os modelos com o respetivo utilizador, origem, datas de retenção e de expiração e estado, com purga individual e em massa.
* **Users → \[user] → Biometric templates** mostra os modelos associados a um utilizador.
* A [API de modelos biométricos](https://docs.didit.me/pt/management-api/biometric-templates/overview.md) disponibiliza os mesmos dados e ações, e cada retenção e cada purga ficam registadas no registo de auditoria.

> [!NOTE]
>
> Os modelos retidos estão abrangidos pelos termos de dados biométricos do seu DPA. Nada nesta página constitui aconselhamento jurídico: é você quem responde pela base jurídica, pelos avisos, pelo consentimento e pelo período de retenção aplicáveis aos seus utilizadores.

***

## Padrão de processar e eliminar

Para minimizar os dados tanto quanto possível, processe os dados de verificação através da Didit e elimine-os imediatamente após receber os resultados através de webhooks.

**1. Criar uma sessão**

O seu backend chama a API [Criar sessão](https://docs.didit.me/pt/sessions-api/create-session.md).

**2. A Didit executa as verificações**

Verificações de identidade, prova de vida, AML e quaisquer outras configuradas são executadas automaticamente.

**3. Receber o webhook**

A Didit envia um [webhook](https://docs.didit.me/pt/integration/webhooks.md) com `status`, `session_id`, `vendor_data` e os dados completos da verificação.

**4. Guardar apenas o necessário**

Guarde os campos mínimos necessários para os seus registos (por exemplo, `status`, `vendor_data`).

**5. Eliminar na Didit**

Chame a API [Eliminar sessão](https://docs.didit.me/pt/sessions-api/delete-session.md) para esse `session_id` para eliminar a sessão e os respetivos dados da Didit. Se depender da deteção de duplicados em futuros registos, ative primeiro a [conservação do template biométrico](#retenção-de-modelo-biométrico); caso contrário, o embedding facial também é eliminado.

***

## Segurança e garantias

> [card] ISO/IEC 27001
>
> Sistema de gestão de segurança da informação (SGSI) implementado. Certificado e excertos disponíveis mediante pedido.

> [card] Testes de penetração
>
> Testes de penetração periódicos por terceiros, com acompanhamento das correções.

> [card] Sem violações conhecidas
>
> Não foram reportadas violações de segurança até à data.

> [card] Equipa interna de segurança
>
> Equipa de cibersegurança dedicada, com acesso baseado no princípio do menor privilégio e separação rigorosa entre ambientes.

> [!NOTE]
>
> Toda a atividade da API é registada em **Registos de Auditoria** para segurança, conformidade e resolução de problemas. O período a que pode recuar depende do seu plano: veja [Registos de auditoria](https://docs.didit.me/pt/console/audit-logs.md#conservação-de-dados).

***

## Armazenamento com minimização de dados

Estamos a adicionar funcionalidades que lhe permitem **conservar apenas os campos de dados selecionados**. Por exemplo, manter `status` e `vendor_data` enquanto elimina automaticamente artefactos mais pesados, como imagens e documentos. Isto oferece um controlo mais rigoroso para equipas que operam segundo princípios de minimização de dados.

> [!TIP]
>
> Pretende acesso antecipado às regras de conservação ao nível do artefacto? Contacte o seu representante da Didit.

***

## FAQ

> [accordion] Posso definir uma conservação diferente por ambiente?
>
> Sim. Pode configurar políticas de conservação diferentes para cada aplicação que tenha na Didit.

> [accordion] Posso exportar dados antes da eliminação?
>
> Sim. Exporte os dados da sessão através da Consola ou da API e, em seguida, chame o endpoint Eliminar sessão.

> [accordion] Um utilizador eliminado ainda será detetado como duplicado?
>
> Só se tiver ativado a conservação do template biométrico antes de eliminar a sessão dele. Por defeito, o embedding facial é eliminado com a sessão e a pessoa pode voltar a verificar-se sem sinalização de duplicado. Veja [Conservação do template biométrico](#retenção-de-modelo-biométrico).

> [accordion] Onde posso ver quem acedeu a quê?
>
> Utilize o **Registo de auditoria** na Consola (**Definições > Organização > Registo de auditoria**). Filtre por utilizador, endpoint ou intervalo de datas. O período a que pode recuar depende do seu plano: veja [Registos de auditoria](https://docs.didit.me/pt/console/audit-logs.md#conservação-de-dados).

***

## Lista de verificação de implementação

**1. Configurar a conservação**

Defina a sua política de conservação em **Console → App Settings → Data retention**.

**2. Subscrever webhooks**

Configure os [webhooks](https://docs.didit.me/pt/integration/webhooks.md) e verifique as assinaturas.

**3. Guardar apenas os campos mínimos**

Guarde apenas os campos de que a sua empresa necessita.

**4. Implementar a eliminação programática**

Chame a API [Eliminar sessão](https://docs.didit.me/pt/sessions-api/delete-session.md) se utilizar o padrão processar e eliminar.

**5. Confirmar a região de processamento**

Verifique a localização dos dados da sua aplicação em **Application settings > Data and privacy** (União Europeia por defeito, ou no seu país para planos empresariais).

**6. Separar ambientes**

Utilize chaves de API separadas para Sandbox e produção, com políticas de conservação independentes. Renove as chaves regularmente.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.