Saltar al contenido principal
POST
curl
La API de enlace para el usuario final de la Travel Rule de Didit emite un enlace para que el usuario complete su elección de wallet o de contraparte, y puede enviarlo por correo electrónico a la dirección registrada del usuario. Envía {"channel": "link"} para copiar un enlace, o {"channel": "email"} para intentar también el envío por correo electrónico. Si omites channel, el valor predeterminado es link. El correo electrónico usa la dirección del usuario final registrada en Didit y el idioma de su sesión de verificación, cuando está disponible. No puedes indicar un destinatario arbitrario. La API requiere permiso de escritura sobre las transacciones y una transferencia saliente en AWAITING_COUNTERPARTY, COUNTERPARTY_VASP_NOT_FOUND, COUNTERPARTY_VASP_NOT_REACHABLE, UNCONFIRMED_OWNERSHIP u ON_HOLD. Otros estados devuelven 409; una transacción desconocida o una transferencia inexistente devuelve 404. La respuesta contiene end_user_link, expires_at, emailed_to y email_available. Un nuevo enlace revoca los enlaces abiertos anteriores para el usuario final de esa transferencia. Compártelo solo con el usuario final al que va destinado. Si no existe un correo electrónico registrado, channel: email devuelve 409 con code: end_user_email_missing; en su lugar, solicita channel: link. Si el envío falla, la API sigue devolviendo un enlace utilizable, con emailed_to vacío. email_available indica que existe una dirección, no que la entrega haya tenido éxito. Para la elección explícita del usuario durante la creación, consulta Crear una transacción y la guía de la Travel Rule. Para las acciones sobre transferencias, consulta Actualizar una transferencia.

Autorizaciones

x-api-key
string
header
requerido

La clave de API de tu aplicación, que encontrarás en Developers -> API keys en la Business Console. La clave principal tiene acceso completo. Una clave con nombre puede tener un alcance limitado: ninguno, lectura o escritura por recurso, limitada a algunos flujos o a sesiones aprobadas, a una lista de direcciones IP y a una fecha de caducidad. 401 significa que la clave es incorrecta, se revocó o expiró; 403 significa que no se envió ninguna clave, que la clave no tiene acceso a este recurso o acción, o que la solicitud provino de una dirección fuera de su lista de IP; 404 en una ruta de sesión significa que la sesión está fuera de los flujos o estados de la clave. Una clave sin acceso a contenido multimedia recibe las URL de imágenes, videos y PDF como null, y una clave sin permiso de escritura en sesiones recibe los enlaces y tokens de sesión como null. Consulta https://docs.didit.me/console/api-keys.

Parámetros de ruta

transaction_id
string<uuid>
requerido

UUID estable de Didit de la transacción a la que pertenece la transferencia.

Cuerpo

application/json
channel
enum<string>
predeterminado:link

link devuelve un enlace nuevo; email también intenta enviarlo al correo electrónico del registro de Didit del usuario final.

Opciones disponibles:
link,
email

Respuesta

Respuesta exitosa.

Nuevo enlace para el usuario final. Los enlaces abiertos anteriores de esta transferencia quedan revocados.

expires_at
string<date-time>
requerido

Caducidad del enlace.

emailed_to
string
requerido

Destinatario cuando el envío se realizó correctamente; si no, una cadena vacía. Un fallo del correo sigue devolviendo un enlace utilizable.

email_available
boolean
requerido

Si el usuario final tiene un correo electrónico en su registro de Didit.

Última modificación el 12 de noviembre de 2026