Vai al contenuto principale
POST
curl
L’API di Didit per la creazione di VASP aggiunge privatamente una controparte alla directory della tua applicazione e, facoltativamente, invia un invito all’indirizzo email di conformità della controparte. Invia name e email. Puoi inoltre fornire lei (20 caratteri alfanumerici), jurisdiction (un codice paese ISO alpha-2 o alpha-3) e invite (il valore predefinito è false). I valori vuoti facoltativi di LEI e giurisdizione sono accettati. L’API richiede l’accesso in scrittura alle transazioni. La risposta 201 è una voce della directory con source: added_by_you. Il contatto di conformità è privato e visibile solo alla tua applicazione. Aggiungere una voce non certifica la sua identità né la rende un membro della rete Didit. Una corrispondenza con un nome visibile o un LEI restituisce 409 con vasp_id; in questo caso seleziona la voce esistente. I campi non validi restituiscono 400. Usa Cerca nella directory VASP per trovare la voce e le rotte disponibili. Usa il suo id con l’azione beneficiary_vasp in Aggiorna un trasferimento. Consulta la guida alla directory per l’instradamento e l’adeguata verifica.

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
name
string
obbligatorio

Nome del VASP, senza spazi iniziali e finali; non può essere vuoto.

Required string length: 1 - 255
email
string<email>
obbligatorio

Email di conformità salvata come contatto privato dell'applicazione e usata per un invito facoltativo.

Maximum string length: 254
lei
string
predefinito:""

LEI facoltativo, normalizzato in maiuscolo.

Pattern: ^([A-Za-z0-9]{20})?$
jurisdiction
string
predefinito:""

Codice paese ISO 3166 alpha-2 o alpha-3 facoltativo, normalizzato in maiuscolo.

Maximum string length: 3
invite
boolean
predefinito:false

Invia un invito all'email indicata.

Risposta

Risposta riuscita.

Un VASP della directory o un membro della rete Didit, con i percorsi a disposizione della tua applicazione per raggiungerlo. Un cliente è membro della rete Didit solo finché la sua applicazione è in produzione, la sua Travel Rule è attiva, il suo profilo è individuabile, possiede una ragione sociale e un'email di compliance confermata, e Didit non ha contrassegnato l'applicazione come test, demo o interna. Ogni riga include inoltre la valutazione condivisa di due diligence (dd_score, risk_level, responsiveness, essential_checks) e la decisione, lo screening dell'entità e i questionari specifici della tua applicazione, che nessun altro cliente può visualizzare.

id
string<uuid>

L'ID della voce, per GET /v3/travel-rule/vasps/{vasp_id}/.

kind
enum<string>

directory per una voce di directory condivisa o privata dell'applicazione; didit per un membro della rete Didit.

Opzioni disponibili:
directory,
didit
name
string
lei
string
jurisdiction
string

Codice paese ISO 3166, così come fornito dalla fonte.

domains
string[]

I domini web del VASP. Sempre vuoto per i membri della rete Didit.

reachable
boolean

Indica se la tua applicazione dispone di una route disponibile verso questo VASP o verso una delle sue entità per un brand. Sempre true per un membro della rete Didit, tranne su un'applicazione sandbox, dove ogni riga è false.

aliases
object[]

Altri nomi con cui viene individuato il VASP.

networks
object[]
routes
object[]
umbrella
object | null

Il brand di cui questa voce è un'entità regolamentata. Null quando non ne fa parte.

entities
object[]

Per un brand, le entità regolamentate che ricevono i suoi trasferimenti. Un trasferimento che menziona il brand va all'entità raggiungibile nella giurisdizione dichiarata (beneficiary_data.counterparty_vasp_jurisdiction), altrimenti all'entità collegata al wallet di destinazione tramite l'attribuzione di analisi blockchain, altrimenti all'unica entità raggiungibile quando non è dichiarata alcuna giurisdizione. In caso di due entità ugualmente compatibili, non viene mai fatta un'ipotesi arbitraria.

contacts
object[]

I contatti della piattaforma per questo VASP e quelli della tua applicazione.

dd_status
enum<string>

Stato di verifica della voce secondo Didit, valutato dalla componente di verifica di dd_score. Sempre COMPLETED per un membro della rete Didit.

Opzioni disponibili:
NOT_STARTED,
IN_PROGRESS,
COMPLETED,
REJECTED
dd_score
integer | null

Il punteggio di due diligence condiviso di una voce dell'elenco, da 0 a 100, dove un valore più alto è più sicuro (vedi dd_score_semantic): la somma dei punti in dd_score_breakdown. Null per un membro della rete Didit, che non viene valutato. Una voce non ancora valutata (dd_assessed_at null) mostra 0 con un risk_level vuoto, quindi leggi risk_level anziché il punteggio grezzo.

