Saltar al contingut principal
POST
curl

Resum

Crea explícitament una entitat empresarial abans que s’iniciï cap sessió de Verificació d’empreses (KYB).

Quan s’ha d’utilitzar

  • Precarregar metadades (soci, nivell, identificadors interns) abans de la primera sessió de Verificació d’empreses (KYB).
  • Migrar des d’un altre proveïdor de KYB amb un llistat d’empreses existent.
  • Registre només de transaccions: envia transaccions per a una empresa que has verificat amb un procés fora de línia.

Notes

  • vendor_data és obligatori i únic per aplicació. Els duplicats retornen un error de conflicte: usa PATCH /v3/businesses/{vendor_data}/ per actualitzar-la.
  • Els camps derivats del registre (legal_name, registration_number, country_code) es poden precarregar, però les dades del registre de la primera sessió de Verificació d’empreses (KYB) aprovada els sobreescriuran.
  • Si country_code coincideix amb la llista de països perillosos de la teva aplicació, l’empresa es crea amb l’estat BLOCKED.
  • Emet business.data.updated.

Permisos

El rol ha d’atorgar el permís create:businesses.

Relacionats

Autoritzacions

x-api-key
string
header
requerit

La clau d'API de la teva aplicació, des de Developers -> API keys a la Business Console. La clau primària té accés complet. Una clau amb nom pot tenir l'abast limitat: cap, lectura o escriptura per recurs, limitada a determinats fluxos de treball o a sessions aprovades, a una llista d'adreces IP i a una data de caducitat. 401 significa que la clau és incorrecta, revocada o caducada; 403 significa que no s'ha enviat cap clau, que la clau no té accés a aquest recurs o acció, o que la sol·licitud prové d'una adreça fora de la seva llista d'IP; 404 en una ruta de sessió significa que la sessió està fora dels fluxos de treball o estats de la clau. Una clau sense accés a fitxers multimèdia rep els URL d'imatge, vídeo i PDF com a null, i una clau sense permís d'escriptura de sessions rep els enllaços de sessió i els tokens com a null. Consulta https://docs.didit.me/console/api-keys.

Cos

application/json
vendor_data
string | null

El teu identificador únic per a aquesta empresa (cadena de text lliure, NO un UUID). Opcional però molt recomanable. Quan es proporciona, ha de ser únic entre les empreses no eliminades per a l'aplicació; coincideix exactament amb el valor enviat.

display_name
string | null

Nom descriptiu que es mostra a la consola (té prioritat sobre legal_name per a la visualització a la interfície d'usuari).

Maximum string length: 255

Nom legal oficial de l'empresa.

Maximum string length: 255
registration_number
string | null

Número de registre o de constitució de l'empresa.

Maximum string length: 100
country_code
string | null

País de constitució (ISO 3166-1 alpha-2, p. ex. GB, US).

Maximum string length: 10
status
enum<string>
predeterminat:ACTIVE

Estat inicial del cicle de vida. Per defecte és ACTIVE.

Opcions disponibles:
ACTIVE,
FLAGGED,
BLOCKED
metadata
object | null

Objecte JSON arbitrari que adjuntes a l'empresa. Per defecte és {}.

Resposta

Empresa creada. Es retorna el registre complet de l'empresa (la mateixa estructura que a Obtenir empresa).

Detall complet de l'empresa. Amplia BusinessListItem amb metadades i updated_at.

didit_internal_id
string<uuid>

UUID intern estable de Didit per a aquesta empresa.

vendor_data
string | null

El teu identificador únic per a aquesta empresa (passat en crear sessions). Pot ser nul quan no s'ha proporcionat cap identificador de proveïdor.

display_name
string | null

Nom visible personalitzat definit per tu

Nom legal oficial obtingut del registre mercantil o introduït manualment

registration_number
string | null

Número de registre o de constitució de l'empresa

country_code
string | null

País de constitució (ISO 3166-1 alpha-2, p. ex. GB, US).

effective_name
string | null

Millor nom disponible: display_name si està definit, en cas contrari legal_name

status
enum<string>

Estat del cicle de vida del registre d'empresa (NO és un estat de la sessió). ACTIVE és el valor per defecte, FLAGGED el marca per a atenció manual, BLOCKED impedeix noves sessions per a aquest vendor_data.

Opcions disponibles:
ACTIVE,
FLAGGED,
BLOCKED
session_count
integer

Nombre total de sessions de verificació per a aquesta empresa

approved_count
integer

Nombre de sessions aprovades

declined_count
integer

Nombre de sessions rebutjades

in_review_count
integer

Nombre de sessions en revisió

features
object

Estat agregat per funcionalitat a totes les sessions de KYB d'aquesta empresa. Actualment l'única clau és KYB (l'estat de la comprovació de l'empresa al registre). Valors possibles: Approved, Declined, In Review, Not Finished, Resub Requested.

features_list
object[]

Les mateixes dades que features, com una llista ordenada d'objectes {feature, status}.

last_session_at
string<date-time> | null

Marca de temps de la sessió més recent

first_session_at
string<date-time> | null

Marca de temps de la primera sessió

last_activity_at
string<date-time> | null

Marca de temps de l'activitat més recent (canvi d'estat, actualització de la sessió, etc.)

tags
object[]

Etiquetes assignades a aquesta empresa

created_at
string<date-time>
metadata
object

JSON de metadades personalitzades que has adjuntat a aquesta empresa. Per defecte és {}.

updated_at
string<date-time>
Darrera modificació el 7 de novembre del 2026