Entitats: usuaris i empreses a Didit

Didit organitza tot el que passa a la teva aplicació al voltant de dos tipus d’entitat de primera classe:

Entitat	Representa	Vinculada a
Usuari	Una persona física	Sessions de Verificació d’usuaris (KYC), biometria facial, transaccions (com a sol·licitant o contrapart), llistes de bloqueig
Empresa	Una entitat jurídica (companyia, LLC, empresa individual, fons)	Sessions de Verificació d’empreses (KYB), càrrecs directius, UBO, transaccions (com a sol·licitant o contrapart), llistes de bloqueig

Cada sessió de verificació, cada transacció i cada entrada d’una llista de bloqueig es pot vincular a una entitat. Un cop vinculada, l’entitat es converteix en un perfil persistent que agrega l’historial, els senyals de risc i l’estat de compliment al llarg del temps.

Diferència entre entitat i sessió

Una entitat i una sessió són coses diferents.

Concepte	Abast	Durada	Exemple
Sessió	Un esdeveniment de verificació	Un únic flux (de minuts a dies mentre està en revisió)	Un únic intent de KYC
Entitat	Un perfil persistent	Viu mentre l’usuari o l’empresa existeixi a la teva plataforma	El client “Jane Doe” amb 3 sessions de Verificació d’usuaris (KYC) al llarg de 2 anys

Una mateixa entitat pot tenir moltes sessions: reverificacions, reenviaments, comprovacions addicionals i monitoratge continu periòdic. L’entitat n’agrega els resultats.

Creació automàtica o creació prèvia manual

Les entitats es creen de tres maneres:

Creada automàticament des d'una sessió

Quan crees una sessió amb un identificador vendor_data i no existeix cap entitat corresponent, Didit crea l’entitat automàticament. És la via més habitual.

curl -X POST https://verification.didit.me/v3/session/ \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{ "workflow_id": "wf_kyc_standard", "vendor_data": "user-42" }'

Una entitat d’usuari per a user-42 es crea en el moment en què comença la sessió.

Creada prèviament amb l'API de gestió

Crea primer l’entitat i després inicia sessions amb ella. És útil quan vols carregar senyals de risc (estat, etiquetes, metadades personalitzades) abans de la primera verificació.

curl -X POST https://verification.didit.me/v3/users/create/ \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{ "vendor_data": "user-42", "display_name": "Jane Doe" }'

Creada a la consola

El teu equip de compliment pot crear usuaris o empreses directament des de la Business Console, cosa que és útil per a l’alta manual, les importacions o els fluxos de treball de correcció.

Com les entitats ho enllacen tot

El camp vendor_data és la clau d’enllaç. Quan passes vendor_data a qualsevol sessió o transacció, Didit l’encamina a l’entitat corresponent. Més informació a la guia de vinculació amb vendor_data.

Què pots fer amb una entitat

Per a cada entitat d’usuari o d’empresa, pots:

Operació	Finalitat
Crear / actualitzar	Definir o canviar les dades del perfil de l’entitat (nom, país, metadades personalitzades)
Canviar estat	Marcar-la com a `ACTIVE`, `FLAGGED` o `BLOCKED`. L’aplicació de la mesura es propaga a les sessions i transaccions futures
Adjuntar biometria	Pujar una referència facial per a una cerca 1:N, detecció de duplicats o inclusió a una llista de bloqueig
Revisar l’historial de KYC/KYB	Recuperar totes les sessions vinculades a l’entitat, amb resultats per funcionalitat
Revisar l’historial de transaccions	Recuperar totes les transaccions en què l’entitat és el sol·licitant o la contrapart
Afegir a una llista de bloqueig	Bloquejar les sessions o transaccions futures que impliquin aquesta entitat
Importar / exportar	Carregar entitats en massa des de CSV o exportar-les per a eines externes de compliment
Eliminar	Eliminar l’entitat (l’historial es conserva per a auditoria)

Les guies detallades es troben a Usuaris i Empreses.

Relacions entre usuaris i empreses

Un mateix usuari pot estar vinculat a una o diverses empreses. Això passa de manera natural durant el KYB:

Un usuari pot ser administrador d’una empresa i UBO d’una altra.
La sessió de KYC d’un usuari es pot vincular a la sessió de KYB d’una empresa mitjançant el flux de Persones clau.

Didit conserva aquestes relacions: en inspeccionar una entitat d’empresa, pots veure cada usuari vinculat, i en inspeccionar una entitat d’usuari, pots veure cada empresa a la qual està associat.

Cicle de vida i estats

Cada entitat té un estat que determina si Didit aplica bloquejos a l’activitat nova:

Estat	Efecte
`ACTIVE`	Normal: les sessions i transaccions avancen segons la configuració dels fluxos de treball i les regles
`FLAGGED`	Les sessions i transaccions es permeten, però s’encaminen automàticament a revisió manual
`BLOCKED`	Les sessions i transaccions es rebutgen automàticament, i no es pot crear cap sessió nova

Consulta el cicle de vida complet de l’entitat per a les transicions i els esdeveniments de webhook.

Següents passos

Cicle de vida

Estats, transicions i esdeveniments del cicle de vida de cada entitat.

Vinculació de vendor_data

Com vendor_data vincula sessions, transaccions i entitats.

Usuaris

Anàlisi detallada de les entitats d’usuari, les seves operacions i els fluxos de treball a la consola.

Empreses

Anàlisi detallada de les entitats d’empresa, les seves operacions i els fluxos de treball a la consola.

Webhooks d'entitats

Esdeveniments en temps real per a cada canvi d’entitat.

Llista de bloqueig

Com les entrades de la llista de bloqueig interactuen amb les entitats d’usuari i d’empresa.

Visió general

Preus

Fluxos de treball i verificació

Revisió i operacions