Vai al contenuto principale
PUT
curl

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

Tutti i campi sono opzionali; PUT applica un aggiornamento parziale.

is_enabled
boolean
Maximum string length: 255
lei
string
Maximum string length: 20
jurisdiction
string
Maximum string length: 8
name_matching_strictness
enum<string>

CONTAINS accetta un nome le cui parole compaiono tutte nell'altro.

Opzioni disponibili:
NONE,
STRICT,
CONTAINS,
DEFAULT,
FUZZY
confirmation_timeout_hours
integer
Intervallo richiesto: x >= 1
timeout_outcome
enum<string>
Opzioni disponibili:
HOLD,
REJECT,
PROCEED
compliance_email
string<email>

Email di contatto per la compliance per il tuo profilo VASP. La rete Didit mostra il tuo profilo solo dopo che questo indirizzo è stato confermato tramite un link inviato via email (POST /v3/travel-rule/settings/compliance-email/confirmation/); la modifica richiede una nuova conferma.

is_discoverable
boolean

Indica se il tuo profilo VASP può essere elencato nella rete Didit: trovato in GET /v3/travel-rule/vasps/ da altri clienti Didit e raggiunto tramite il canale INTERNAL. L'inserimento nell'elenco richiede inoltre un'applicazione attiva, Travel Rule abilitata, una ragione sociale e un'email di compliance confermata; didit_network indica quali requisiti mancano. Predefinito true.

threshold_amount
string

Stringa decimale, pari o superiore a zero, nella valuta predefinita della tua applicazione. Importo minimo di trasferimento che attiva uno scambio gestito.

ownership_validation_mode
enum<string>

Vedere il campo di risposta con lo stesso nome.

Opzioni disponibili:
FULL,
SIMPLIFIED,
AUTOMATED
simplified_validation_threshold
string

Stringa decimale, pari o superiore a 0.

data_sharing_fields
object

Unito per tipo di entità: un tipo di entità che ometti mantiene la scelta corrente. Una scelta che non soddisfa gli obblighi relativi all'ordinante previsti dal regime della tua jurisdiction (EU TFR o FATF Recommendation 16), inclusa una lista vuota, viene rifiutata con 400.

matching_rules
object

Unito per tipo di entità e per campo al suo interno. Un campo che tale tipo di entità non confronta (ad esempio date_of_birth per company) viene rifiutato con 400.

inbound_auto_accept
boolean
allow_self_declaration
boolean
allow_screenshot_proof
boolean

Se true, il widget di titolarità del wallet offre il caricamento di screenshot come metodo di prova dell'assetto proprietario. Il valore predefinito è true.

auto_wallet_verification
boolean
vasp_attribution_enabled
boolean
counterparty_screening_enabled
boolean

Screening opzionale su sanzioni e notizie negative dei VASP di controparte, fatturato per screening al prezzo di Screening AML per aziende. Se attivo, Didit esegue lo screening della controparte raggiunta da un trasferimento in uscita (riutilizzando uno screening effettuato da meno di 30 giorni) e puoi eseguirne uno con POST /v3/travel-rule/vasps/{vasp_id}/screening/. Il valore predefinito è false: non viene eseguito alcuno screening né addebitato alcun costo.

sunrise_policy
enum<string>

HOLD, REJECT, PROCEED o vuoto per seguire timeout_outcome. Consulta il campo di risposta con lo stesso nome.

Opzioni disponibili:
,
HOLD,
REJECT,
PROCEED
non_responsive_policy
enum<string>

HOLD, REJECT, PROCEED o vuoto per seguire timeout_outcome. Consulta il campo di risposta con lo stesso nome.

Opzioni disponibili:
,
HOLD,
REJECT,
PROCEED
disabled_networks
enum<string>[]

Reti escluse dall'adesione alla piattaforma. Non disabilita le proprie adesioni connesse né effettua il provisioning di reti non disponibili.

Opzioni disponibili:
GTR,
TRUST,
VERIFYVASP,
SYGNA

Risposta

Impostazioni e profilo aggiornati, con la stessa struttura del GET.

is_enabled
boolean

Indica se il flusso gestito di negoziazione Travel Rule è attivo per le transazioni travelRule in uscita su questa applicazione.

jurisdiction
string

