Cola de KYC

La Cola de KYC es el panel de compliance del BackOffice donde el Compliance Officer revisa y decide el KYC compuesto del inversor: identidad (proveedor de KYC o selfie/documentoscopia Axia), Inversor Calificado (evidencia opcional que libera límites mayores) y, cuando está habilitado, el background-check del BaaS. La aprobación de la cuenta es una decisión manual — ningún inversor se aprueba con el webhook del proveedor.

La única excepción es el preanálisis facial con aprobación automática activada: en ese caso, un veredicto holgadamente positivo en la comparación documento × selfie promueve la cuenta por sí solo, registrado como SYSTEM_FACE_MATCH. Ningún veredicto rechaza una cuenta automáticamente.

Requisitos de acceso

• Permiso (módulo): viewKycQueue (ver cola y detalles) y reviewKyc (aprobar / rechazar / pedir reenvío)
• Licencia/Feature: modo de aprobación del tenant en MANUAL (ver AUTO × MANUAL)
• Contenedor del menú: GENERAL → Cola de KYC (/kyc-queue)

Qué puedes hacer aquí

• Listar y buscar inversores en revisión, separados en pestañas Pendientes / Aprobados / Rechazados / Todos, con búsqueda por nombre, CPF, CNPJ, pasaporte o e-mail.
• Revisar la identidad — payload del proveedor (documento, imágenes, liveness, AML) o la nota de identidad verificada por selfie/documentoscopia Axia.
• Revisar la evidencia de Inversor Calificado (opcional) y decidirla en su propio alcance.
• Consultar los documentos del usuario — todos los artefactos de KYC enviados, con la selfie AXIA_KYC destacada para comparación facial.
• Leer el preanálisis facial — veredicto automático de la comparación entre el rostro del documento y el de la selfie, cuando está habilitado para el tenant.
• Ver el background-check del BaaS y la documentoscopia (estado, face match, OCR, enlace) cuando el proveedor bancario está habilitado.
• Analizar el Cuadro Societario (QSA) del inversor persona jurídica, con CPF enmascarado.
• Auditar el acceso — mapa de inicios de sesión recientes geolocalizados y dispositivos registrados.
• Decidir — Aprobar cuenta, Rechazar cuenta (con motivo) o decidir el Inversor Calificado, siempre con confirmación de seguridad (step-up).

Flujo de KYC compuesto

La identidad y el Inversor Calificado son dos lados independientes:

• Cuenta — la aprobación de la cuenta exige solo que la identidad esté verificada (proveedor PASSED o selfie/documentoscopia Axia). Aprobar establece user.status = 'APPROVED', que es la precondición ya consumida por la provisión de identidad on-chain (ERC-3643).
• Inversor Calificado (IC) — es opcional y no bloquea la cuenta. Aprobar el IC marca el perfil como qualified (libera límites mayores). Ver Inversor Calificado.

Significado de los estados

Estado	Valores	Qué significa
Identidad	PENDING (Pendiente) · PASSED (Aprobada) · FAILED (Reprobada)	Espejo del resultado del proveedor de KYC. PASSED es precondición para aprobar la cuenta.
Inversor Calificado	NOT_SUBMITTED (No enviado) · SUBMITTED (Enviado) · PASSED (Aprobado) · FAILED (Reprobado)	Estado de la evidencia de patrimonio/accreditation. Independiente de la cuenta.
Estado general	PENDING (Pendiente) · APPROVED (Aprobado) · REJECTED (Rechazado)	Estado agregado de la cuenta del inversor.

Motivos de rechazo (reason codes)

Todo rechazo de cuenta o de IC exige un motivo — es auditable y es lo que el inversor ve para corregir y reenviar.

Código	Etiqueta	Cuándo usar
INSUFFICIENT_PC_EVIDENCE	Evidencia de Inversor Calificado insuficiente	El documento de patrimonio/accreditation no comprueba la condición de calificado.
AML_FAIL	Reprobado en la verificación AML	Alerta de AML/sanciones que impide la aprobación.
DOCUMENT_UNCLEAR	Documento ilegible o incompleto	Imagen/archivo ilegible, cortado o incompleto.

Step-up obligatorio

Toda decisión (aprobar, rechazar o pedir reenvío) exige confirmación de seguridad (step-up) — reautenticación con contraseña + MFA, validada en el servidor. Es protección de compliance de alto impacto: el reviewed_by de la decisión viene siempre del administrador autenticado, nunca del cuerpo de la solicitud.

Clientes legados

Inversores antiguos que ya tienen registro/documento pero nunca pasaron por el flujo de verificación aparecen en la pestaña Pendientes con el sello "Sin verificación iniciada". El estado se sintetiza (identidad PENDING, IC NOT_SUBMITTED, estado general a partir de users.status).

Rechazar un legado notifica al cliente

Rechazar la cuenta de un cliente legado establece users.status = 'REJECTED' con el motivo y dispara una notificación — es el mecanismo para que el cliente vea el motivo y rehaga el proceso de verificación en el hub de KYC.

Modo del tenant (AUTO × MANUAL)

El comportamiento se controla por tenant vía approvalMode:

• AUTO (legado, por defecto) — el webhook del proveedor aprueba la cuenta por sí solo. La cola manual no gobierna estos tenants y no hay regresión en los flujos existentes.
• MANUAL — la cola gobierna: el webhook solo actualiza la identidad; la cuenta solo pasa a APPROVED por decisión explícita del Compliance Officer en esta pantalla.

Subsecciones

Página	Qué cubre
Cola (lista)	Pestañas, búsqueda, chips de estado, sello de legado y paginación
Detalle y decisión	Paneles del detalle y decisiones de cuenta (aprobar/rechazar/pedir reenvío)
Preanálisis facial	Comparación automática documento × selfie, lectura del veredicto y aprobación automática
Inversor Calificado	Evidencia opcional y la decisión de IC en su propio alcance