Saltar al contenido principal
POST
curl

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

Envíalo como JSON, o como multipart/form-data con los archivos adjuntos en files.

kind
enum<string>
predeterminado:MESSAGE
Opciones disponibles:
MESSAGE,
DOCUMENT_REQUEST
body
string

Obligatorio para un MESSAGE salvo que se adjunte un archivo.

Maximum string length: 5000
requested_documents
string[]

Obligatorio (al menos uno) para un DOCUMENT_REQUEST, y solo se permite ahí.

Maximum array length: 10
Maximum string length: 255
reply_to
string<uuid> | null

Un mensaje de la misma transferencia. Una respuesta que incluye un documento atiende la solicitud de documento a la que responde.

files
file[]

Solo multipart. Hasta 5 archivos de 10 MB cada uno.

Maximum array length: 5

Respuesta

El mensaje almacenado.

id
string<uuid>
kind
enum<string>
Opciones disponibles:
MESSAGE,
DOCUMENT_REQUEST
direction
enum<string>

OUTBOUND es lo que envió el propio lado de quien lee. En el portal de recogida, la dirección se considera desde el lado de la contraparte.

Opciones disponibles:
INBOUND,
OUTBOUND
author
string

Quién lo escribió en su propio lado: el correo electrónico de un usuario de la consola o la etiqueta de una clave de API, o el nombre del otro VASP.

body
string
requested_documents
string[]

Qué pide un DOCUMENT_REQUEST, en palabras del solicitante.

reply_to
string<uuid> | null
fulfilled_at
string<date-time> | null

Se establece en un DOCUMENT_REQUEST cuando una respuesta a esa solicitud incluye un documento.

attachment
object | null

El documento adjunto a un mensaje, almacenado como cualquier otro documento de transacción.

created_at
string<date-time>
Última modificación el 1 de noviembre de 2026