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

# Usuários com KYC persistente: Vendor Users

> Vendor Users são o registro de identidade persistente da Didit: histórico de KYC, biometria, documentos, transações e lista de bloqueio em um perfil.

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

Quando um usuário é criado, toda a atividade vinculada ao mesmo `vendor_data` é reunida no mesmo perfil: você tem uma visão unificada de identidade, risco e conformidade para cada pessoa.

## O que um usuário contém

| Categoria | Campos / objetos |
| - | - |
| **Identidade** | `vendor_data`, `uuid`, `display_name`, `full_name`, `date_of_birth`, `portrait_image` |
| **Status** | `ACTIVE`, `FLAGGED`, `BLOCKED` |
| **Agregados de sessões** | `session_count`, `approved_count`, `declined_count`, `in_review_count`, mapa `features` |
| **Contato 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** | Registros faciais anexados (para busca, detecção de duplicados e lista de bloqueio) |
| **Documentos** | Documentos de identidade, comprovantes de endereço e selfies das sessões |
| **Relações** | Entidades empresariais vinculadas (se o usuário for diretor ou UBO de empresas verificadas na sua aplicação) |
| **Metadados** | JSON arbitrário para os seus próprios dados |

Consulte o [modelo de dados do usuário](https://docs.didit.me/pt-br/entities/users/data-model.md) completo para ver tipos, índices e casos de borda.

## Quando um usuário é criado

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

É o caso mais comum. Você chama `POST /v3/session/` com um valor de `vendor_data` que a Didit nunca viu. Uma entidade de usuário é criada com status `ACTIVE` e vinculada a essa sessão.

**2. Explicitamente — via POST /v3/users/create/**

Você cria o usuário antecipadamente, antes de qualquer sessão. É útil para preencher metadados, definir o status inicial ou fazer o onboarding em massa de clientes a partir de um banco de dados existente.

**3. Pelo console**

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

## O que você pode fazer

| Operação | Como |
| - | - |
| [Listar usuários](https://docs.didit.me/pt-br/entities/users/operations.md#listar-usuários) | `GET /v3/users/` com filtros (status, data, país) |
| [Obter usuário](https://docs.didit.me/pt-br/entities/users/operations.md#obter-um-usuário) | `GET /v3/users/{vendor_data}/` |
| [Criar usuário](https://docs.didit.me/pt-br/entities/users/operations.md#criar-um-usuário) | `POST /v3/users/create/` |
| [Atualizar perfil](https://docs.didit.me/pt-br/entities/users/operations.md#atualizar-um-usuário) | `PATCH /v3/users/{vendor_data}/` |
| [Alterar status](https://docs.didit.me/pt-br/entities/users/operations.md#alterar-o-status) | `PATCH /v3/users/{vendor_data}/update-status/` |
| [Excluir usuários](https://docs.didit.me/pt-br/entities/users/operations.md#excluir-usuários-em-lote) | `POST /v3/users/delete/` (em lote) |
| [Anexar / buscar rostos](https://docs.didit.me/pt-br/entities/users/faces-and-biometrics.md) | Console + Lists API para listas de bloqueio |
| [Ver documentos](https://docs.didit.me/pt-br/entities/users/documents.md) | Por meio das decisões de sessão |
| [Adicionar à lista de bloqueio](https://docs.didit.me/pt-br/entities/users/blocklist.md) | Console + Lists API |
| [Revisar o histórico de KYC](https://docs.didit.me/pt-br/entities/users/kyc-history.md) | `GET /v3/sessions?vendor_data=...` |
| [Revisar transações](https://docs.didit.me/pt-br/entities/users/transactions.md) | `GET /v3/transactions/?vendor_data=...` |
| [Importar / exportar](https://docs.didit.me/pt-br/entities/users/import-export.md) | Somente pelo console (CSV) |
| [Gerenciar no console](https://docs.didit.me/pt-br/entities/users/console.md) | Guia completo da interface |

## Usuários e empresas

Um único usuário pode estar vinculado a uma ou mais empresas, por exemplo, quando a mesma pessoa é diretora de uma empresa e beneficiária final de outra. A Didit preserva esses vínculos automaticamente quando o [KYB](https://docs.didit.me/pt-br/business-verification/overview.md) identifica pessoas a partir de registros de empresas.

## Relação usuário ↔ 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 usuário agrega o estado **mais recente** de cada recurso em todas as sessões. Uma verificação `aml` reprovada na sessão mais recente aparecerá no campo `features.aml` do usuário, mesmo que sessões anteriores tenham sido aprovadas.

## Próximos passos

> [card] [Modelo de dados](https://docs.didit.me/pt-br/entities/users/data-model.md)
>
> Todos os campos, tipos e índices.

> [card] [Operações](https://docs.didit.me/pt-br/entities/users/operations.md)
>
> Criar, atualizar, alterar status e excluir.

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

> [card] [Lista de bloqueio](https://docs.didit.me/pt-br/entities/users/blocklist.md)
>
> Como funciona a inclusão de usuários na lista de bloqueio.

> [card] [Histórico de KYC](https://docs.didit.me/pt-br/entities/users/kyc-history.md)
>
> Todas as sessões vinculadas ao usuário.

> [card] [Console](https://docs.didit.me/pt-br/entities/users/console.md)
>
> Guia completo da interface de Usuários.


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