API de Verificació Empresarial: Registre, UBO, Directius i AML per 2 $ (CA)

Conèixer els vostres clients individuals és només la meitat de la història. En el moment que incorporeu un negoci —un comerciant, un venedor de marketplace, un compte corporatiu, un VASP contrapart— heu de respondre a un conjunt de preguntes més difícils. És una empresa real i registrada? Qui la posseeix realment? Qui pot actuar en nom seu? I hi ha algú darrere que estigui en una llista de sancions o de vigilància? Know Your Business (KYB) és la disciplina que respon a aquestes quatre preguntes, i històricament ha significat extreure registres manualment, perseguir documents d'accionistes per correu electrònic i passar noms per una eina de filtratge separada.

L'API de Verificació Empresarial de Didit ho col·lapsa en una única sessió. Creeu una sessió KYB i us retorna dades de registre verificades, identifica els beneficiaris finals (UBOs) i els directius, i filtra l'entitat contra llistes de vigilància globals —tot a través de l'API unificada /v3/, per 2,00 $ per verificació d'empresa sense mínims.

Aquesta guia explica què conté una sessió KYB, com es tarifa i com integrar-la.

Punts clau

• Una sessió, quatre comprovacions. Una única sessió KYB agrupa kyb_registry, kyb_company_aml, kyb_documents i kyb_key_people —consulta de registre, AML d'entitat, verificació de documents i identificació de beneficiaris.
• 2,00 $ per empresa. La verificació completa —registre + identificació UBO + filtratge de directius + AML d'entitat— té un preu únic, facturat per empresa, sense mínims.
• SKU desagregats. Només necessiteu una part? El filtratge AML de l'empresa costa 0,20 $ per comprovació, els documents KYB costen 0,20 $ per document, i l'extracció de Persones Clau (UBOs + directius) és gratuïta —només pagueu les tarifes de Verificació d'Usuaris quan executeu KYC vinculat en un UBO.
• Dades de registre reals. Nom de l'empresa, número de registre, país, estat, tipus, data de constitució, adreça registrada i número d'identificació fiscal, extrets de registres oficials.
• Bucle tancat, únic de Didit. Una sessió KYB pot generar una sessió KYC vinculada per a cada UBO a la mateixa API /v3/ —incorporeu l'empresa i verifiqueu els humans darrere en un sol flux.
• Gestionable. Una API de gestió completa i els webhooks business.status.updated / business.data.updated mantenen els vostres registres sincronitzats.

Què fa la verificació empresarial

Una comprovació KYB confirma que un negoci existeix, està en bon estat i està controlat per les persones que creieu que el controlen. El model de sessió de Didit ho divideix en quatre característiques, cadascuna amb el seu propi estat perquè sempre sapigueu exactament on es troba una verificació:

• kyb_registry — cerca l'empresa al registre oficial i retorna el seu registre principal: nom legal, número de registre, país, estat, tipus d'entitat, data de constitució, adreça registrada i número d'identificació fiscal.
• kyb_company_aml — filtra l'empresa mateixa contra sancions, llistes de vigilància i fonts de mitjans adversos a nivell d'entitat.
• kyb_documents — recull i llegeix documents de suport (certificat de constitució, estatuts, prova d'adreça, financials) amb OCR i una comprovació de manipulació.
• kyb_key_people — extreu les persones importants: UBOs amb percentatges de propietat, accionistes, directors, directius i representants —incloent capes de propietat corporativa niades.

Cada característica té un d'aquests estats: NOT_FINISHED, APPROVED, DECLINED, IN_REVIEW, RESUB_REQUESTED o AWAITING_USER.

Per què és important

Les empreses regulades estan obligades a verificar els negocis que serveixen, identificar els beneficiaris finals per sobre del llindar de propietat i filtrar les entitats i els seus controladors contra les llistes de sancions. Les directives AML de la UE, la Llei de Transparència Corporativa dels EUA i els règims equivalents a tot el món converteixen el KYB d'un desitjable en un requisit legal —i les sancions per incorporar una empresa fantasma o una entitat sancionada són greus.

El problema operatiu és igualment real. La majoria dels equips munten el KYB a partir d'un proveïdor de dades de registre, un procés manual de recollida de documents i una eina de filtratge separada, i després uneixen el gràfic d'UBO en un full de càlcul. Didit col·lapsa aquesta pila en una sessió i una consola —registre, propietat, documents i filtratge al mateix lloc, amb un preu per empresa perquè el cost s'ajusti al volum d'incorporació en lloc de les llicències de seient.

Detalls tècnics

Una verificació KYB es crea de la mateixa manera que qualsevol altra sessió de Didit: feu un POST a /v3/session/ amb un flux de treball que tingui les característiques KYB habilitades.

curl -X POST https://verification.didit.me/v3/session/ \
  -H "x-api-key: $DIDIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow_id": "your_kyb_workflow_id",
    "vendor_data": "merchant_8842",
    "callback": "https://yourapp.com/kyb/callback"
  }'

La sessió es resol en un resultat estructurat amb el registre, les persones clau i els estats de les característiques:

{
  "session_id": "kyb_5f2a90c1",
  "status": "APPROVED",
  "vendor_data": "merchant_8842",
  "kyb_registry": {
    "status": "APPROVED",
    "company_name": "Acme Logistics S.L.",
    "registration_number": "B12345678",
    "country": "ES",
    "company_status": "ACTIVE",
    "company_type": "LIMITED_LIABILITY",
    "incorporation_date": "2019-03-14",
    "registered_address": "Calle Mayor 1, 28013 Madrid, ES",
    "tax_number": "ESB12345678"
  },
  "kyb_company_aml": { "status": "APPROVED" },
  "kyb_documents": { "status": "APPROVED" },
  "kyb_key_people": {
    "status": "APPROVED",
    "ubos": [
      { "name": "María García", "ownership_percentage": 55.0 },
      { "name": "Holdco Ventures B.V.", "ownership_percentage": 45.0, "is_corporate": true }
    ]
  }
}

