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
vendor_data
string
requerido

Tu identificador interno del usuario final al que se limita este token. Se aplica como identidad del sujeto de cada transacción enviada con el token.

Ejemplo:

"user-042"

ttl_seconds
integer
predeterminado:900

Duración del token en segundos. Valor predeterminado: 900 (15 minutos); máximo: 86400 (24 horas).

Rango requerido: x <= 86400
max_uses
integer | null

Número máximo de envíos correctos permitidos con este token. Omítelo o usa null para permitir usos ilimitados dentro del TTL.

Respuesta

El token emitido. Entrega sdk_token a tu aplicación; autentica los endpoints /v1/transactions/ orientados al dispositivo mediante el encabezado X-Transaction-Token hasta expires_at.

sdk_token
string

El token de transacción con alcance limitado que debes pasar al SDK.

expires_at
string<date-time>

Cuándo deja de aceptarse el token.

Última modificación el 1 de noviembre de 2026