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

Chain su cui è stato regolato il deposito, ad esempio ETH. Memorizzata in minuscolo e confrontata senza distinzione tra maiuscole e minuscole con le voci della tua rubrica dei wallet, quindi usa lo stesso token di chain anche lì.

Maximum string length: 32
txid
string
obbligatorio

Hash della transazione on-chain. Deduplicato insieme a wallet_address.

Maximum string length: 128
wallet_address
string
obbligatorio

Il wallet di destinazione su cui hai ricevuto il deposito. Un X-address XRP viene suddiviso nel relativo indirizzo classico e tag.

Maximum string length: 128
amount
string
obbligatorio

Importo del deposito come stringa decimale, pari a zero o superiore, con un massimo di 18 cifre decimali.

currency
string
obbligatorio

Asset di deposito, ad es. "USDC".

Maximum string length: 16
originator_data
object

Dettagli dell'ordinante forniti dal VASP mittente, se noti, sotto forma di oggetto piatto come {"name": "..."}. Didit legge da esso name (o full_name), first_name, last_name e vendor_data.

beneficiary_data
object

Dettagli del beneficiario (il tuo cliente), come oggetto piatto ad esempio {"name": "..."}. Didit confronta name con holder_name della voce corrispondente nella rubrica e imposta wallet_address e chain a partire dalla richiesta.

originating_vasp
object

Descrizione opzionale del VASP mittente. Rimane solo su questo trasferimento (metadata.originating_vasp, e il VASP ordinante del trasferimento in GET /v3/travel-rule/transfers/); non crea, modifica o collega mai una voce condivisa della directory VASP.

memo
string

Opzionale. Il destination tag o memo del deposito su una rete con memo: su un indirizzo di deposito condiviso è ciò che distingue i tuoi clienti, e viene associata la voce della rubrica corrispondente a quel memo. XRP: un destination tag, un numero intero da 0 a 4294967295 (è accettato un numero JSON). XLM: un memo testuale fino a 28 byte, un ID a 64 bit o un hash a 32 byte in formato esadecimale. EOS: fino a 256 byte. ATOM: fino a 256 caratteri. HBAR: fino a 100 byte. I wallet Bitcoin, EVM, Solana, Tron, Litecoin, Bitcoin Cash, Dogecoin e Lightning non accettano memo: inserirne uno restituisce un 400. Alias: destinationTag o destination_tag.

Maximum string length: 256
utxo
object

Opzionale, solo per blockchain UTXO. Gli input e gli output della transazione di deposito: il wallet del mittente è il originator_data.wallet_address dichiarato, altrimenti l'input maggiore.

Risposta

Un trasferimento per questo txid e wallet_address era già registrato; quello esistente viene restituito invariato (created è false).

transaction_id
string<uuid>

UUID della transazione Didit per il deposito in entrata.

txn_id
string

txn_id della transazione in entrata: generato da Didit quando Didit ha creato la transazione, oppure il tuo quando è stato riutilizzato un deposito non reclamato.

created
boolean

true quando questa chiamata ha registrato il trasferimento (HTTP 201); false quando esisteva già un trasferimento per gli stessi txid e wallet_address (HTTP 200).

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