Saltar al contenido principal
POST
curl

Compatibilidad con KYC y KYB

Funciona tanto con sesiones de Verificación de usuario (KYC) como de Verificación de empresas (KYB). Didit busca el session_id en ambos tipos de sesión y genera un token JWT para compartir que incluye:
Cuando el partner receptor importa el token, Didit clona la sesión correspondiente (KYC o KYB) junto con sus relaciones.

Requisitos

  • La sesión debe estar en un estado finalizado (APPROVED, DECLINED, IN_REVIEW).
  • Debes tener el privilegio write:sessions.
  • El for_application_id debe ser una aplicación de Didit válida (normalmente, la aplicación de un socio).

Ejemplos

Respuesta:

Límites del TTL

Contenido relacionado

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

sessionId
string<uuid>
requerido

UUID de la sesión de verificación de origen para la que se emite un token.

Ejemplo:

"11111111-2222-3333-4444-555555555555"

Cuerpo

application/json
for_application_id
string<uuid>
requerido

UUID de la aplicación de Didit que canjeará el token. Debe existir, no debe estar eliminada y debe ser distinta de la aplicación que hace la llamada. Encuéntralo en la Business Console, en Settings → Application.

Ejemplo:

"a5f3bca2-46e2-411e-90ef-a580900a57ee"

ttl_in_seconds
integer
predeterminado:3600

Duración del token, en segundos. Mínimo 60, máximo 86400 (24 h). Valor predeterminado: 3600 (1 h).

Rango requerido: 60 <= x <= 86400
Ejemplo:

3600

Respuesta

Token para compartir generado.

share_token
string

JWT firmado con HS256. Pásalo tal cual como share_token a POST /v3/session/import-shared/ en la aplicación de destino.

Ejemplo:

"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

for_application_id
string<uuid>

Devuelve el UUID de la aplicación de destino a la que está vinculado el token.

Ejemplo:

"a5f3bca2-46e2-411e-90ef-a580900a57ee"

session_kind
enum<string>

Si la sesión de origen es una sesión de Verificación de usuarios (KYC) o de Verificación de empresas (KYB).

Opciones disponibles:
user,
business
Última modificación el 1 de noviembre de 2026