Importar sesión compartida: KYC y KYB reutilizable

Lista de funciones de verificación configuradas para esta sesión, como nombres para mostrar: ID_VERIFICATION, NFC, LIVENESS, FACE_MATCH, POA, PHONE, EMAIL_VERIFICATION, AML, IP_ANALYSIS, DATABASE_VALIDATION, QUESTIONNAIRE, AGE_ESTIMATION, FACE_SEARCH, GEOLOCATION (verificación de ubicación) (las sesiones de Verificación de empresas usan el conjunto de funciones KYB: KYB_REGISTRY, KYB_DOCUMENTS, KYB_KEY_PEOPLE, AML, PHONE, EMAIL_VERIFICATION, IP_ANALYSIS, QUESTIONNAIRE). Con include=events, cada entrada pasa a ser un objeto {feature, node_id} en lugar de una cadena simple, y la función de correo electrónico cambia de nombre: aparece como EMAIL en el modo de eventos en lugar del EMAIL_VERIFICATION que se usa aquí.

Array de informes de verificación de identidad (OCR) generados por los pasos de documento de identidad del grafo del flujo. Siempre es un array JSON: lee id_verifications[0] e itera si tu flujo puede ejecutar más de una verificación de identidad (por ejemplo, una verificación principal más una verificación reforzada). Es null hasta que al menos un paso de identidad haya generado datos. Cada elemento es el informe completo, que incluye node_id, el status a nivel de función, los campos extraídos del documento, las URL de las imágenes, las puntuaciones de calidad, la MRZ, el análisis de la dirección, las coincidencias entre sesiones y warnings[].

Array de informes NFC / ePassport generados por los pasos NFC del grafo del flujo. Siempre es un array JSON, nunca un objeto nfc singular: lee nfc_verifications[0] e itera si tu flujo puede ejecutar NFC más de una vez. Es null hasta que al menos un paso NFC haya generado datos. Cada elemento es el informe completo, que incluye node_id, el status a nivel de función, chip_protocol, chip_data, authenticity (integridad de SOD + DG), certificate_summary y warnings[]. Una My Number Card de Japón se lee mediante JPKI en lugar de ICAO 9303: su elemento tiene chip_protocol: "jpki", incluye su evidencia en jpki y deja los campos ICAO en null. Cuando el paso NFC se omitió antes de poder ofrecerse (documento sin chip, certificado ausente, sin capacidad NFC informada, clave MRZ ilegible, JPKI no disponible para una My Number Card), este campo permanece en null y nfc_skip_reason explica el motivo; una omisión en el propio paso (el usuario pulsó omitir o el lector resultó no estar disponible en el momento del escaneo) sigue generando un informe con is_nfc_skipped: true.

Array de informes de prueba de vida generados por los pasos de prueba de vida del grafo del flujo. Siempre es un array JSON, nunca un objeto liveness singular. Es null hasta que al menos un paso de prueba de vida haya generado datos. Cada elemento es el informe completo, que incluye node_id, el status a nivel de función, method, score, reference_image, video_url, age_estimation opcional, matches[] entre sesiones y warnings[].

Array de informes de coincidencia facial generados por los pasos de coincidencia facial del grafo del flujo. Siempre es un array JSON, nunca un objeto face_match singular. Es null hasta que al menos un paso de coincidencia facial haya generado datos. Cada elemento es el informe completo, que incluye node_id, el status a nivel de función, el score de similitud, source_image, target_image y warnings[].

Array de informes de verificación de teléfono: siempre es un array JSON, nunca un objeto phone singular. Es null hasta que al menos un paso de teléfono haya generado datos. Cada elemento es el informe completo, que incluye node_id, el status a nivel de función, el número de teléfono y los metadatos del país, lifecycle[], matches[] y warnings[].

