Vai al contenuto principale
POST
curl

Panoramica

Crea esplicitamente un’entità azienda prima dell’esecuzione di qualsiasi sessione di Verifica aziendale (KYB).

Quando usarlo

  • Pre-caricare i metadati (partner, livello, identificativi interni) prima della prima sessione di Verifica aziendale (KYB).
  • Migrare da un altro fornitore KYB con un elenco di aziende esistente.
  • Registrazione solo per le transazioni: invia le transazioni per un’azienda che hai verificato con un processo offline.

Note

  • vendor_data è obbligatorio e deve essere univoco per applicazione. I duplicati restituiscono un errore di conflitto: usa PATCH /v3/businesses/{vendor_data}/ per aggiornare.
  • I campi derivati dal registro (legal_name, registration_number, country_code) possono essere pre-caricati, ma verranno sovrascritti dai dati del registro della prima sessione di Verifica aziendale (KYB) approvata.
  • Se country_code corrisponde all’elenco dei paesi pericolosi della tua applicazione, l’azienda viene creata con stato BLOCKED.
  • Emette business.data.updated.

Autorizzazioni

Il ruolo deve concedere create:businesses.

Correlati

Autorizzazioni

x-api-key
string
header
obbligatorio

La chiave API della tua applicazione, da Developers -> API keys nella Business Console. La chiave primaria ha accesso completo. Una chiave con nome può avere un ambito definito: nessuno, lettura o scrittura per risorsa, limitata ad alcuni workflow o a sessioni approvate, a un elenco di indirizzi IP e a una data di scadenza. 401 indica che la chiave è errata, revocata o scaduta; 403 indica che non è stata inviata alcuna chiave, che la chiave non ha accesso a questa risorsa o azione, oppure che la richiesta proviene da un indirizzo non incluso nel suo elenco IP; 404 su una route di sessione indica che la sessione non rientra nei workflow o negli stati previsti dalla chiave. Una chiave senza accesso ai media riceve gli URL di immagini, video e PDF come null, e una chiave senza permessi di scrittura sulle sessioni riceve link e token di sessione come null. Consulta https://docs.didit.me/console/api-keys.

Corpo

application/json
vendor_data
string | null

Il tuo identificatore univoco per questa azienda (stringa a formato libero, NON un UUID). Facoltativo ma fortemente consigliato. Quando fornito, deve essere univoco tra le aziende non eliminate per l'applicazione; confrontato esattamente come inviato.

display_name
string | null

Nome descrittivo mostrato nella console (ha la precedenza su legal_name per la visualizzazione dell'interfaccia utente).

Maximum string length: 255

Denominazione legale ufficiale dell'azienda.

Maximum string length: 255
registration_number
string | null

Numero di registrazione o costituzione dell'azienda.

Maximum string length: 100
country_code
string | null

Paese di costituzione (ISO 3166-1 alpha-2, ad es. GB, US).

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

Stato iniziale del ciclo di vita. Il valore predefinito è ACTIVE.

Opzioni disponibili:
ACTIVE,
FLAGGED,
BLOCKED
metadata
object | null

Oggetto JSON arbitrario da allegare all'azienda. Il valore predefinito è {}.

Risposta

Azienda creata. Restituisce il record aziendale completo (stessa struttura di Get Business).

Dettagli completi dell'azienda. Estende BusinessListItem con metadati e updated_at.

didit_internal_id
string<uuid>

UUID interno stabile di Didit per questa azienda.

vendor_data
string | null

Il tuo identificatore univoco per questa azienda (passato durante la creazione delle sessioni). Può essere null se non è stato fornito alcun identificatore del fornitore.

display_name
string | null

Nome visualizzato personalizzato impostato da te

Denominazione legale ufficiale dal registro o inserimento manuale

registration_number
string | null

Numero di registrazione o costituzione dell'azienda

country_code
string | null

Paese di costituzione (ISO 3166-1 alpha-2, ad es. GB, US).

effective_name
string | null

Miglior nome disponibile: display_name se impostato, altrimenti legal_name

status
enum<string>

Stato del ciclo di vita del record aziendale (NON uno stato della sessione). ACTIVE è il valore predefinito, FLAGGED lo contrassegna per una verifica manuale, BLOCKED impedisce nuove sessioni per questo vendor_data.

Opzioni disponibili:
ACTIVE,
FLAGGED,
BLOCKED
session_count
integer

Numero totale di sessioni di verifica per questa azienda

approved_count
integer

Numero di sessioni approvate

declined_count
integer

Numero di sessioni rifiutate

in_review_count
integer

Numero di sessioni in revisione

features
object

Stato aggregato per funzionalità in tutte le sessioni KYB di questa azienda. Attualmente l'unica chiave è KYB (lo stato del controllo aziendale nel registro). Valori possibili: Approved, Declined, In Review, Not Finished, Resub Requested.

features_list
object[]

Gli stessi dati di features, sotto forma di array ordinato di oggetti {feature, status}.

last_session_at
string<date-time> | null

Timestamp della sessione più recente

first_session_at
string<date-time> | null

Timestamp della prima sessione

last_activity_at
string<date-time> | null

Timestamp dell'attività più recente (cambio di stato, aggiornamento della sessione, ecc.)

tags
object[]

Tag assegnati a questa azienda

created_at
string<date-time>
metadata
object

JSON di metadati personalizzati che hai allegato a questa azienda. Il valore predefinito è {}.

updated_at
string<date-time>
Ultima modifica il 7 novembre 2026