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

# Utilizadores vendor: registo KYC persistente

> Vendor Users são o registo de identidade persistente da Didit: histórico KYC, biometria, documentos e listas de bloqueio, num só perfil.

Uma **entidade de utilizador** representa um único indivíduo (o seu cliente, utilizador final ou candidato) em todas as interações de verificação, transação e conformidade que tem com a sua plataforma na Didit.

Assim que um utilizador existe, toda a atividade associada ao mesmo `vendor_data` passa a ser agregada no mesmo perfil. Obtém um painel único de identidade, risco e conformidade para cada pessoa.

## O que existe num utilizador

| Categoria | Campos / objetos |
| - | - |
| **Identidade** | `vendor_data`, `uuid`, `display_name`, `full_name`, `date_of_birth`, `portrait_image` |
| **Estado** | `ACTIVE`, `FLAGGED`, `BLOCKED` |
| **Agregados de sessões** | `session_count`, `approved_count`, `declined_count`, `in_review_count`, mapa `features` |
| **Contacto verificado** | `approved_emails[]`, `approved_phones[]` |
| **Geografia** | `issuing_states[]` (a partir de documentos de identidade verificados) |
| **Atividade** | `first_session_at`, `last_session_at`, `last_activity_at` |
| **Biometria** | Registos faciais associados (para pesquisa / deteção de duplicados / lista de bloqueio) |
| **Documentos** | Documentos de identidade, comprovativos de morada e selfies das sessões |
| **Relações** | Entidades empresariais associadas (se o utilizador for administrador / beneficiário efetivo de empresas verificadas na sua aplicação) |
| **Metadados** | JSON arbitrário para os seus próprios dados |

Consulte o [modelo de dados do utilizador](https://docs.didit.me/pt/entities/users/data-model.md) para tipos, índices e casos limite.

## Quando é criado um utilizador

**1. Automaticamente — na primeira sessão com um novo vendor\_data**

O caso mais comum. Chama `POST /v3/session/` com um valor de `vendor_data` que a Didit nunca viu. É criada uma entidade de utilizador com estado `ACTIVE` e associada a essa sessão.

**2. Explicitamente — através de POST /v3/users/create/**

Cria o utilizador previamente, antes de qualquer sessão ser iniciada. Útil para preencher metadados, definir o estado inicial ou fazer onboarding em massa de clientes a partir de uma base de dados existente.

**3. A partir da Consola**

Um operador de conformidade cria o utilizador na página Utilizadores, por exemplo ao fazer o onboarding de um cliente verificado manualmente.

## O que pode fazer

| Operação | Como |
| - | - |
| [Listar utilizadores](https://docs.didit.me/pt/entities/users/operations.md#listar-utilizadores) | `GET /v3/users/` com filtros (estado, data, país) |
| [Obter utilizador](https://docs.didit.me/pt/entities/users/operations.md#obter-um-utilizador) | `GET /v3/users/{vendor_data}/` |
| [Criar utilizador](https://docs.didit.me/pt/entities/users/operations.md#criar-um-utilizador) | `POST /v3/users/create/` |
| [Atualizar perfil](https://docs.didit.me/pt/entities/users/operations.md#atualizar-um-utilizador) | `PATCH /v3/users/{vendor_data}/` |
| [Alterar estado](https://docs.didit.me/pt/entities/users/operations.md#alterar-o-estado) | `PATCH /v3/users/{vendor_data}/update-status/` |
| [Eliminar utilizadores](https://docs.didit.me/pt/entities/users/operations.md#eliminar-utilizadores-em-lote) | `POST /v3/users/delete/` (em lote) |
| [Associar / pesquisar rostos](https://docs.didit.me/pt/entities/users/faces-and-biometrics.md) | Consola + API de Listas para listas de bloqueio |
| [Ver documentos](https://docs.didit.me/pt/entities/users/documents.md) | Através das decisões das sessões |
| [Adicionar à lista de bloqueio](https://docs.didit.me/pt/entities/users/blocklist.md) | Consola + API de Listas |
| [Rever histórico KYC](https://docs.didit.me/pt/entities/users/kyc-history.md) | `GET /v3/sessions?vendor_data=...` |
| [Rever transações](https://docs.didit.me/pt/entities/users/transactions.md) | `GET /v3/transactions/?vendor_data=...` |
| [Importar / exportar](https://docs.didit.me/pt/entities/users/import-export.md) | Apenas na consola (CSV) |
| [Gerir na consola](https://docs.didit.me/pt/entities/users/console.md) | Passo a passo completo da interface |

## Utilizadores e empresas

Um único utilizador pode estar ligado a uma ou mais empresas, por exemplo quando a mesma pessoa é administradora de uma empresa e beneficiária efetiva de outra. A Didit preserva estas ligações automaticamente quando a [KYB](https://docs.didit.me/pt/business-verification/overview.md) identifica pessoas a partir de registos de empresas.

## Relação utilizador ↔ sessão

```mermaid theme={null}
flowchart LR
    U[User entity<br/>vendor_data = user-42]
    S1["User Verification (KYC) session #1<br/>(approved 2025-01)"]
    S2["User Verification (KYC) session #2<br/>(resubmit, in review)"]
    S3["User Verification (KYC) session #3<br/>(re-verification 2026-01)"]
    S1 --> U
    S2 --> U
    S3 --> U
```

O utilizador agrega o estado **mais recente** de cada funcionalidade em todas as sessões. Uma verificação `aml` falhada na sessão mais recente aparecerá no campo `features.aml` do utilizador, mesmo que sessões anteriores tenham sido aprovadas.

## Próximos passos

> [card] [Modelo de dados](https://docs.didit.me/pt/entities/users/data-model.md)
>
> Cada campo, tipo e índice.

> [card] [Operações](https://docs.didit.me/pt/entities/users/operations.md)
>
> Criar, atualizar, alterar estado, eliminar.

> [card] [Rostos e biometria](https://docs.didit.me/pt/entities/users/faces-and-biometrics.md)
>
> Associe um rosto para pesquisa e inclusão numa lista de bloqueio.

> [card] [Lista de bloqueio](https://docs.didit.me/pt/entities/users/blocklist.md)
>
> Como funciona a inclusão de utilizadores em listas de bloqueio.

> [card] [Histórico KYC](https://docs.didit.me/pt/entities/users/kyc-history.md)
>
> Cada sessão associada ao utilizador.

> [card] [Consola](https://docs.didit.me/pt/entities/users/console.md)
>
> Passo a passo completo da interface de utilizadores.


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