Vai al contenuto principale
POST
curl
L’API dei link per l’utente finale della Travel Rule di Didit emette un link che consente all’utente di completare la scelta del wallet o della controparte e può inviarlo via email all’indirizzo registrato. Invia {"channel": "link"} per copiare un link, oppure {"channel": "email"} per copiarlo e tentare anche l’invio via email. Se ometti channel, il valore predefinito è link. L’email usa l’indirizzo dell’utente finale registrato in Didit e, quando disponibile, la lingua della sua sessione di verifica. Non puoi indicare un destinatario arbitrario. L’API richiede l’accesso in scrittura alle transazioni e un trasferimento in uscita in stato AWAITING_COUNTERPARTY, COUNTERPARTY_VASP_NOT_FOUND, COUNTERPARTY_VASP_NOT_REACHABLE, UNCONFIRMED_OWNERSHIP o ON_HOLD. Negli altri stati la risposta è 409; una transazione sconosciuta o un trasferimento mancante restituisce 404. La risposta contiene end_user_link, expires_at, emailed_to e email_available. Un nuovo link revoca i link precedenti per l’utente finale ancora aperti per quel trasferimento. Condividilo solo con l’utente finale previsto. Se non esiste un’email registrata, channel: email restituisce 409 con code: end_user_email_missing; usa invece channel: link. Se l’invio fallisce, l’API restituisce comunque un link utilizzabile con emailed_to vuoto. email_available indica che esiste un indirizzo, non che l’invio sia riuscito. Per la scelta esplicita dell’utente durante la creazione, consulta Crea una transazione e la guida alla Travel Rule. Per le azioni sul trasferimento, consulta Aggiorna un trasferimento.

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.

Parametri del percorso

transaction_id
string<uuid>
obbligatorio

UUID della transazione stabile di Didit a cui appartiene il trasferimento.

Corpo

application/json
channel
enum<string>
predefinito:link

link restituisce un nuovo link; email tenta anche di inviarlo all'indirizzo email del record Didit dell'utente finale.

Opzioni disponibili:
link,
email

Risposta

Risposta riuscita.

Nuovo link per l'utente finale. I link aperti precedenti per questo trasferimento vengono revocati.

expires_at
string<date-time>
obbligatorio

Scadenza del link.

emailed_to
string
obbligatorio

Destinatario quando l'invio è riuscito, altrimenti una stringa vuota. Un errore nell'invio dell'email restituisce comunque un link utilizzabile.

email_available
boolean
obbligatorio

Se l'utente finale ha un'email nel proprio record Didit.

Ultima modifica il 12 novembre 2026