Saltar al contingut principal
Aquesta guia et mostra com completar una verificació KYB en menys de 10 minuts. Crearàs un flux de treball, iniciaràs una sessió, enviaràs l’enllaç de verificació allotjat al contacte de l’empresa, esperaràs el webhook i obtindràs la decisió final.

Requisits previs

  • Una aplicació de Didit amb KYB habilitada. Crea’n una a business.didit.me si cal.
  • Una clau d’API des de Developer Settings → API Keys.
  • Un endpoint de webhook accessible des d’internet (per al webhook de decisió).

Passos

1

Crea un flux de treball KYB a la consola

Ves a Workflows → Create workflow. Tria Verificació d’empreses (KYB) com a tipus de flux de treball.Habilita les funcionalitats que necessitis:
  • Company registry lookup (obligatòria)
  • AML de l’empresa (recomanada)
  • Persones clau (obligatòria per a la majoria d’indústries regulades)
  • Documents (opcional; tria els tipus de document que necessitaràs)
Desa i copia el workflow_id, perquè l’utilitzaràs al pas següent.
2

Crea una sessió de Verificació d'empreses (KYB) mitjançant l'API

La resposta conté el session_id, el session_number i la url, que és l’enllaç de verificació allotjat que envies al contacte de l’empresa. El tipus de flux de treball (KYB) marca automàticament la sessió com a sessió d’empresa.
3

Envia l'enllaç al teu contacte de l'empresa

Envia la url a l’administrador de l’empresa mitjançant el teu propi correu electrònic o xat. Ell l’obrirà, omplirà les dades del registre, afegirà les persones clau i els UBO i pujarà els documents.Pots personalitzar l’experiència allotjada amb la marca, el logotip i el domini. Consulta Marca blanca.
4

Rep el webhook d'estat

Quan l’empresa acaba el procés i el processament KYB arriba a un estat final, Didit fa una sol·licitud POST amb un esdeveniment status.updated al teu endpoint de webhook. Els esdeveniments de sessions d’empresa contenen session_kind: "business" dins de data. Filtra per aquest camp per encaminar l’esdeveniment al teu gestor KYB.Verifica la signatura HMAC X-Signature-V2 abans de confiar en l’esdeveniment (consulta webhooks) i, després, activa la lògica posterior. Desa el secret_shared_key de la destinació del webhook (que es retorna en registrar el webhook) com a DIDIT_WEBHOOK_SECRET al teu .env.Exemple de payload:
5

Obtén la decisió (opcional)

El payload del webhook status.updated ja conté la decisió completa. Només cal que cridis aquest endpoint si no t’has subscrit als webhooks o si vols obtenir la decisió sota demanda més endavant.
La decisió inclou les dades del registre, les persones clau (UBO, accionistes, administradors i representants), les coincidències d’AML, els documents i els resultats per funcionalitat. Consulta esquema de resposta per a la referència completa del payload.
6

Actua segons la decisió

Segons status:
  • "Approved": dona d’alta l’empresa.
  • "Declined": rebutja-la i registra les etiquetes de warnings[] de la decisió.
  • "In Review": espera la decisió de l’analista; rebràs un altre webhook quan es resolgui.

Exemple en Node.js

Què passa automàticament

  • Consulta del registre mercantil de l’empresa en 190+ jurisdiccions.
  • Extracció dels UBO i dels càrrecs a partir de les dades del registre.
  • Cribratge AML a nivell d’empresa (sancions, PEP, mitjans adversos).
  • AML a nivell de persona per a cada part identificada.
  • OCR de documents i creuament de dades.
  • Creació i agregació del perfil d’empresa, indexat per vendor_data.

Passos següents

Guia d'integració

Arquitectura completa, sondeig enfront de webhooks i lògica de reintents.

Webhooks de KYB

Tots els esdeveniments de KYB i l’estructura dels seus payloads.

Estats

Referència dels estats de la sessió, de les funcionalitats i del registre.

Esquema de resposta

El payload complet de la decisió KYB.

Entitats d'empresa

Com es agreguen els perfils entre sessions.
Darrera modificació el 7 de novembre del 2026