Saltar al contingut principal
Les sessions són la unitat de verificació a Didit. Quan inicies una verificació, es crea una sessió; quan la verificació acaba, la sessió conté el payload complet de la decisió. La mateixa API de sessions gestiona els dos tipus: En la lliçó de l’Academy sobre el que veuen els usuaris, el capítol de 5:34 compara el flux allotjat amb la construcció de les teves pròpies pantalles, que és exactament la decisió que aquesta API pren per tu.

​
El tipus el determina el flux de treball

Quan crees una sessió, passes un workflow_id. El tipus del flux de treball determina si la sessió és de verificació d’usuaris o d’empreses; qui fa les crides no ho tria per separat. Els fluxos KYB creen sessions de verificació d’empreses (KYB); els fluxos KYC creen sessions de verificació d’usuaris (KYC).

​
Discriminador session_kind

Cada resposta de sessió (de creació, consulta, llistat, actualització d’estat, compartició i importació) inclou un camp de primer nivell:
  • "user": la sessió és una sessió de verificació d’usuaris (KYC). La resposta conté matrius de funcionalitats específiques per a usuaris.
  • "business": la sessió és una sessió de verificació d’empreses (KYB). La resposta conté matrius de funcionalitats específiques per a empreses.
Utilitza aquest camp per determinar l’estructura de la resposta al teu costat.
Els valors de l’enumeració són els identificadors curts "user" i "business"; els mantenim curts per a l’ergonomia de l’API. Els noms complets Verificació d’usuaris (KYC) i Verificació d’empreses (KYB) s’utilitzen a tota la documentació per claredat.

​
Matrius de funcionalitats segons el tipus

Les matrius de funcionalitats que hi ha en una decisió depenen del tipus. Els camps que no corresponen a un tipus no apareixen en aquella resposta (no hi ha valors nuls ni marcadors de posició):

​
Camps de primer nivell compartits

Totes les sessions (dels dos tipus) porten aquests camps:

​
Endpoints coberts

Els endpoints següents accepten qualsevol dels dos tipus. No hi ha rutes /v3/business-session/* separades.

​
Com funcionen les cerques

Les sessions de verificació d’usuaris i d’empreses són dos tipus diferents. Els IDs són UUID, de manera que les col·lisions són impossibles. Quan crides un endpoint amb un session_id, Didit:
  1. Busca l’id primer a la taula de verificació d’usuaris (cobreix la major part del trànsit).
  2. Si no el troba, busca a la taula de verificació d’empreses.
  3. Retorna 404 si cap de les dues taules conté una coincidència.
No cal que indiquis a l’API quin tipus busques.

​
Els estats són idèntics

Els valors d’estat són els mateixos per als dos tipus, i l’API els retorna exactament tal com s’escriuen aquí: "Not Started", "In Progress", "Approved", "Declined", "In Review", "Abandoned", "Expired", "Kyc Expired", "Resubmitted", "Awaiting User". La comparació és exacta i distingeix majúscules de minúscules. Consulta estats de verificació per a la referència completa.

​
Webhooks

Els esdeveniments de webhook ja inclouen un camp session_kind, perquè els teus gestors de webhooks puguin distribuir-los segons el tipus: Consulta webhooks per a la verificació de la signatura i la semàntica de reintents, i webhooks de KYB per al catàleg d’esdeveniments de la Verificació d’empreses (KYB).

​
Propers passos

Crear sessió

Inicia una verificació: Verificació d’usuaris o Verificació d’empreses (KYB).

Recuperar sessió

Obté la decisió. Funciona per als dos tipus.

Llistar sessions

Filtra per session_kind.

Actualitzar estat

Aprova, rebutja, revisa o torna a enviar.

Generar PDF

Informes PDF per tipus.

Compartir i importar

Mou sessions entre aplicacions.
Darrera modificació el 7 de novembre del 2026