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.

Cuerpo

application/json
wallet_address
string

La dirección de la wallet que se va a verificar. Opcional; si está vacía, la dirección debe proporcionarse al iniciar una prueba.

Maximum string length: 128
chain
string

Token de cadena de la dirección, por ejemplo ETH, BTC o SOL. Usa el mismo token que en tu libreta de direcciones de wallets. La firma de mensajes y la prueba de Satoshi solo se ofrecen para una cadena compatible. La entrada de la libreta de direcciones que verifica la prueba lo almacena con su identificador canónico (ETH, BTC, SOL, TRX).

Maximum string length: 32
holder_name
string

Nombre del titular de la wallet, que se usa para la coincidencia del nombre del beneficiario.

Maximum string length: 255
vendor_data
string

Tu identificador interno del titular, que se traslada a la entrada de la libreta de direcciones creada.

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

Opcional. UUID de transacción de Didit de una transferencia de Travel Rule que se hace avanzar cuando se verifica la prueba.

satoshi_deposit_address
string

Opcional. Una dirección de depósito que controlas; al proporcionarla se habilita el método de prueba SATOSHI_TEST.

Maximum string length: 128
callback_url
string

Opcional. URL absoluta http(s) a la que el widget devuelve al cliente después de completar el proceso.

Maximum string length: 512
expires_in_minutes
integer
predeterminado:60

Opcional. Vigencia del enlace generado, en minutos. Se amplía automáticamente para cubrir la ventana de la prueba Satoshi cuando se ofrece SATOSHI_TEST.

Rango requerido: 5 <= x <= 10080

Respuesta

La sesión de widget emitida.

widget_session_id
string<uuid>
token
string

Token de sesión opaco incrustado en la URL del widget.

url
string

La URL del widget alojado de propiedad de la wallet. Ábrela tal cual en el navegador del sistema (nunca dentro de un webview de un SDK móvil).

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