Vai al contenuto principale
POST
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
beneficiary_wallet_address
string
obbligatorio

L'indirizzo del wallet di destinazione. Il Test VASP di Didit invia verso questo indirizzo, confrontandolo con la rubrica dei wallet dell'asset sulla relativa blockchain. Un wallet senza una voce corrispondente viene accettato e la transazione in entrata viene registrata con stato ON_HOLD.

scenario
enum<string>
predefinito:accept

Cosa dichiara il Didit Test VASP in merito al beneficiario. accept dichiara il nome effettivo del titolare; name_mismatch dichiara un nome con cui nessun titolare concorda. La decisione finale spetta sempre a te.

Opzioni disponibili:
accept,
name_mismatch
chain
string
predefinito:ETH

Chain dell'asset.

amount
string
predefinito:1

Importo come stringa decimale.

currency
string
predefinito:ETH

Codice dell'asset.

reference
string

Chiave di idempotenza opzionale. Una ripetizione con lo stesso valore restituisce il trasferimento prenotato dalla prima chiamata.

Risposta

Il trasferimento in entrata è stato registrato e deciso. Una ripetizione con lo stesso reference restituisce il medesimo corpo.

transaction_id
string<uuid>

UUID della transazione Didit per il trasferimento in entrata.

txn_id
string

txn_id generato da Didit.

scenario
string

Lo scenario eseguito.

travel_rule_status
string

Lo stato stabilito dalla decisione della tua applicazione.

detail
string

Il motivo per cui il trasferimento si è risolto in tale stato.

test_vasp
boolean

Sempre true: il mittente era il Didit Test VASP.

travel_rule
object

Oggetto di trasferimento completo restituito dagli endpoint di conferma della titolarità e di completamento/annullamento. Finché la titolarità del wallet di un trasferimento in entrata non è confermata, i campi originator_data e beneficiary_data della controparte vengono restituiti mascherati (viene mantenuta la prima lettera di ogni parola; il wallet, la chain e l'instradamento VASP rimangono leggibili) e data_masked è true.

Ultima modifica il 7 novembre 2026