Crear sesión de verificación KYC

Endpoint: POST /kyc/create-session

---

Permite generar una nueva sesión de verificación KYC (OCR + FACE + AML) para el usuario autenticado. Devuelve una URL que el usuario debe utilizar para completar el proceso de verificación.

---

🔐 Requiere autenticación JWT

Debes enviar el token JWT en el header:

Authorization: Bearer <token>

---

📋 Respuesta exitosa

{
  "code": 1000,
  "message": "Sesión de KYC creada",
  "data": {
    "url": "https://example.kycprovider.com/session/abc123"
  }
}

• url: Enlace que el usuario debe abrir para completar la verificación.

---

💻 Uso recomendado en frontend

Web

Se recomienda mostrar la URL en un <iframe> para mantener al usuario en la misma vista:

<iframe src="{url}" width="100%" height="600px" frameborder="0"></iframe>

App móvil

En aplicaciones móviles, abre la URL en una ventana externa o navegador embebido:

// Flutter (ejemplo)
launchUrl(Uri.parse(url), mode: LaunchMode.externalApplication);

---

❌ Errores

Código	Mensaje	Descripción
2001	User not authenticated	Token JWT inválido o ausente.
5001	Error creating KYC session	Fallo interno en la creación de la sesión (Redis, etc).

Formato de error:

{
  "code": 5001,
  "message": "Error creating KYC session",
  "id": "KYC-SESSION-XX98"
}

---

📝 Notas

• La sesión de KYC expira tras 10 minutos.
• El backend almacena la sesión en Redis: kyc:<session_id> → <user_id>.
• El frontend debe monitorear si el usuario completó la verificación (por polling o callback, según la integración).

---