> ## 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. # Cicle de vida d'entitats: estats d'usuari i empresa > Estats i transicions de les entitats Usuari i Empresa de Didit: creació, verificació, transicions ACTIVE/FLAGGED/BLOCKED i eliminació. De pagament per crida. Cada entitat d'usuari i d'empresa a Didit segueix un cicle de vida previsible. Entendre aquest cicle és clau per dissenyar els fluxos d'alta, de monitoratge continu i de mesures correctives. ## Diagrama del cicle de vida ```mermaid theme={null} stateDiagram-v2 [*] --> ACTIVE: Created (API, console, or auto from session) ACTIVE --> FLAGGED: Rule match / analyst review / suspicious pattern FLAGGED --> ACTIVE: Analyst clears / remediation completed ACTIVE --> BLOCKED: Manual block / blocklist match FLAGGED --> BLOCKED: Investigation concludes blocked BLOCKED --> ACTIVE: Manual unblock (analyst only) ``` ## Estats en detall | Estat | Significat | Aplicació | | - | - | - | | `ACTIVE` | Per defecte: l'entitat està en bon estat | Les noves sessions i transaccions passen pels fluxos de treball i les regles que hagis configurat | | `FLAGGED` | L'entitat té un problema pendent que requereix revisió | Les noves sessions continuen executant-se, però per defecte queden com a `IN_REVIEW`; les transaccions es poden escalar automàticament segons les regles | | `BLOCKED` | L'entitat està bloquejada a la teva plataforma | Les noves sessions es rebutgen automàticament; les noves transaccions es rebutgen automàticament; no es poden crear enllaços de sessió nous per a aquest `vendor_data` | > [!NOTE] > > Canviar l'estat mitjançant `PATCH /v3/users/{vendor_data}/update-status/` o `PATCH /v3/businesses/{vendor_data}/update-status/` emet un webhook (`user.status.updated` / `business.status.updated`) perquè els sistemes posteriors puguin reaccionar en temps real. ## Fases del cicle de vida **1. Creació** Una entitat es crea de tres maneres: * **Creada automàticament** quan inicies una sessió amb un `vendor_data` nou. L'entitat es crea amb estat `ACTIVE`. * **Creada prèviament mitjançant l'API** amb `POST /v3/users/create/` o `POST /v3/businesses/create/`. L'estat per defecte és `ACTIVE`. * **Creada a la consola** per un operador de compliment: l'estat comença com a `ACTIVE`, tret que l'operador especifiqui una altra cosa. Cada entitat rep un `uuid` generat per Didit i un identificador `vendor_data` que pertany al client. **2. Verificació** Les sessions s'associen a l'entitat mitjançant `vendor_data`. Cada sessió passa pel [flux de treball](https://docs.didit.me/ca/console/workflows.md) configurat: verificació d'identitat, prova de vida, coincidència facial, AML, documents, consulta al registre per a KYB, etc. Les sessions completades actualitzen els comptadors agregats de l'entitat: * `session_count`, `approved_count`, `declined_count`, `in_review_count` * El mapa `features`: l'estat més recent de cada funcionalitat en el conjunt de sessions (p. ex. `{ "id_verification": "APPROVED", "aml": "IN_REVIEW" }`) * Els camps del perfil es propaguen des de l'última sessió aprovada (p. ex. `full_name`, `date_of_birth`, `portrait_image`). **3. Ús actiu** Quan una entitat té una o més sessions aprovades, pots: * **Enviar transaccions** que facin referència a l'entitat mitjançant `vendor_data` al payload de la transacció * **Executar monitoratge AML continu**: reescanejos periòdics de les llistes de sancions, PEP i mitjans adversos * **Reverificar segons un calendari**: crear noves sessions per al mateix `vendor_data` a intervals regulars * **Agregar senyals de risc** entre sessions i transaccions **4. Transicions d'estat** Els canvis d'estat de l'entitat es produeixen automàticament o manualment. **Transicions automàtiques** * `ACTIVE → FLAGGED` quan una transacció supera el llindar de revisió o una regla afegeix l'entitat a una llista de vigilància. * `ACTIVE → BLOCKED` quan una biometria facial coincideix amb una entrada d'una llista de bloqueig. Una sessió rebutjada no posa l'entitat a la llista de bloqueig, per tant no canvia l'estat. Afegir a la llista de bloqueig un subjecte rebutjat és un pas manual: afegeix l'entrada des de la [pàgina de llista de bloqueig](https://docs.didit.me/ca/console/blocklist-users.md) o des de l'[API de llistes](https://docs.didit.me/ca/management-api/lists/overview.md), i una entrada de tipus `USER` (el `vendor_data`) estableix l'estat a `BLOCKED`. **Les transicions manuals** es produeixen quan un analista canvia l'estat des de la consola o quan crides l'endpoint `update-status`. Cada transició emet un webhook `user.status.updated` o `business.status.updated`. **5. Eliminació** Les entitats s'eliminen mitjançant `POST /v3/users/delete/` o `POST /v3/businesses/delete/` (en lot). El registre de l'entitat s'elimina de manera permanent. En eliminar un usuari, també es purga cada [plantilla biomètrica](https://docs.didit.me/ca/management-api/biometric-templates/overview.md) conservada per a aquest usuari després de l'eliminació de les sessions, de manera que la persona deixa de coincidir en la detecció de duplicats i en la Cerca facial. Aquests endpoints no cobreixen les sessions de verificació ni les transaccions. Elimina les sessions amb [Eliminar sessió](https://docs.didit.me/ca/sessions-api/delete-session.md) o [Eliminar sessions en lot](https://docs.didit.me/ca/management-api/sessions/batch-delete.md); les transaccions s'eliminen des de la consola. ## Marques de temps d'activitat Les entitats registren l'activitat per ajudar-te a identificar perfils inactius o actius: | Marca de temps | S'actualitza quan | | - | - | | `first_session_at` | Es va crear la primera sessió per a aquesta entitat | | `last_session_at` | Es va crear o actualitzar la sessió més recent | | `last_activity_at` | S'ha produït qualsevol canvi: sessió, transacció, canvi d'estat o actualització del perfil | Fes servir aquestes marques de temps per filtrar entitats inactives, programar reverificacions o activar el monitoratge continu. ## Esdeveniments emesos durant el cicle de vida | Fase del cicle de vida | Webhooks emesos | | - | - | | Creació (automàtica des de la sessió) | `status.updated` (sessió), `user.data.updated` o `business.data.updated` | | Verificació | `status.updated` (sessió), `data.updated` | | Canvi d'estat | `user.status.updated` o `business.status.updated` | | Transacció enviada | `transaction.created` | | Canvi d'estat de la transacció | `transaction.status.updated` | Consulta els [webhooks d'entitats](https://docs.didit.me/ca/entities/webhooks.md) per a les estructures de payload i la semàntica de lliurament. ## Següents passos > [card] [Vinculació de vendor\_data](https://docs.didit.me/ca/entities/vendor-data-linking.md) > > Com `vendor_data` vincula sessions, transaccions i entitats entre si. > [card] [Operacions amb usuaris](https://docs.didit.me/ca/entities/users/operations.md) > > Crear, actualitzar, canviar l'estat i eliminar entitats d'usuari. > [card] [Operacions amb empreses](https://docs.didit.me/ca/entities/businesses/operations.md) > > Crear, actualitzar, canviar l'estat i eliminar entitats d'empresa. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.