Saltar al contingut principal
POST
curl
L’API d’enllaç per a usuaris finals de la Travel Rule de Didit emet un enllaç perquè l’usuari final completi l’elecció de la seva cartera o contrapart, i pot enviar-lo per correu electrònic a l’adreça registrada. Envia {"channel": "link"} per copiar un enllaç, o {"channel": "email"} per copiar-lo i també intentar l’enviament per correu electrònic. Si omets channel, el valor per defecte és link. El correu electrònic utilitza l’adreça registrada a Didit de l’usuari final i l’idioma de la sessió de verificació quan està disponible. No pots indicar un destinatari arbitrari. L’API requereix accés d’escriptura a les transaccions i una transferència de sortida en AWAITING_COUNTERPARTY, COUNTERPARTY_VASP_NOT_FOUND, COUNTERPARTY_VASP_NOT_REACHABLE, UNCONFIRMED_OWNERSHIP o ON_HOLD. Els altres estats retornen 409; una transacció desconeguda o una transferència inexistent retorna 404. La resposta conté end_user_link, expires_at, emailed_to i email_available. Un enllaç nou revoca els enllaços oberts anteriors per a aquesta transferència. Comparteix-lo només amb l’usuari final previst. Quan no hi ha cap correu electrònic registrat, channel: email retorna 409 amb code: end_user_email_missing; en aquest cas, sol·licita channel: link. Si l’enviament falla, l’API igualment retorna un enllaç utilitzable amb emailed_to buit. email_available indica que existeix una adreça, no que l’enviament s’hagi fet correctament. Per a l’elecció explícita de l’usuari durant la creació, consulta Crea una transacció i la guia de la Travel Rule. Per a accions sobre transferències, consulta Actualitza una transferència.

Autoritzacions

x-api-key
string
header
requerit

La clau d'API de la teva aplicació, des de Developers -> API keys a la Business Console. La clau primària té accés complet. Una clau amb nom pot tenir l'abast limitat: cap, lectura o escriptura per recurs, limitada a determinats fluxos de treball o a sessions aprovades, a una llista d'adreces IP i a una data de caducitat. 401 significa que la clau és incorrecta, revocada o caducada; 403 significa que no s'ha enviat cap clau, que la clau no té accés a aquest recurs o acció, o que la sol·licitud prové d'una adreça fora de la seva llista d'IP; 404 en una ruta de sessió significa que la sessió està fora dels fluxos de treball o estats de la clau. Una clau sense accés a fitxers multimèdia rep els URL d'imatge, vídeo i PDF com a null, i una clau sense permís d'escriptura de sessions rep els enllaços de sessió i els tokens com a null. Consulta https://docs.didit.me/console/api-keys.

Paràmetres de ruta

transaction_id
string<uuid>
requerit

UUID de transacció estable de Didit que posseeix la transferència.

Cos

application/json
channel
enum<string>
predeterminat:link

link retorna un enllaç nou; email també intenta enviar-lo a l'adreça de correu electrònic del registre de Didit de l'usuari final.

Opcions disponibles:
link,
email

Resposta

Resposta satisfactòria.

Nou enllaç per a l'usuari final. Els enllaços oberts anteriors d'aquesta transferència queden revocats.

expires_at
string<date-time>
requerit

Data de caducitat de l'enllaç.

emailed_to
string
requerit

Destinatari quan l'enviament ha reeixit; si no, una cadena buida. Un error en el correu electrònic encara retorna un enllaç utilitzable.

email_available
boolean
requerit

Si l'usuari final té un correu electrònic al seu registre de Didit.

Darrera modificació el 12 de novembre del 2026