Saltar al contenido principal
POST
curl
Usa esta opción cuando el enlace anterior ya no sirve: la sesión se eliminó o expiró antes de que la persona llegara a iniciarla. Las sesiones eliminadas cumplen el requisito aunque la persona ya hubiera iniciado o completado la verificación. Las sesiones importadas no cumplen el requisito por expiración; deben haberse eliminado. Una sesión que no se ha eliminado y que la persona ya había iniciado no cumple el requisito por expiración. La nueva sesión queda vinculada a la misma parte, por lo que su resultado se incorpora a la comprobación de personas clave como lo habría hecho la original, y su enlace dura el tiempo de expiración de sesión del flujo de verificación (workflow) KYC que ejecuta (de 1 hora a 4 semanas), no el de la sesión de empresa. Consulta la parte y sus sesiones secundarias en la decisión de la sesión de empresa. Si la persona no debe verificarse en absoluto, omite la parte en su lugar. Consulta Personas clave para saber cómo funcionan las partes y sus verificaciones.

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 principal de Verificación de empresas (KYB).

Ejemplo:

"33333333-4444-5555-6666-777777777777"

partyUuid
string<uuid>
requerido

UUID de la parte de Personas clave (key_people_checks[].submitted.parties[].uuid en la decisión de la sesión de empresa). Debe pertenecer a la sesión referenciada por sessionId.

Ejemplo:

"0a3f1e2c-7c2f-4a1b-9d55-2f8d2a5d6b41"

Respuesta

Se ha creado una nueva sesión KYC. Devuelve la parte actualizada con su nueva sesión secundaria, que expira según el tiempo de expiración de sesión de su flujo KYC.

Una parte de Personas clave de una sesión de Verificación de empresas (KYB), con su verificación secundaria. La misma parte aparece en key_people_checks[].submitted.parties[] de la decisión de la sesión de empresa.

uuid
string<uuid>
requerido

Identificador de la parte.

entity_type
enum<string>
requerido

Si la parte es una persona física o una empresa.

Opciones disponibles:
person,
company
source
enum<string>
requerido

REGISTRY: obtenido del registro de empresas. USER: introducido en la pantalla Personas clave.

Opciones disponibles:
REGISTRY,
USER
name
string
requerido

Nombre visible de la parte.

is_active
boolean
requerido

Si la parte está activa.

is_skipped
boolean
requerido

Si la parte está exenta de verificación. Al regenerar, este valor se borra.

requires_verification
boolean
requerido

Si las reglas de rol y propiedad exigen una verificación para esta parte.

roles
object[]
requerido

Roles que tiene la parte en la empresa.

kyc_session_deleted
boolean
requerido

La sesión KYC hija se eliminó, por lo que nunca podrá resolverse.

kyb_sub_session_deleted
boolean
requerido

Equivalente de kyc_session_deleted para las partes de tipo empresa.

first_name
string | null

Nombre (personas).

last_name
string | null

Apellido (personas).

company_name
string | null

Nombre de la empresa (partes que son empresas).

registration_number
string | null

Número de registro de la empresa (partes que son empresas).

email
string<email> | null

Correo electrónico al que se envía el enlace de verificación.

nationality
string | null

Nacionalidad para personas, país de constitución para empresas.

phone_number
string | null

Número de teléfono recopilado para la parte.

date_of_birth
string<date> | null

Fecha de nacimiento (personas).

position
string | null

Cargo en texto libre (personas).

custom_fields
object

Campos personalizados definidos en el flujo y recopilados para la parte, indexados por la clave del campo.

kyc_session_id
string<uuid> | null

Sesión KYC individual secundaria (personas).

kyc_session_status
enum<string> | null

Estado de la sesión KYC hija. Una sesión eliminada conserva el estado que tenía cuando se eliminó.

Opciones disponibles:
Not Started,
In Progress,
Approved,
Declined,
In Review,
Expired,
Abandoned,
Kyc Expired,
Resubmitted,
Awaiting User,
null
kyc_session_url
string<uri> | null

Enlace alojado de la sesión KYC secundaria. null cuando no existe o se eliminó, y para una clave de API con alcance limitado sin sessions: write.

kyb_sub_session_id
string<uuid> | null

Sesión KYB secundaria (partes que son empresas).

kyb_sub_session_status
enum<string> | null

Estado de la sesión KYB hija.

Opciones disponibles:
Not Started,
In Progress,
Approved,
Declined,
In Review,
Expired,
Abandoned,
Kyc Expired,
Resubmitted,
Awaiting User,
null
kyb_sub_session_url
string<uri> | null

Enlace alojado de la sesión KYB secundaria, con las mismas reglas de null que kyc_session_url.

verification_workflow_type
enum<string> | null

Tipo del flujo que ejecuta la sesión secundaria.

Opciones disponibles:
kyc,
kyb,
adaptive_age_verification,
biometric_authentication,
address_verification,
questionnaire_verification,
email_verification,
phone_verification,
null
verification_workflow_id
string<uuid> | null

Flujo que ejecuta la sesión hija.

verification_workflow_label
string | null

Etiqueta de ese flujo.

verification_workflow_features
object[] | null

Funciones del flujo de la sesión hija con su estado actual.

didit_internal_id
string<uuid> | null

Identificador de Didit de la persona verificada, una vez conocido.

Última modificación el 1 de noviembre de 2026