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
wallet_address
string

L'indirizzo del wallet da verificare. Facoltativo; se vuoto, l'indirizzo deve essere fornito all'avvio di una prova.

Maximum string length: 128
chain
string

Token della blockchain per l'indirizzo, ad esempio ETH, BTC o SOL. Usa lo stesso token presente nella rubrica del tuo wallet. La firma del messaggio e il Satoshi test sono offerti solo per una blockchain supportata. La voce della rubrica verificata dalla prova memorizza il token sotto il suo identificatore canonico (ETH, BTC, SOL, TRX).

Maximum string length: 32
holder_name
string

Nome del titolare del wallet, utilizzato per la corrispondenza del nome del beneficiario.

Maximum string length: 255
vendor_data
string

Il tuo identificatore interno per il titolare, trasferito nella voce della rubrica creata.

Maximum string length: 255
transaction_id
string<uuid> | null

Opzionale. UUID della transazione Didit di un trasferimento Travel Rule da far avanzare quando la prova viene verificata.

satoshi_deposit_address
string

Opzionale. Un indirizzo di deposito sotto il tuo controllo; fornirlo abilita il metodo di prova SATOSHI_TEST.

Maximum string length: 128
callback_url
string

Opzionale. URL assoluto http(s) a cui il widget reindirizza il cliente al completamento.

Maximum string length: 512
expires_in_minutes
integer
predefinito:60

Opzionale. Durata del link generato, in minuti. Estesa automaticamente per coprire l'intervallo temporale del test di Satoshi quando viene offerto SATOSHI_TEST.

Intervallo richiesto: 5 <= x <= 10080

Risposta

La sessione del widget emessa.

widget_session_id
string<uuid>
token
string

Token di sessione opaco incorporato nell'URL del widget.

url
string

L'URL del widget ospitato per la titolarità del wallet. Aprilo esattamente com'è nel browser di sistema (mai all'interno di una webview dell'SDK mobile).

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