Il codice della giurisdizione operativa del tuo VASP. Predefinito "EU". Didit lo mappa nel regime che appone sulle tue transazioni Travel Rule come travel_rule_regime (ad esempio EU o il codice di un paese membro dell'UE diventa eu), su cui le regole di transazione possono basarsi. Gli altri clienti Didit lo vedono come la tua giurisdizione nella directory dei VASP una volta che la rete Didit inserisce il tuo profilo nella directory.

Maximum string length: 8
name_matching_strictness
enum<string>

Il livello di rigore con cui i nomi dei beneficiari devono corrispondere prima che un trasferimento possa raggiungere lo stato COMPLETED. CONTAINS accetta un nome le cui parole compaiono tutte nell'altro.

Opzioni disponibili:
NONE,
STRICT,
CONTAINS,
DEFAULT,
FUZZY
confirmation_timeout_hours
integer

Ore durante le quali un trasferimento AWAITING_COUNTERPARTY può rimanere non confermato prima che il processo periodico di pulizia lo dichiari scaduto. Valore predefinito: 48.

Intervallo richiesto: x >= 1
timeout_outcome
enum<string>

Cosa succede alla transazione sottostante quando un trasferimento scade. Valore predefinito HOLD. sunrise_policy e non_responsive_policy hanno la precedenza quando sono applicabili e configurate.

Opzioni disponibili:
HOLD,
REJECT,
PROCEED
threshold_amount
string

Stringa decimale, nella valuta predefinita della tua applicazione. Importo minimo di trasferimento che attiva uno scambio gestito; i trasferimenti inferiori ad esso si risolvono direttamente in NOT_APPLICABLE. Didit confronta l'importo della transazione convertito nella tua valuta predefinita, o l'importo amount_in_default_currency inviato; quando non è disponibile alcun importo convertito, la soglia non si applica. Il valore predefinito è "0.00" (il TFR dell'UE non applica alcun importo minimo).

ownership_validation_mode
enum<string>

Il livello di prova richiesto per l'assetto proprietario di un wallet. FULL richiede sempre una prova (messaggio firmato, deposito di prova o screenshot verificato), mai la sola dichiarazione dell'utente finale. SIMPLIFIED accetta un'autodichiarazione al di sotto di simplified_validation_threshold e una prova al di sopra. AUTOMATED consente alla rubrica e a prove precedenti di rispondere autonomamente, incluse le autodichiarazioni quando allow_self_declaration è true. Il valore predefinito è AUTOMATED.

Opzioni disponibili:
FULL,
SIMPLIFIED,
AUTOMATED
simplified_validation_threshold
string

Stringa decimale, valore predefinito "0.00". In modalità SIMPLIFIED, un trasferimento inferiore a questo importo (nella valuta della soglia) accetta un'autodichiarazione. Un trasferimento senza importo in tale valuta viene considerato superiore ad essa.

data_sharing_fields
object

I campi che Didit invia al VASP della controparte sui tuoi utenti, per tipo di entità. name e wallet_address vengono sempre inviati, a prescindere da quanto indicato nell'elenco. Un tipo di entità non selezionato condivide tutti i campi. Anche un elenco vuoto è una scelta: condivide solo il nome e il wallet.

matching_rules
object

Il livello di rigore con cui ogni campo dei dati della controparte viene confrontato con quelli in tuo possesso, per tipo di entità. I campi omessi mantengono il valore predefinito. NONE salta il confronto, STRICT richiede esattamente le stesse parole, CONTAINS accetta un valore le cui parole compaiono tutte nell'altro, DEFAULT è la corrispondenza standard per sottoinsieme e FUZZY accetta grafie simili (e, per le date di nascita, giorno e mese invertiti).

La ragione sociale del tuo VASP. Obbligatoria (non vuota) per impostare is_enabled su true.

lei
string

Il tuo Legal Entity Identifier, visibile nella directory dei VASP.

compliance_email
string<email>

Email di contatto per la compliance per il tuo profilo VASP. La rete Didit mostra il tuo profilo solo dopo che questo indirizzo è stato confermato tramite un link inviato via email (POST /v3/travel-rule/settings/compliance-email/confirmation/); la modifica richiede una nuova conferma.

is_discoverable
boolean

Indica se il tuo profilo VASP può essere elencato nella rete Didit: trovato in GET /v3/travel-rule/vasps/ da altri clienti Didit e raggiunto tramite il canale INTERNAL. L'inserimento nell'elenco richiede inoltre un'applicazione attiva, Travel Rule abilitata, una ragione sociale e un'email di compliance confermata; didit_network indica quali requisiti mancano. Predefinito true.

inbound_auto_accept
boolean

Se true, un'indagine TRP in entrata il cui wallet beneficiario è una voce verificata della rubrica con un nome corrispondente viene approvata automaticamente. Se false, tale indagine rimane in ON_HOLD in attesa che tu la approvi o la rifiuti con l'endpoint dell'assetto proprietario. I trasferimenti su canale INTERNAL e successivi al deposito non sono interessati. Il valore predefinito è true.

allow_self_declaration
boolean

Se true, il widget di titolarità del wallet offre l'autodichiarazione come metodo di prova di riserva. Il valore predefinito è true.

allow_screenshot_proof
boolean

Se true, il widget di titolarità del wallet offre il caricamento di screenshot come metodo di prova dell'assetto proprietario. Il valore predefinito è true.

auto_wallet_verification
boolean

Se true, l'invio di un trasferimento Travel Rule in uscita che richiede la prova del controllo del wallet da parte dell'utente finale genera automaticamente una sessione del widget di titolarità del wallet associata alla transazione e la espone nel blocco action_required della transazione. Il valore predefinito è true.

vasp_attribution_enabled
boolean

Se true, un trasferimento Travel Rule in uscita che nessun canale può instradare viene attribuito tramite analisi blockchain: il wallet di destinazione viene ricondotto al VASP che lo possiede, l'entità viene registrata sul trasferimento e nella directory VASP, e i canali vengono rieseguiti una volta con il nome attribuito. Il valore predefinito è true.

counterparty_screening_enabled
boolean

Screening opzionale su sanzioni e notizie negative dei VASP di controparte, fatturato per screening al prezzo di Screening AML per aziende. Se attivo, Didit esegue lo screening della controparte raggiunta da un trasferimento in uscita (riutilizzando uno screening effettuato da meno di 30 giorni) e puoi eseguirne uno con POST /v3/travel-rule/vasps/{vasp_id}/screening/. Il valore predefinito è false: non viene eseguito alcuno screening né addebitato alcun costo.

sunrise_policy
enum<string>

Effetto di un trasferimento scaduto sulla relativa transazione quando la controparte è una voce di directory in una giurisdizione presente in sunrise_jurisdictions, che non applica ancora la Travel Rule: HOLD lo sposta in revisione, REJECT lo rifiuta, PROCEED ne lascia inalterato lo stato. Se vuoto (impostazione predefinita), segue timeout_outcome. Si applica prima di non_responsive_policy.

Opzioni disponibili:
,
HOLD,
REJECT,
PROCEED
sunrise_jurisdictions
string[]
read-only

Sola lettura. I paesi (ISO 3166 alpha-2) che Didit considera in un periodo di entrata in vigore per la Travel Rule (sunrise period), in cui si applica sunrise_policy. Attualmente CO, KH e VN. Qualsiasi altra giurisdizione, nonché una vuota o sconosciuta, segue timeout_outcome.

non_responsive_policy
enum<string>

Effetto di un trasferimento scaduto sulla relativa transazione quando la controparte è una voce di directory la cui capacità di risposta è UNRESPONSIVE: HOLD, REJECT o PROCEED, come per timeout_outcome. Se vuoto (impostazione predefinita), segue timeout_outcome. sunrise_policy si applica per prima se entrambe sono pertinenti.

Opzioni disponibili:
,
HOLD,
REJECT,
PROCEED
travel_address
string

Sola lettura. Il Travel Address del tuo VASP: l'endpoint codificato per le richieste TRP in entrata utilizzato dagli altri VASP per contattarti. Vuoto finché is_enabled è false.

disabled_networks
enum<string>[]

Reti escluse dall'adesione alla piattaforma. Non disabilita le proprie adesioni connesse né effettua il provisioning di reti non disponibili.

Opzioni disponibili:
GTR,
TRUST,
VERIFYVASP,
SYGNA
networks
object
read-only

Per ciascuna rete, come questa applicazione invierebbe e perché non può farlo. Nessuna rete, inclusa GTR, è inclusa per impostazione predefinita: una rete è raggiungibile tramite la tua adesione connessa, oppure tramite l'adesione di Didit una volta che l'adesione di Didit a tale rete è attiva e il tuo partecipante su di essa è attivo. Non si tratta di un controllo di stato o consegna in tempo reale.

didit_network
object
read-only

Indica se la rete Didit elenca il tuo profilo VASP, in modo che altri clienti Didit possano trovarlo nella directory e raggiungerlo sul canale INTERNAL, e ciascuna condizione che ancora non soddisfa.

Ultima modifica il 7 novembre 2026