API de verificació d'empreses (KYB): registre i titulars

La Verificació d’empreses (KYB) de Didit et permet verificar empreses i entitats jurídiques abans de donar-les d’alta a la teva plataforma. El sistema automatitza les consultes als registres mercantils, identifica els titulars reals i les persones amb càrrecs directius, sotmet totes les parts a un cribratge amb les llistes de vigilància AML i recull els documents de suport, tot dins d’un únic flux de treball. Cada empresa verificada es registra com a perfil d’empresa, que agrega els resultats de totes les sessions. Aquesta lliçó de Didit Academy segueix una verificació d’empresa de principi a fi: el tauler de KYB, la consulta al registre, els accionistes i els UBOs, el cribratge AML i el que veu el representant de l’empresa des de la seva banda. Ets nou amb el KYB de Didit? Comença amb la guia d’inici ràpid per fer un recorregut complet en 10 minuts i després llegeix la guia d’integració per als patrons de producció. Per al model d’entitat Business subjacent (amb enllaços a usuaris, llistes de bloqueig, importació i exportació), consulta Empreses.

Com funciona

Crea una sessió d'empresa

Inicia una verificació d’empresa creant una sessió amb un flux de treball KYB. Quan el tipus de flux és KYB, Didit crea automàticament una sessió d’empresa:

curl -X POST https://verification.didit.me/v3/session/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow_id": "your-kyb-workflow-id",
    "vendor_data": "company-123"
  }'

El tipus de sessió el determina el flux de treball: no cal cap camp addicional. Els fluxos KYB creen automàticament sessions d’empresa amb les funcionalitats específiques per a empreses activades.

Consulta al registre mercantil

Didit consulta els registres oficials d’empreses als nivells Lite, Shareholders o UBOs, cadascun amb un preu per país; consulta preus dels registres. Lite recupera:

Dada	Descripció
Nom de l’empresa	Nom legal tal com figura inscrit
Número de registre	Número oficial d’inscripció de l’empresa
País	País de constitució
Estat	Activa, dissolta, donada de baixa, etc.
Tipus d’empresa	Ltd, LLC, PLC, SA, GmbH, etc.
Data de constitució	Data en què es va inscriure l’empresa
Adreça social	Adreça oficial de la seu social registrada
Número fiscal	Número d’identificació fiscal (quan està disponible)

Les dades del registre es contrasten amb la informació facilitada per detectar incoherències.

Persones clau: UBO, accionistes, administradors i representants

El sistema identifica cada persona i entitat corporativa vinculada a l’empresa dins del model unificat de Persones clau:

UBO: persones físiques que en última instància posseeixen o controlen l’empresa, amb els percentatges de propietat i de vot
Accionistes (persones físiques i jurídiques): cadascun amb el seu percentatge de propietat
Administradors, representants, secretaris, signants autoritzats i altres càrrecs: amb l’etiqueta de rol específica
Capes de titularitat corporativa: empreses matrius de la cadena de titularitat, amb KYB anidat opcional

Una mateixa persona pot tenir diverses etiquetes de rol (per exemple, administradora i accionista). Cada rol es configura individualment al flux de treball: quins rols requereixen KYC, quin flux KYC s’utilitza i si l’usuari final pot saltar-se la verificació. Més informació a Persones clau i Titularitat.

Cribratge AML

Totes les parts identificades se sotmeten automàticament a un cribratge contra les llistes globals de vigilància AML:

AML Empresa: cribra l’entitat de l’empresa contra sancions, mitjans adversos i llistes d’aplicació de la normativa
AML de persones: cribra cada persona clau (UBO, accionista, administrador, representant, etc.) de manera individual
Utilitza el mateix sistema de risc de dues puntuacions (puntuació de coincidència + puntuació de risc) que la verificació d’usuaris

Recollida de documents

Recull i verifica els documents de suport:

Tipus de document	Exemples
Certificat de constitució	Certificat de constitució de l’empresa
Estatuts socials	Estatuts, memoràndum d’associació
Comprovant de domicili	Factures de serveis, extractes bancaris de l’adreça social
Registre d’accionistes	Registre oficial d’accionistes
Estats financers	Comptes anuals, informes d’auditoria
Certificats fiscals	Certificats d’inscripció fiscal o de compliment fiscal
Documents personalitzats	Qualsevol document addicional que requereixi el teu procés de compliment

Els analistes poden sol·licitar documents addicionals a l’empresa durant el procés de revisió.

Revisió i decisió

La sessió d’empresa rep un estat general basat en totes les comprovacions:

Estat	Significat
Aprovada	Totes les comprovacions superades: l’empresa està verificada
En revisió	Una o més comprovacions requereixen revisió manual
Rebutjada	Una comprovació crítica ha fallat (per exemple, empresa dissolta o entitat sancionada)

Els analistes poden revisar totes les dades recollides a la Business Console, afegir comentaris, sol·licitar documents addicionals i prendre una decisió final.

Cicle de vida de la sessió d’empresa

Cada verificació d’empreses (KYB) s’executa dins d’una sessió d’empresa que fa el seguiment del progrés amb els estats següents:

Estat	Descripció
`"Not Started"`	Sessió creada, però la verificació encara no ha començat
`"In Progress"`	La verificació està en curs: consultes al registre, cribratge AML o recollida de documents en marxa
`"Approved"`	Totes les comprovacions s’han superat: l’empresa està verificada
`"Declined"`	Ha fallat una comprovació crítica (per exemple, una empresa dissolta o una entitat sancionada)
`"In Review"`	Una o més comprovacions requereixen revisió manual per part d’un analista
`"Resubmitted"`	Sessió rebutjada anteriorment i reenviada amb dades actualitzades

