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)
workflow_id, perquè l’utilitzaràs al pas següent.2
Crea una sessió de Verificació d'empreses (KYB) mitjançant l'API
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.6
Actua segons la decisió
Segons
status:"Approved": dona d’alta l’empresa."Declined": rebutja-la i registra les etiquetes dewarnings[]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.