Flujo canónico: KYC

Estados

NOT_STARTED  →  IN_PROGRESS  →  SUBMITTED  →  APPROVED
                                          ↓
                                       REJECTED
                                          ↓
                                   NEEDS_MORE_INFO

Equivalencias con la nomenclatura canónica en español (sin_iniciar / borrador / enviado / aprobado / rechazado / requiere_mas_informacion / vencido / bloqueado_manual) en datos/equivalencias-estados.md.

Reglas vigentes

• Consolidar, pagar y despachar requieren KYC aprobado (D-108).
• La prealerta, ver paquetes y solicitar servicios adicionales no requieren KYC aprobado.
• Un gate debe indicar motivo, beneficio, próxima acción y alternativa.
• La intención original del usuario (consolidación, pago, despacho) se conserva al pasar por el KYC.
• La promesa "revisión en 24 horas" es solo estimado interno (D-114); no debe comunicarse como compromiso contractual.

Pasos del flujo

1. Explicación y enlace a política de privacidad.
2. Selección de tipo de documento.
3. Número de documento cuando aplique.
4. Foto del frente.
5. Foto del reverso (solo si aplica; pasaporte no lo requiere).
6. Selfie sosteniendo el documento, con instrucciones y manejo de permisos.
7. Dirección de residencia en EE.UU. (no la dirección del casillero en Miami).
8. Resumen completo, editable.
9. Consentimiento explícito.
10. Envío → estado SUBMITTED / enviado.
11. Notificación del resultado al usuario.

Prototipo sin backend

La APK demo mantiene el expediente y estado KYC en DemoSessionRepository. Al enviar cambia a SUBMITTED; las herramientas de demostración permiten dejarlo en revisión, aprobarlo o rechazarlo. Cada cambio también actualiza el usuario visible y genera una notificación demo.

KycBlockedScreen está enrutada y se aplica antes de consolidar y pagar. El despacho demo solo se ejecuta para una consolidación pagada y con KYC aprobado. Las acciones bloqueadas explican la causa y permiten iniciar o retomar la verificación.