Cada sessió té un session_id únic, un session_number seqüencial i un session_token per a l’enllaç de verificació allotjat. Quan es crea una sessió amb un identificador vendor_data, Didit l’enllaça automàticament amb el perfil d’empresa corresponent.

Estats de les funcionalitats

La verificació d’empreses (KYB) fa el seguiment de l’estat de cada component de manera independent:

Funcionalitat	Descripció
Comprovació del registre mercantil	Consulta al registre mercantil de l’empresa i extracció de dades
AML d’empresa	Cribratge AML a nivell d’empresa contra sancions i llistes de vigilància
Documents	Recollida de documents, OCR i encreuament de dades
Persones clau	Identificació del titular real i dels càrrecs, AML i KYC

Cada funcionalitat pot estar en un dels estats següents: "Not Finished", "Approved", "Declined", "In Review" o "Resub Requested". L’estat general de la sessió agrega els estats de les funcionalitats individuals: la sessió només està "Approved" quan totes les funcionalitats obligatòries s’han superat.

Esdeveniments de webhook

Les sessions d’empresa generen els esdeveniments de webhook següents:

Esdeveniment	Activador
`status.updated`	Ha canviat l’estat de la sessió. El payload inclou `session_kind: "business"` per a les sessions KYB.
`data.updated`	Un revisor ha editat les dades del registre o les Persones clau a la consola, o el registre ha informat d’un canvi. El payload inclou `session_kind: "business"`. Seguiu `status.updated` per veure el progrés.
`business.status.updated`	Ha canviat l’estat de la entitat empresarial enllaçada (`ACTIVE` / `FLAGGED` / `BLOCKED`).
`business.data.updated`	Han canviat els camps del perfil o els comptadors agregats de l’entitat empresarial enllaçada.

Els payloads de webhook inclouen session_kind: "business" i el business_session_id per distingir aquests esdeveniments dels esdeveniments de verificació d’usuaris. Consulteu Webhooks per a la verificació de la signatura i els detalls del lliurament.

Capacitats principals

Capacitat	Descripció
Consultes automàtiques al registre	Consulta els registres mercantils oficials dels països compatibles en el nivell Lite, Shareholders o UBOs, amb preu per país
Identificació de titulars reals	Extreu automàticament les estructures de titularitat real amb els percentatges
Cribratge de càrrecs	Identifica i verifica administradors, secretaris i altres càrrecs
AML d’empresa	Cribratge de l’entitat empresarial contra sancions i llistes de vigilància
AML de persones	Cribratge individual de tots els titulars reals i càrrecs identificats
Vinculació KYC	Vincula cada persona identificada amb una sessió de Verificació d’usuaris (KYC) per a la verificació d’identitat
Recollida de documents	Sol·licituds de documents estructurades amb seguiment de les càrregues
Verificació creuada amb OCR	Extreu dades dels documents pujats i les encreua amb les dades del registre
Perfils d’empresa	Creació automàtica de perfils i agregació de sessions per a cada empresa verificada
Estats per funcionalitat	Seguiment independent de l’estat del registre, l’AML, els documents i les persones clau
Avaluació de risc	Etiquetes d’advertència a cada comprovació i accions de flux de treball que converteixen l’estat de l’empresa, els resultats AML i les conclusions sobre la titularitat en un resultat
Webhooks	Rep en temps real els esdeveniments del cicle de vida de la sessió i d’actualització de dades mitjançant webhooks

Sessions d’empresa vs. sessions d’usuari

Funcionalitat	Sessió d’usuari	Sessió d’empresa
Objectiu	Persona física	Empresa o entitat jurídica
Tipus de sessió	`user` (per defecte)	`business`
Comprovacions principals	ID, prova de vida, coincidència facial, AML	Consulta al registre, titular real, càrrecs, AML d’empresa
Comprovacions addicionals	Telèfon, correu electrònic, comprovant de domicili, NFC	Recollida de documents, AML de persones, vinculació KYC
Payloads de webhook	Esdeveniments de sessió estàndard	Inclouen `session_kind: "business"` i `business_session_id`

Següents passos

Perfils d'empresa

Fes el seguiment d’empreses entre sessions amb perfils, etiquetes i operacions en lot.

Dades de l'empresa

Consultes al registre, estat de l’empresa i encreuament de dades.

Estructura de titularitat

Identificació de titulars reals, accionistes corporatius i cadenes de titularitat.

Càrrecs i administradors

Identificació d’administradors, rols i vinculació KYC.

Cribratge AML

Comprovacions AML a nivell d’empresa i de persona.

Documents

Recollida de documents, sol·licituds i verificació OCR.

Primers passos

Funcionalitats

Perfils d'empresa

Referència

Consola

API de verificació d'empreses (KYB): registre i titulars

Com funciona

Cicle de vida de la sessió d’empresa

Estats de les funcionalitats

Esdeveniments de webhook

Capacitats principals

Sessions d’empresa vs. sessions d’usuari

Següents passos

Perfils d'empresa

Dades de l'empresa

Estructura de titularitat

Càrrecs i administradors

Cribratge AML

Documents

​Com funciona

​Cicle de vida de la sessió d’empresa

​Estats de les funcionalitats

​Esdeveniments de webhook

​Capacitats principals

​Sessions d’empresa vs. sessions d’usuari

​Següents passos

Perfils d'empresa

Dades de l'empresa

Estructura de titularitat

Càrrecs i administradors

Cribratge AML

Documents

Com funciona

Cicle de vida de la sessió d’empresa

Estats de les funcionalitats

Esdeveniments de webhook

Capacitats principals

Sessions d’empresa vs. sessions d’usuari

Següents passos