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

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ó.
`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.

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.

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
`approved_phones[]`	matriu de cadenes	Números de telèfon verificats mitjançant la Verificació de telèfon
`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:

{
  "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: filtra les entrades pels identificadors de l’usuari

Exemple de resposta

{
  "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

Operacions

Crear, actualitzar, canviar l’estat i eliminar.

Historial KYC

Recuperar totes les sessions vinculades a l’usuari.

Referència de l'API

Esquema de GET /v3/users//.

Visió general

Preus

Fluxos de treball i verificació

Revisió i operacions

Entitats (usuaris i empreses)

Configuració i personalització

Seguretat i compliment

Didit Academy

Recursos

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

Camps d’identitat

Estat

Camps agregats de sessions

El mapa `features`

Marques de temps d’activitat

Metadades

Relacions (no emmagatzemades a la fila de l’usuari)

Exemple de resposta

Propers passos

Operacions

Historial KYC

Referència de l'API

​Camps d’identitat

​Estat

​Camps agregats de sessions

​El mapa features

​Marques de temps d’activitat

​Metadades

​Relacions (no emmagatzemades a la fila de l’usuari)

​Exemple de resposta

​Propers passos

Operacions

Historial KYC

Referència de l'API

Camps d’identitat

Estat

Camps agregats de sessions

El mapa `features`

Marques de temps d’activitat

Metadades

Relacions (no emmagatzemades a la fila de l’usuari)

Exemple de resposta

Propers passos