Intervallo richiesto: 0 <= x <= 100
reachable_rails
enum<string>[]

Circuiti registrati nella voce. Consulta le route per sapere cosa può utilizzare oggi la tua applicazione.

Opzioni disponibili:
INTERNAL,
TRP,
GTR,
TRUST,
VERIFYVASP,
SYGNA,
EMAIL
is_didit_customer
boolean

true per un membro della rete Didit (per questi dd_status è sempre COMPLETED, dd_score è null e risk_level è vuoto) e per una voce della directory collegata a un cliente Didit.

dd_score_breakdown
object

Un oggetto per componente di dd_score. Componenti, il loro peso (max) e i relativi codici motivo: jurisdiction, 25 (jurisdiction_not_high_risk, jurisdiction_high_risk, jurisdiction_unknown); verification, 15 (dd_status_completed, dd_status_in_progress, dd_status_not_started, dd_status_rejected); protocol, 15 (native_rail, email_only, no_rail); lei, 10 (lei_valid, lei_missing); history, 10 (history, no_history); essentials, 15 (essential_checks, no_essential_checks); responsiveness, 10 (responsive, unresponsive, responsiveness_unknown). Vuoto per un membro della rete Didit.

dd_assessed_at
string<date-time> | null

Data e ora dell'ultimo calcolo di dd_score, risk_level e responsiveness: dopo che uno scambio con la voce viene completato, termina, scade, non corrisponde o viene rifiutato, quando Didit aggiorna o gestisce la voce e durante l'aggiornamento settimanale della directory. Null per un membro della rete Didit.

dd_score_semantic
enum<string>

In quale direzione punta dd_score: sempre higher_is_safer.

Opzioni disponibili:
higher_is_safer
risk_level
enum<string>

La fascia in cui ricade dd_score: LOW (70 o superiore), MEDIUM (da 40 a 69) o HIGH (inferiore a 40). Vuoto per un membro della rete Didit e per una voce non ancora valutata. Puoi filtrarlo con risk. Uno screening contrassegnato da te non modifica mai questo valore condiviso: imposta invece counterparty_risk_level su HIGH nelle tue regole.

Opzioni disponibili:
LOW,
MEDIUM,
HIGH,
responsiveness
object

Indica se il VASP risponde alle richieste Travel Rule: la quota delle richieste avviate dai clienti Didit verso di esso negli ultimi 90 giorni a cui ha risposto. Contano solo le richieste inviate tramite un canale di rete o di protocollo, oppure via email a un indirizzo condiviso (l'indirizzo di compliance della voce o un contatto della piattaforma); una richiesta inviata a un indirizzo digitato da un cliente, o al contatto privato di un cliente, non conta mai. Una richiesta scaduta è considerata senza risposta; uno scambio completato, un rifiuto o una mancata corrispondenza dei dati costituiscono una risposta; una richiesta annullata o un canale irraggiungibile non sono né l'uno né l'altro. Sempre UNKNOWN con conteggi a zero per un membro della rete Didit.

essential_checks
object

Il report dei controlli essenziali di una voce della directory, generato esclusivamente dalle fonti verificate della piattaforma: registrazione (un registro ufficiale include il VASP: il registro provvisorio MiCA dell'UE, la directory pubblica TRISA o il registro globale LEI), licenza (un'autorizzazione MiCA è registrata e in corso di validità), dominio (il dominio della voce corrisponde al relativo endpoint TRP o al sito web indicato nel registro) e lei (il record LEI è attivo, emesso e coerente con i nomi e il paese della voce). La componente essentials di dd_score rappresenta la percentuale dei controlli valutati che sono stati superati. Rimane vuoto finché l'aggiornamento settimanale della directory non controlla per la prima volta la voce, ed è sempre vuoto per i membri della rete Didit.

decision
object | null

La decisione della tua applicazione su questo VASP oppure, per un'entità senza una propria decisione, quella del rispettivo brand (inherited_from indica il brand). Null se assente. Privata per la tua applicazione.

entity_screening
object | null

Lo screening delle sanzioni e notizie negative più recente eseguito dalla tua applicazione su questo VASP. Null se non è mai stato sottoposto a screening. Privato per la tua applicazione.

questionnaires
object[]

I questionari di due diligence della tua applicazione con questo VASP, dal più recente al meno recente. Privati per la tua applicazione.

source
enum<string>

directory per una voce di directory condivisa, added_by_you per una voce privata della tua applicazione, oppure didit_network per una voce di directory collegata a un cliente Didit. I risultati di membri separati con kind=didit possono non includere questo campo; usa kind per identificarli.

Opzioni disponibili:
didit_network,
directory,
added_by_you
Ultima modifica il 12 novembre 2026