> ## 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.

# Inici ràpid KYB: verificació d'empreses en 10 minuts

> Verifica una empresa en menys de 10 minuts amb Didit: registre, UBO, administradors, AML i webhooks. Des de $2.00 per comprovació, sense contractes.

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](https://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**

```bash theme={null}
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": "biz-acme-001"
  }'
```

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](https://docs.didit.me/ca/console/white-label.md).

**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](https://docs.didit.me/ca/integration/webhooks.md)) 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:

```json theme={null}
{
  "event_id": "7f3c2c1e-6a1d-4c36-9d8e-0d3b5f4e2a10",
  "webhook_type": "status.updated",
  "session_id": "a1b2c3d4-5678-4abc-9def-1234567890ab",
  "business_session_id": "a1b2c3d4-5678-4abc-9def-1234567890ab",
  "session_kind": "business",
  "vendor_data": "biz-acme-001",
  "status": "Approved",
  "created_at": 1776515400,
  "timestamp": 1776515401,
  "decision": { "...": "full KYB decision" }
}
```

**5. Obtén la decisió (opcional)**

> [!NOTE]
>
> 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.

```bash theme={null}
curl https://verification.didit.me/v3/session/bs_01H.../decision/ \
  -H "x-api-key: YOUR_API_KEY"
```

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](https://docs.didit.me/ca/business-verification/response-schema.md) 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

```typescript theme={null}
import fetch from 'node-fetch';

const API_KEY = process.env.DIDIT_API_KEY!;
const WORKFLOW_ID = process.env.DIDIT_KYB_WORKFLOW_ID!;
const BASE_URL = 'https://verification.didit.me';

async function startKybVerification(vendorData: string) {
  const res = await fetch(`${BASE_URL}/v3/session/`, {
    method: 'POST',
    headers: {
      'x-api-key': API_KEY,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({ workflow_id: WORKFLOW_ID, vendor_data: vendorData }),
  });
  if (!res.ok) throw new Error(`Session create failed: ${res.status}`);
  return res.json();
}

async function getDecision(sessionId: string) {
  const res = await fetch(`${BASE_URL}/v3/session/${sessionId}/decision/`, {
    headers: { 'x-api-key': API_KEY },
  });
  return res.json();
}

// Kick off the flow
const { session_id, url } = await startKybVerification('biz-acme-001');
console.log('Deliver this URL to your contact:', url);

// ... later, after the webhook confirms completion:
const decision = await getDecision(session_id);
console.log('KYB status:', decision.status);
```

## 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](https://docs.didit.me/ca/business-verification/business-profiles.md), indexat per `vendor_data`.

## Passos següents

> [card] [Guia d'integració](https://docs.didit.me/ca/business-verification/integration-guide.md)
>
> Arquitectura completa, sondeig enfront de webhooks i lògica de reintents.

> [card] [Webhooks de KYB](https://docs.didit.me/ca/business-verification/webhooks.md)
>
> Tots els esdeveniments de KYB i l'estructura dels seus payloads.

> [card] [Estats](https://docs.didit.me/ca/business-verification/statuses.md)
>
> Referència dels estats de la sessió, de les funcionalitats i del registre.

> [card] [Esquema de resposta](https://docs.didit.me/ca/business-verification/response-schema.md)
>
> El payload complet de la decisió KYB.

> [card] [Entitats d'empresa](https://docs.didit.me/ca/entities/businesses/overview.md)
>
> Com es agreguen els perfils entre sessions.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.