Saltar al contenido principal
GET
cURL

Compatibilidad con KYC y KYB

Funciona tanto con sesiones de Verificación de usuario (KYC) como de Verificación de empresas (KYB). Didit usa automáticamente la plantilla de PDF que corresponde:
  • Sesión de Verificación de usuario (KYC) → informe con secciones de verificación de identidad, prueba de vida, coincidencia facial, AML y prueba de domicilio.
  • Sesión de Verificación de empresas (KYB) → informe con secciones de registro de empresas, personas clave (UBO y cargos directivos), documentos, AML, cuestionario, teléfono, correo electrónico y análisis de IP, cuando esas funciones forman parte del flujo.
Ambos usan el mismo proceso de generación de PDF y admiten personalización de marca blanca (logotipo, URL de la política de privacidad).

Convención de nombres de archivo

Se devuelve en el encabezado Content-Disposition: attachment; filename=....

Requisito de estado

Para generar un PDF, la sesión debe estar en APPROVED, DECLINED o IN_REVIEW. Las sesiones en curso o que aún no se han iniciado devuelven 403.

Ejemplos

Marca blanca

Cuando la aplicación tiene activada la personalización de marca blanca, el PDF usa tu logotipo y la URL de tu política de privacidad. Configúralo en Console → Customization.

Permiso

Requiere read:sessions. Es el mismo scope para ambos tipos.

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 usuarios (KYC) o Verificación de empresas (KYB) que se va a generar: el session_id que devuelve POST /v3/session/. La misma ruta sirve para ambos tipos de sesión; usa el nombre de archivo de Content-Disposition en la respuesta para saber qué tipo de informe recibiste.

Debe ser un UUID bien formado y en minúsculas. La ruta solo coincide con UUID válidos, por lo que el enrutador de URL rechaza un valor mal formado antes de que se ejecute cualquier código de la aplicación, y la respuesta es una página HTML 404 en lugar del sobre JSON {"detail": ...} que se muestra a continuación. El conversor de UUID de la ruta solo coincide con la forma canónica en minúsculas: los UUID con hexadecimales en mayúsculas se rechazan con el 404 en HTML.

Ejemplo:

"11111111-2222-3333-4444-555555555555"

Respuesta

El documento PDF generado, devuelto directamente como binario application/pdf: no hay envoltorio JSON ni redirección a una URL de descarga. El cuerpo empieza con los bytes mágicos %PDF (PDF 1.7). Guárdalo en un archivo .pdf o transmítelo directamente a quien hizo la llamada.

The response is of type file.

Última modificación el 1 de noviembre de 2026