Gestió d'empreses KYB: operacions CRUD via API

Tota la gestió de l’entitat d’empresa es fa a través de sis endpoints públics sota /v3/businesses/. Aquesta pàgina ofereix una visió conceptual: consulta la referència de l’API per veure els esquemes complets de sol·licitud i resposta.

Llistar empreses

GET /v3/businesses/ Llista paginada d’empreses de la vostra aplicació, amb filtres per estat, cerca, país i interval de dates.

curl -G https://verification.didit.me/v3/businesses/ \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "status=ACTIVE" \
  --data-urlencode "country_code=GBR" \
  --data-urlencode "page_size=50"

Obtenir una empresa

GET /v3/businesses/{vendor_data}/ Recupera una única empresa pel seu vendor_data.

curl https://verification.didit.me/v3/businesses/biz-acme/ \
  -H "x-api-key: YOUR_API_KEY"

Crear una empresa

POST /v3/businesses/create/ Crea prèviament una empresa abans que s’executi cap sessió de Verificació d’empreses (KYB):

curl -X POST https://verification.didit.me/v3/businesses/create/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "vendor_data": "biz-acme",
    "display_name": "Acme Corp",
    "country_code": "GBR",
    "metadata": { "partner": "Acme Holdings" }
  }'

Retorna un error de conflicte si ja existeix una empresa amb aquest vendor_data. Utilitza PATCH per actualitzar una empresa existent.

Actualitzar una empresa

PATCH /v3/businesses/{vendor_data}/ Actualitza els camps de perfil modificables. Els camps derivats de consultes al registre mercantil (legal_name, registration_number, country_code) són de només lectura després de la verificació, però es poden sobreescriure; les sobreescriptures queden marcades al registre d’auditoria. Camps modificables: display_name, metadata, tags. Només de lectura després de la verificació: tots els camps derivats del registre, els comptadors agregats i el mapa features.

curl -X PATCH https://verification.didit.me/v3/businesses/biz-acme/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "metadata": { "tier": "enterprise" } }'

Emet business.data.updated.

Canviar l’estat

PATCH /v3/businesses/{vendor_data}/update-status/ Mou una empresa entre ACTIVE, FLAGGED i BLOCKED.

curl -X PATCH https://verification.didit.me/v3/businesses/biz-acme/update-status/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "BLOCKED",
    "reason": "Sanctioned subsidiary detected in ownership chain"
  }'

De → a	Desencadenant habitual
`ACTIVE` → `FLAGGED`	Sessió de Verificació d’empreses (KYB) que passa a `In Review`, alerta en el monitoratge AML continu, regla de transaccions
`ACTIVE` → `BLOCKED`	Entitat confirmada com a sancionada, entrada manual a la llista de bloqueig
`FLAGGED` → `ACTIVE`	L’analista ha descartat el motiu de la revisió
`BLOCKED` → `ACTIVE`	Desbloqueig manual després de la remediació

Emet business.status.updated.

Eliminar empreses (per lots)

POST /v3/businesses/delete/ Elimina una o més empreses. Els registres de les empreses s’eliminen de manera permanent. Les seves sessions de verificació no estan cobertes per aquest endpoint i es conserven, però se’ls esborra l’enllaç amb l’empresa; elimina-les amb Eliminar sessió. Les transaccions tampoc no es cobreixen; elimina-les des de la Business Console.

curl -X POST https://verification.didit.me/v3/businesses/delete/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "vendor_data": ["biz-acme", "biz-alpha", "biz-beta"] }'

Idempotent: eliminar una empresa que ja ha estat eliminada no té cap efecte.

Model de permisos

Tots els endpoints /v3/businesses/* s’acoten pel recurs de permís businesses:

Rol	list	get	create	update	update-status	delete
OWNER	✅	✅	✅	✅	✅	✅
ADMIN	✅	✅	✅	✅	✅	✅
COMPLIANCE_OFFICER	✅	✅	❌	✅	✅	❌
DEVELOPER	✅	✅	✅	❌	❌	❌
READER	✅	✅	❌	❌	❌	❌

Consulta Rols i permisos.

Webhooks emesos per aquestes operacions

Operació	Webhook
`create`	`business.data.updated`
`update`	`business.data.updated` amb `changed_fields`
`update-status`	`business.status.updated`
`delete`	`business.data.updated` amb `deleted_at` definit

Següents passos

Model de dades

Referència completa dels camps.

API de llistat

Esquema de GET /v3/businesses/.

API de creació

Esquema de POST /v3/businesses/create/.

Darrera modificació el 7 de novembre del 2026

Visió general

Preus

Fluxos de treball i verificació

Revisió i operacions

Entitats (usuaris i empreses)

Configuració i personalització

Seguretat i compliment

Didit Academy

Recursos

Gestió d'empreses KYB: operacions CRUD via API

Llistar empreses

Obtenir una empresa

Crear una empresa

Actualitzar una empresa

Canviar l’estat

Eliminar empreses (per lots)

Model de permisos

Webhooks emesos per aquestes operacions

Següents passos

Model de dades

API de llistat

API de creació

​Llistar empreses

​Obtenir una empresa

​Crear una empresa

​Actualitzar una empresa

​Canviar l’estat

​Eliminar empreses (per lots)

​Model de permisos

​Webhooks emesos per aquestes operacions

​Següents passos

Model de dades

API de llistat

API de creació

Llistar empreses

Obtenir una empresa

Crear una empresa

Actualitzar una empresa

Canviar l’estat

Eliminar empreses (per lots)

Model de permisos

Webhooks emesos per aquestes operacions

Següents passos