Documentação

Español

Português
English

Español

Português
English

Appearance

Detalle y decisión ​

Requisitos de acceso

  • Permiso (módulo): viewKycQueue (ver detalle) y reviewKyc (decidir)
  • Ruta: /kyc-queue/:userId

Qué es / cuándo usar ​

El detalle reúne, en una sola pantalla, todo lo que el Compliance Officer necesita para decidir el KYC del inversor: identidad, evidencia de Inversor Calificado, documentos enviados, background-check del BaaS, cuadro societario y datos de acceso — más la tarjeta de revisión con las acciones.

Paneles del detalle ​

Identidad ​

Resultado del proveedor de KYC: documento, imágenes, liveness y AML.

  • Datos del documento — tipo, número, número personal, nombre completo, nacimiento, país emisor, nacionalidad, género, validez, emisión, dirección.
  • Verificaciones — liveness (estado y score), face match (estado y score), confianza.
  • Imágenes — documento (frente/dorso) y selfie/retrato.
  • AML — verificación AML y verificación multi-bureau.
  • Payload completo del proveedor — payload crudo para auditoría.

Identidad por selfie Axia

Cuando la identidad se verifica por selfie/documentoscopia Axia (AXIA_KYC) en lugar del proveedor, el panel muestra una nota: identidad verificada por selfie (Axia), con revisión manual por Compliance. La selfie está en la sección Documentos del usuario; documentoscopia/AML por proveedor no aplica.

Inversor Calificado ​

Evidencia de patrimonio/accreditation enviada por el inversor (opcional — libera límites mayores). Muestra fecha e IP/dispositivo del envío, y preview/descarga de la evidencia (archivo SECURED). La decisión del IC se trata en Inversor Calificado.

Preanálisis facial ​

Cuando está habilitado para el tenant, compara automáticamente el rostro del documento de identidad con el de la selfie y muestra un veredicto — Coincide, Revisar, Divergente, No concluyente o Fallo técnico — junto con la distancia medida, los umbrales, el documento utilizado y cuántos rostros se detectaron en cada imagen.

La tarjeta queda justo encima de Documentos del usuario, a propósito: lees el veredicto y a continuación tienes las imágenes para comprobar. Detalles de lectura, limitaciones y aprobación automática en Preanálisis facial.

El preanálisis nunca rechaza por sí solo

"Divergente" señala el caso para revisión — no rechaza. Si la aprobación automática está activada, solo el veredicto "Coincide" promueve la cuenta, y la tarjeta lo informa explícitamente.

Documentos del usuario ​

Todos los artefactos de KYC enviados — documentos personales y la selfie del AXIA_KYC destacada (sello "Selfie") para comparación facial con el documento. Cada ítem tiene preview y descarga.

Background-check (BaaS) ​

Resultado del background-check del proveedor bancario, cuando está habilitado: ID de la verificación, estado, y el bloque de documentoscopia — estado (Pendiente / Aprobada / Reprobada), face match, OCR y enlace para abrir la documentoscopia.

Cuadro Societario (QSA) ​

Socios declarados del inversor persona jurídica: tipo (socio-administrador / socio), nombre, CPF enmascarado, nacimiento, nombre de la madre y participación.

Datos de acceso ​

Último acceso, inicios de sesión recientes geolocalizados en mapa (OpenStreetMap) y dispositivos registrados. Útil para verificar coherencia geográfica y detectar acceso sospechoso.

Revisión ​

Tarjeta con la decisión registrada por el Compliance Officer: revisado por, revisado en, motivo y notas.

Decisiones de la cuenta ​

Las acciones de la cuenta están en Decisión de la cuenta. Ambas exigen step-up (contraseña + MFA).

Aprobar cuenta ​

  • Precondición: identidad verificada — proveedor PASSED o selfie/documentoscopia Axia. Mientras la identidad no esté aprobada, el botón queda deshabilitado con el aviso "Identidad aún no aprobada por el proveedor".
  • Efecto: establece overall_status = APPROVED y promueve user.status = 'APPROVED' — la precondición ya consumida por la provisión de identidad on-chain (ERC-3643). La evidencia de Inversor Calificado es opcional y puede decidirse por separado.

Rechazar cuenta ​

  • Precondición: seleccionar un motivo (obligatorio) — INSUFFICIENT_PC_EVIDENCE, AML_FAIL o DOCUMENT_UNCLEAR (ver reason codes). Nota opcional para el registro.
  • Efecto: establece overall_status = REJECTED, graba el motivo y notifica al inversor, que puede corregir y reenviar la parte reprobada. Para clientes legados, también establece users.status = 'REJECTED'.

Estados de UI y errores ​

  • Cargando/error — skeleton al cargar; mensajes de fallo al cargar la evidencia.
  • La decisión falló — "No fue posible registrar la decisión. Inténtalo de nuevo."
  • El estado cambió (409) — "La decisión no pudo aplicarse: el estado del KYC cambió. Recarga la página e inténtalo de nuevo." Ocurre cuando el estado del KYC cambia entre la lectura y la decisión (protección de concurrencia).

Reglas de negocio / cuidados ​

Atención

  • Toda decisión exige step-up. El reviewed_by viene del administrador autenticado, nunca del cuerpo de la solicitud.
  • Aprobar cuenta ≠ aprobar IC. Aprobar la cuenta no marca al inversor como calificado; el IC es una decisión separada, en su propio alcance.
  • Rechazo siempre con motivo — es auditable y es lo que el inversor ve para corregir.
  • Un legado rechazado es notificado y vuelve al flujo de verificación (ver clientes legados).

Pantallas relacionadas ​