Estats de la sessió. La sessió general passa per NOT_STARTED, IN_PROGRESS, APPROVED, DECLINED, IN_REVIEW, RESUBMITTED, ABANDONED i EXPIRED.

Webhooks. Subscriviu-vos a status.updated i data.updated (amb session_kind de "business") per mantenir el vostre registre sincronitzat a mesura que avança la verificació i s'enriqueixen les dades.

Preu. 2,00 $ per verificació d'empresa per al paquet complet. Desagregat: AML d'empresa 0,20 $ per comprovació, documents KYB 0,20 $ per document, extracció de Persones Clau gratuïta, i KYC vinculat en un UBO facturat a les tarifes estàndard de Verificació d'Usuaris.

Què inclou la verificació

Consulta de registre (kyb_registry). El registre autoritzat —nom legal, número de registre, país, estat actual, tipus d'entitat, data de constitució, adreça registrada i número d'identificació fiscal— extret de la font oficial en lloc de l'autodeclarat pel sol·licitant.

Persones clau (kyb_key_people). La imatge completa del control: UBOs amb els seus percentatges de propietat, accionistes, directors, directius i representants. Quan la propietat passa per altres empreses, Didit resol les capes corporatives niades perquè pugueu veure qui controla finalment l'entitat.

AML d'empresa (kyb_company_aml). Filtratge a nivell d'entitat contra sancions, llistes de vigilància i fonts de mitjans adversos —perquè una empresa que estigui sancionada o reportada adversament mai passi desapercebuda només per haver verificat els seus directius.

Documents (kyb_documents). Els documents de suport es recullen, es llegeixen amb OCR i es passen per una comprovació de manipulació, de manera que un certificat de constitució o una prova d'adreça es verifica, no només s'arxiva.

Casos d'ús

• Els mercats en línia que incorporen venedors empresarials verifiquen que el venedor és una empresa real, en bon estat, i identifiquen les persones darrere abans que comencin els pagaments.
• Les plataformes de fintech i banca que obren comptes corporatius executen registre, UBO i AML d'entitat en una sola sessió per complir les obligacions KYB.
• Els proveïdors de préstecs que avaluen prestataris empresarials confirmen la constitució, la propietat i l'estat abans d'atorgar crèdit.
• Les plataformes Crypto B2B que incorporen VASPs contrapart i clients corporatius verifiquen l'entitat i la filtren contra sancions en una sola trucada.

Com integrar-se amb Didit

1. Construïu el flux de treball. A la Consola Empresarial, creeu un flux de treball amb les característiques KYB que necessiteu —registre, AML d'empresa, documents, persones clau— i activeu el KYC vinculat per als UBOs si també voleu verificar els humans.
2. Creeu la sessió. POST /v3/session/ amb el vostre workflow_id de KYB i una referència vendor_data que vincula la verificació al vostre registre comercial intern.
3. Gestioneu els webhooks. Escolteu status.updated i data.updated (session_kind: business) per reaccionar a mesura que la verificació es completa i s'enriqueixen les dades.
4. Gestioneu l'entitat. Utilitzeu l'API de gestió — POST /v3/businesses/create/, GET /v3/businesses/, GET /v3/businesses/{vendor_data}/, i PATCH .../update-status/ — per rastrejar i actualitzar cada negoci com ACTIVE, FLAGGED o BLOCKED.

Com que tot està a l'API unificada /v3/, una sessió KYB pot generar les sessions KYC per als seus UBOs, aquestes persones passen a la monitorització contínua, i una transacció marcada pot generar una comprovació de remei —una plataforma d'identitat i frau, de principi a fi.

Preguntes freqüents

Quant costa la verificació empresarial?

2,00 $ per empresa per a la verificació completa —consulta de registre, identificació d'UBO, filtratge de directius i AML d'entitat. També podeu comprar les parts: AML d'empresa per 0,20 $ per comprovació, documents KYB per 0,20 $ per document, i extracció de Persones Clau gratuïta, amb KYC d'UBO vinculat facturat a les tarifes estàndard de Verificació d'Usuaris.

Quines dades de registre rebo?

Nom de l'empresa, número de registre, país, estat de l'empresa, tipus d'entitat, data de constitució, adreça registrada i número d'identificació fiscal —extrets del registre oficial.

Pot identificar els beneficiaris finals?

Sí. La característica kyb_key_people extreu els UBOs amb els seus percentatges de propietat, a més d'accionistes, directors, directius i representants, resolent capes de propietat corporativa niades pel camí.

Filtra l'empresa contra sancions?

Sí. kyb_company_aml filtra l'entitat mateixa contra sancions, llistes de vigilància i fonts de mitjans adversos a nivell d'empresa.

Puc verificar també les persones que posseeixen l'empresa?

Sí. A l'API unificada /v3/ una sessió KYB pot generar una sessió KYC vinculada per a cada UBO —verificació de bucle tancat de l'entitat i dels humans darrere en un sol flux.

Llest per començar?

Llegiu la visió general de Verificació Empresarial a la documentació, vegeu com s'adapta a la resta de la plataforma a la pàgina del producte de Verificació Empresarial, i comproveu els preus transparents per trucada a la pàgina de preus. Quan estigueu preparats, comenceu gratuïtament —500 comprovacions KYC gratuïtes cada mes, i verificació empresarial per 2,00 $ per empresa.