Array de informes de verificación de correo electrónico: siempre es un array JSON, nunca un objeto email singular. Es null hasta que al menos un paso de correo electrónico haya generado datos. Cada elemento es el informe completo, que incluye node_id, el status a nivel de función, la dirección de correo electrónico, los datos de filtraciones, lifecycle[], matches[] y warnings[].

Array de informes de Prueba de domicilio (POA): siempre es un array JSON, nunca un objeto poa singular. Es null hasta que al menos un paso de POA haya generado datos. Cada elemento es el informe completo, que incluye node_id, el status a nivel de función, la URL del archivo del documento, el emisor, las fechas, la dirección analizada y warnings[].

Informes de Document AI agrupados por nodo del flujo: siempre es un array JSON, nunca un objeto individual. Vale null hasta que al menos un paso de Document AI haya generado datos. Solo está presente cuando session_kind = user. Cada elemento es un grupo de nodo con un status agregado, el node_id, un array items[] con los resultados de cada documento (datos extraídos indexados por la clave de campo configurada) y warnings.

Array de informes de respuestas de cuestionarios: siempre es un array JSON, nunca un objeto questionnaire singular. Es null hasta que al menos un paso de cuestionario haya generado datos. Cada elemento es el informe completo, que incluye node_id, los metadatos del cuestionario, las secciones con elementos de formulario y las respuestas del usuario.

Resultados de Verificación bancaria, un elemento por cada paso de Verificación bancaria, para Verificación de usuarios y Verificación de empresas. null hasta que un paso produzca uno. El method de cada elemento indica cómo se verificó la cuenta: open_banking (inicio de sesión en el banco) o account_lookup (comprobación de la cuenta), o una alternativa statement o microdeposits, y none cuando la persona continuó sin banco antes de que se evaluara algún intento (continued_without_bank). Consulta Métodos de verificación bancaria. La Verificación bancaria aún no está habilitada en producción, por lo que este campo sigue siendo null en las sesiones de producción hasta que lo esté.

Resultados de la firma electrónica, un elemento por firmante y paso de firma, para la Verificación de usuarios y la Verificación de empresas. Solo está presente cuando el flujo tiene un paso de Firma electrónica; es un array vacío hasta que un firmante llega a él. Consulta el informe de firma electrónica.

Array de informes de análisis AML: siempre es un array JSON, nunca un objeto aml singular. Es null hasta que al menos un paso de AML haya generado datos. Cada elemento es el informe completo, que incluye node_id, el status a nivel de función, total_hits, entity_type, hits[], score, screened_data, is_ongoing_monitoring_enabled y warnings[].

Array de informes de Análisis de dispositivo e IP: siempre es un array JSON, nunca un objeto ip_analysis singular. Es null hasta que al menos un paso de análisis de IP haya generado datos. Cada elemento es el informe completo, que incluye node_id, el status a nivel de función, los datos de IP y geolocalización, la huella digital del dispositivo y warnings[]. Las entradas con (node_id, ip_address, device_fingerprint) duplicados se deduplican en el servidor.

Array de resultados de verificación de ubicación, uno por cada paso de verificación de ubicación: el intento aceptado de ese paso. Es null hasta que un paso de verificación de ubicación haya generado datos. Los intentos anteriores del mismo paso están en geolocation_attempts.

Todos los intentos de cada paso de verificación de ubicación de esta sesión, del más antiguo al más reciente. Se omiten los intentos sustituidos por un reenvío. Un flujo de verificación (workflow) que oculta geolocation_checks mediante sus atributos de respuesta también oculta esta lista.

Array de informes de Validación de base de datos: siempre es un array JSON, nunca un objeto database_validation singular. Vale null hasta que al menos un paso de validación de base de datos haya generado datos. Cada elemento es el informe completo, que incluye node_id, el status a nivel de función, screened_data, las validations[] por servicio (cada una con su source_data del registro) y warnings[]. Los campos screened_data y source_data varían según el país:

