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

# Model de dades d'usuari: esquema del proveïdor

> Cada camp de l'entitat d'usuari de Didit: identitat, estat, agregats de sessions KYC, biometria, activitat i metadades. Preus per ús.

Aquesta pàgina documenta tots els camps de l'entitat User. Els camps es divideixen en cinc grups: identitat, estat, agregats de sessions, marques de temps d'activitat i metadades.

## Camps d'identitat

| Camp | Tipus | Descripció |
| - | - | - |
| `uuid` | UUID | Clau primària assignada per Didit. Estable i única. |
| `didit_internal_id` | cadena | Identificador intern llegible (es mostra a les respostes de l'API). |
| `vendor_data` | cadena | El teu identificador de l'usuari. Únic per aplicació. [Més informació](https://docs.didit.me/ca/entities/vendor-data-linking.md). |
| `display_name` | cadena | Nom de substitució que es mostra a la consola. Per defecte, pren el valor de `full_name` o `vendor_data` si no s'estableix. |
| `full_name` | cadena | Nom complet legal propagat des del document d'identitat de la sessió de verificació d'usuaris (KYC) aprovada més recent. |
| `date_of_birth` | data (ISO 8601) | Propagada des de la sessió de verificació d'usuaris (KYC) aprovada més recent. |
| `portrait_image` | URL | URL signada de S3 de la selfie de la prova de vida aprovada més recent. |

> [!NOTE]
>
> `full_name`, `date_of_birth` i `portrait_image` són de només lectura quan es deriven d'una sessió verificada. Pots substituir-los des de la consola o mitjançant `PATCH /v3/users/{vendor_data}/`, però les substitucions manuals queden marcades al registre d'auditoria.

## Estat

| Camp | Tipus | Valors | Descripció |
| - | - | - | - |
| `status` | enumeració | `ACTIVE`, `FLAGGED`, `BLOCKED` | Controla l'aplicació de les restriccions per a les sessions i les transaccions futures. Consulta el [cicle de vida](https://docs.didit.me/ca/entities/lifecycle.md). |

## Camps agregats de sessions

Didit calcula aquests camps i s'actualitzen en temps real a mesura que es completen les sessions.

| Camp | Tipus | Descripció |
| - | - | - |
| `session_count` | enter | Total de sessions que s'han creat mai per a aquest usuari |
| `approved_count` | enter | Sessions que han finalitzat amb `APPROVED` |
| `declined_count` | enter | Sessions que han finalitzat amb `DECLINED` |
| `in_review_count` | enter | Sessions que actualment estan `IN_REVIEW` |
| `issuing_states[]` | matriu de codis de país ISO | Països emissors de tots els documents d'identitat verificats en les sessions |
| `approved_emails[]` | matriu de cadenes | Correus electrònics verificats mitjançant la [Verificació de correu electrònic](https://docs.didit.me/ca/core-technology/email-verification/overview.md) |
| `approved_phones[]` | matriu de cadenes | Números de telèfon verificats mitjançant la [Verificació de telèfon](https://docs.didit.me/ca/core-technology/phone-verification/overview.md) |
| `features` | objecte | Estat més recent de cada funcionalitat en totes les sessions |

### El mapa `features`

Cada sessió executa una o diverses funcionalitats (verificació d'identitat, prova de vida, coincidència facial, AML, POA, NFC, etc.). El mapa `features` conté l'estat **més recent** de cada funcionalitat per a aquest usuari:

```json theme={null}
{
  "id_verification": "APPROVED",
  "liveness": "APPROVED",
  "face_match": "APPROVED",
  "aml": "IN_REVIEW",
  "proof_of_address": "APPROVED",
  "nfc_verification": "NOT_FINISHED"
}
```

Estats de les funcionalitats: `NOT_FINISHED`, `APPROVED`, `DECLINED`, `IN_REVIEW`, `EXPIRED`, `ABANDONED`, `RESUB_REQUESTED`.

Utilitza el mapa `features` com a via ràpida per saber si un usuari està completament verificat en aquest moment, sense recórrer totes les sessions.

## Marques de temps d'activitat

| Camp | Tipus | S'actualitza quan |
| - | - | - |
| `first_session_at` | marca de temps ISO | Es va crear la primera sessió |
| `last_session_at` | marca de temps ISO | Es va crear o actualitzar la sessió més recent |
| `last_activity_at` | marca de temps ISO | Qualsevol canvi: sessió, transacció, estat, perfil, notes o etiquetes |
| `created_at` | marca de temps ISO | Es va crear la fila de l'entitat |
| `updated_at` | marca de temps ISO | Es va actualitzar per última vegada la fila de l'entitat |

## Metadades

| Camp | Tipus | Descripció |
| - | - | - |
| `metadata` | objecte (JSON) | JSON de format lliure que tu controles. Utilitza'l per a etiquetes internes, nivell, origen de l'alta, etc. |
| `tags[]` | matriu | Etiquetes gestionades des de la consola o l'API per filtrar i agrupar |

Les metadades no tenen esquema: Didit conserva tot el que escriguis.

## Relacions (no emmagatzemades a la fila de l'usuari)

| Relació | Com accedir-hi |
| - | - |
| Sessions | `GET /v3/sessions?vendor_data=<value>` |
| Transaccions (com a sol·licitant) | `GET /v3/transactions/?vendor_data=<value>` |
| Transaccions (com a contrapart) | Filtra la llista de transaccions per vendor\_data de la contrapart a la consola |
| Empreses vinculades (administrador / UBO) | Es mostren a la pàgina de detall de l'usuari a la consola |
| Biometria facial | Consola i API de llistes |
| Entrades de la llista de bloqueig | [API de llistes](https://docs.didit.me/ca/management-api/lists/overview.md): filtra les entrades pels identificadors de l'usuari |

## Exemple de resposta

```json theme={null}
{
  "uuid": "9c7d2a30-2f98-4d4f-9d2d-1a7c4b1e5b6a",
  "didit_internal_id": "U-2026-00042",
  "vendor_data": "user-42",
  "display_name": "Jane Doe",
  "full_name": "John Doe",
  "date_of_birth": "1990-01-01",
  "portrait_image": "https://<media-host>/...",
  "status": "ACTIVE",
  "session_count": 3,
  "approved_count": 2,
  "declined_count": 0,
  "in_review_count": 1,
  "issuing_states": ["US", "ES"],
  "approved_emails": ["jane@example.com"],
  "approved_phones": ["+14155550123"],
  "features": {
    "id_verification": "APPROVED",
    "liveness": "APPROVED",
    "face_match": "APPROVED",
    "aml": "IN_REVIEW"
  },
  "first_session_at": "2025-03-01T12:00:00Z",
  "last_session_at": "2026-04-10T09:00:00Z",
  "last_activity_at": "2026-04-16T10:00:00Z",
  "metadata": { "tier": "premium" }
}
```

## Propers passos

> [card] [Operacions](https://docs.didit.me/ca/entities/users/operations.md)
>
> Crear, actualitzar, canviar l'estat i eliminar.

> [card] [Historial KYC](https://docs.didit.me/ca/entities/users/kyc-history.md)
>
> Recuperar totes les sessions vinculades a l'usuari.

> [card] [Referència de l'API](https://docs.didit.me/ca/management-api/users/get.md)
>
> Esquema de GET /v3/users/{vendor_data}/.


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