Vinculació de vendor_data: enllaça IDs amb entitats

vendor_data és l’identificador que proporciones en cada sessió i transacció per vincular-les a una entitat Usuari o Empresa. És el camp més important per a l’agregació d’entitats: si el fas bé, totes les funcionalitats posteriors (historial del perfil, monitoratge de transaccions, aplicació de la llista de bloqueig, AML continu) funcionen sense problemes.

Què és

vendor_data és una cadena que tries tu. Didit el tracta com un identificador opac i no interpreta el contingut. Valors típics:

El teu sistema	Valors recomanats de `vendor_data`
Base de dades interna d’usuaris	`user_1234`, `uuid-v4` de l’usuari
Identificador visible per al client	`CUST-2026-00042`, correu electrònic amb hash
SaaS multiinquilí	`tenant_acme:user_1234`
Plataforma B2B	`company-hq-global`, `tax-id-US-123456789`

No posis dades personals (correus electrònics, números de telèfon, NIF o identificadors fiscals en brut) directament a vendor_data. Aplica-hi un hash o un prefix. vendor_data apareix als payloads dels webhooks i es conserva indefinidament mentre existeixi l’entitat.

Com vincula les coses

Quan envies una sessió o una transacció amb un valor de vendor_data:

Didit busca a la teva aplicació l’entitat amb aquest vendor_data.
Si existeix, el nou objecte es vincula a aquesta entitat.
Si no existeix, Didit crea l’entitat (amb status: ACTIVE) i vincula el nou objecte.

Això és vàlid per a:

POST /v3/session/: sessions de verificació KYC i de verificació d’empreses (KYB)
POST /v3/transactions/: transaccions (tant per al sol·licitant com per a la contrapart)
Els camps applicant.vendor_data i counterparty.vendor_data dels payloads de transaccions

Unicitat i àmbit

vendor_data és únic per aplicació, no a tot Didit:

Àmbit	Garantia d’unicitat
Dins d’una aplicació	`vendor_data` és únic per tipus d’entitat (Usuari i Empresa són espais de noms separats)
Entre aplicacions de la teva organització	`vendor_data` no es comparteix: el mateix valor en dues aplicacions fa referència a dues entitats diferents
Entre organitzacions	No es comparteix: cada organització té les seves pròpies taules d’entitats

Això vol dir que pots fer servir el mateix vendor_data en una aplicació de preproducció i en una de producció sense col·lisions, i que pots tenir un Usuari user-42 i una Empresa user-42 sense col·lisió (tot i que es desaconsella per claredat).

Què passa si omets `vendor_data`

Pots crear una sessió sense vendor_data. En aquest cas:

No es crea cap entitat per a la sessió.
La sessió queda òrfena: no apareixerà al perfil de cap Usuari ni d’Empresa.
No pots buscar la sessió més endavant per vendor_data, només per session_id.

Fes servir aquest patró només per a verificacions anònimes o puntuals en què no calgui l’agregació d’entitats. Per a qualsevol integració que impliqui reverificació, transaccions o monitoratge continu, proporciona sempre vendor_data.

Exemple: crear una entitat per avançat i després executar sessions

# 1. Pre-create the User with initial metadata
curl -X POST https://verification.didit.me/v3/users/create/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "vendor_data": "user-42",
    "display_name": "Jane Doe",
    "metadata": { "tier": "premium", "signup_date": "2026-04-01" }
  }'

# 2. Create a User Verification (KYC) session for the same user
curl -X POST https://verification.didit.me/v3/session/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow_id": "wf_kyc_standard",
    "vendor_data": "user-42"
  }'

# 3. Later, submit a transaction tied to the same user
curl -X POST https://verification.didit.me/v3/transactions/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "txn_id": "tx-0001",
    "direction": "OUTBOUND",
    "amount": "500.00",
    "currency": "EUR",
    "applicant": { "vendor_data": "user-42" },
    "counterparty": { "name": "Acme Corp" }
  }'

Les tres crides estan vinculades a la mateixa entitat Usuari. Quan després facis GET /v3/users/user-42/, veuràs el nombre de sessions, els comptadors d’aprovades i rebutjades, les transaccions vinculades i les dades més recents del perfil.

Migració d’identificadors externs

Si adoptes Didit després d’un proveïdor KYC existent, passa els teus identificadors d’usuari estables actuals com a vendor_data des del primer dia. Així és més fàcil:

Conciliar les dades de Didit amb la teva base de dades interna.
Carregar en bloc els usuaris històrics mitjançant la importació CSV de la consola abans d’executar cap sessió.
Preservar les relacions quan més endavant migris a Didit per al monitoratge de transaccions.

Regles, convencions i bones pràctiques

Regla	Motiu
Tria un únic identificador canònic per entitat i no el canviïs mai	Els canvis creen una entitat nova i deixen l’historial orfe
Posa un prefix als valors de `vendor_data` segons el tipus d’entitat (`user_...`, `biz_...`)	Evita col·lisions accidentals entre espais de noms al teu propi codi
Mantén els valors de `vendor_data` estables i sensibles a majúscules i minúscules	Didit no normalitza les majúscules i minúscules
Mantén la longitud de `vendor_data` per sota de 128 caràcters	Encaixa bé en els índexs de la base de dades
No exposis mai dades personals en brut	`vendor_data` apareix als webhooks, als registres d’auditoria i a les respostes de l’API

Següents passos

Visió general dels usuaris

Anàlisi detallada de les entitats Usuari i de les seves operacions.

Visió general de les empreses

Anàlisi detallada de les entitats Empresa i de les seves operacions.

Crear sessió

Inicia una verificació per a un vendor_data.

Crear transacció

Envia una transacció vinculada a una entitat.

Visió general

Preus

Fluxos de treball i verificació

Revisió i operacions

Entitats (usuaris i empreses)

Configuració i personalització

Seguretat i compliment

Didit Academy

Recursos

Vinculació de vendor_data: enllaça IDs amb entitats

Què és

Com vincula les coses

Unicitat i àmbit

Què passa si omets `vendor_data`

Exemple: crear una entitat per avançat i després executar sessions

Migració d’identificadors externs

Regles, convencions i bones pràctiques

Següents passos

Visió general dels usuaris

Visió general de les empreses

Crear sessió

Crear transacció

​Què és

​Com vincula les coses

​Unicitat i àmbit

​Què passa si omets vendor_data

​Exemple: crear una entitat per avançat i després executar sessions

​Migració d’identificadors externs

​Regles, convencions i bones pràctiques

​Següents passos

Visió general dels usuaris

Visió general de les empreses

Crear sessió

Crear transacció

Què és

Com vincula les coses

Unicitat i àmbit

Què passa si omets `vendor_data`

Exemple: crear una entitat per avançat i després executar sessions

Migració d’identificadors externs

Regles, convencions i bones pràctiques

Següents passos