ARG (Argentina): screened_data: {document_number, selfie, gender, first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name, date_of_birth, date_of_death, tax_id, tax_id_type, face_match_score, sit_1_since, banks, last_position, highest_position, rejected_checks}. Usa la validación biométrica de coincidencia facial de RENAPER. El género se infiere automáticamente a partir del análisis facial o del nombre de pila cuando no figura en el documento (por ejemplo, en licencias de conducir)

BOL (Bolivia): screened_data: {document_number, date_of_birth, first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name, date_of_birth, gender}

BRA (Brasil): screened_data: {tax_number, first_name, last_name, date_of_birth}. source_data siempre incluye {identification_number, first_name, last_name, date_of_birth, lgpd_minor, minor_under_18, minor_under_16} en las coincidencias de CPF correctas. Las consultas exitosas de adultos establecen esos indicadores en false. El servicio Consulta CPF de la Receita Federal puede devolver HTTP 422 (menor de 18 años) o 451 (menor de 16 años) con datos retenidos por la LGPD; en esos casos, source_data establece los indicadores de menor en true según corresponda, incluye el estado HTTP de origen y la validación a nivel de campo es no_match. Consulta la sección de Brasil de la referencia de códigos de resultado de Validación de base de datos para ver la lista completa de códigos.

CHL (Chile): screened_data: {personal_number, first_name, last_name, date_of_birth}. source_data: {identification_number, first_name, last_name, date_of_birth, gender}

COL (Colombia): screened_data: {document_number, document_type, first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name, date_of_birth, document_type}

CRI (Costa Rica): screened_data: {personal_number, first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name}

DOM (República Dominicana): screened_data: {personal_number}. source_data: {identification_number} (solo devuelve válido/no válido)

ECU (Ecuador): screened_data: {personal_number, first_name, last_name}. source_data: {identification_number, first_name, last_name, street, formatted_address, gender, nationality, education, marital_status, spouse, mother_name, father_name, profession}

ESP (España): screened_data: {personal_number, document_type, expiration_date, first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name, document_type, expiration_date}

GTM (Guatemala): screened_data: {document_number, first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name}

HND (Honduras): screened_data: {document_number, first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name}

MEX (México): screened_data: {personal_number (CURP), first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name, date_of_birth, gender, nationality, curp_status, state_of_birth, doc_probatorio, registration_year, registration_state, registration_municipality, num_acta, crip, issuing_state_code, foreign_registry_number, folio_carta, folio_certificado}. Usa el registro civil de RENAPO. Para MEX también está disponible un servicio independiente de comprobación de vigencia del INE como validación adicional individual.

PAN (Panamá): screened_data: {personal_number, selfie}. source_data: {identification_number}. Usa la validación biométrica de SIB

PER (Perú): screened_data: {personal_number (DNI), first_name, last_name}. source_data: {identification_number, first_name, last_name, paternal_name, maternal_name, verification_number, verification_letter}

PRY (Paraguay): screened_data: {document_number, first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name}

SLV (El Salvador): screened_data: {document_number, date_of_birth, first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name}

URY (Uruguay): screened_data: {personal_number, date_of_birth, first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name}

VEN (Venezuela): screened_data: {document_number, first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name, gender, date_of_birth, document_type}

Comprobaciones en el registro de empresas. Solo está presente cuando session_kind = business. Cada elemento incluye el payload completo del registro de empresas.

Comprobaciones agregadas de las personas clave. Solo están presentes cuando session_kind = business. Cada elemento usa la estructura de dos grupos (registry, submitted, ubo_kyc_summary).

Comprobaciones de verificación de documentos agrupadas por nodo del flujo. Solo aparece cuando session_kind = business.

Solo se devuelve con include=resubmissions, para sesiones de usuarios y de empresas. Una entrada por cada solicitud de reenvío, de la más antigua a la más reciente. Cada entrada contiene los resultados que devolvieron los pasos reenviados antes de la solicitud, de modo que los envíos anteriores siguen siendo legibles. Al eliminar la sesión se eliminan todos los envíos.