Verificación alojada

Con la verificación alojada no construyes pantallas para el solicitante. Creas el caso, pides un enlace de un solo uso y se lo envías (correo, SMS, WhatsApp o un botón en tu app). El solicitante lo abre en su teléfono, acepta el consentimiento, sube sus documentos y su selfie, y al terminar el caso se envía a revisión sin otra llamada de tu parte.

1. Crear el caso

Igual que en Casos por API. Incluye en solicitante los datos que ya conoces: el solicitante solo aportará los documentos.

2. Pedir el enlace

curl -s -X POST "$KYC_BASE/v1/casos/$CASO/enlaces" \
  -H "X-API-Key: $KYC_API_KEY" -H "Idempotency-Key: enlace-1001" \
  -H "Content-Type: application/json" \
  -d '{
    "idioma": "es",
    "expiraEn": "2026-10-16T13:00:00Z",
    "redireccion": "https://mi-empresa.example/kyc/listo"
  }'

{
  "id": "enl_01J9Z3K8Q2W7XPT4M6N5R0B1CP",
  "url": "https://verify.finoracore.com/c/9f2…",
  "expiraEn": "2026-10-16T13:00:00Z"
}

Campo	Notas
idioma	es (por defecto) o en. Otro valor responde 422 IDIOMA_INVALIDO.
expiraEn	Entre 1 y 72 horas desde ahora; 24 horas por defecto. Fuera de ese rango, 422 VIGENCIA_INVALIDA.
redireccion	Opcional. URL https a la que vuelve el solicitante al terminar (en sandbox también http). Si no es válida, 422 REDIRECCION_INVALIDA.

El cuerpo es opcional: sin él, el enlace vence en 24 horas, en español y sin redirección.

La URL solo aparece en esta respuesta

FINORA guarda solo el hash del token. Envía o guarda la URL en ese momento; si la pierdes, crea otro enlace.

Reglas del enlace

• Un solo enlace vivo por caso. Crear otro revoca el anterior: úsalo para reenviar un enlace perdido o vencido.
• Se cierra al terminar. Después ya no abre, aunque no haya vencido.
• Sin consentimiento no hay archivos. El solicitante acepta un texto de consentimiento versionado; la versión y su huella quedan registradas en el caso.
• Hasta 10 documentos por enlace, de 10 MB como máximo cada uno, en JPEG, PNG, WebP o PDF. El solicitante puede subir cédula, pasaporte, RIF, licencia, selfie u otro documento.
• Para terminar hace falta al menos un documento. Si al flujo de tu cuenta le faltan documentos, el enlace sigue abierto y el solicitante ve qué falta.
• Cada paso queda en la bitácora del caso, con la dirección IP del solicitante.

3. Esperar el resultado

Al terminar, si el caso seguía esperando al solicitante, se envía solo: pasa a EN_PROCESO y de ahí al screening y a la cola del oficial. Escucha los webhooks caso.en_revision y caso.decidido, o consulta el caso con GET /v1/casos/{id}.

Si el solicitante no termina antes de que el caso venza, recibirás caso.expirado.

Buenas prácticas

• Crea el enlace justo antes de enviarlo, con una vigencia corta: un enlace de un solo uso que nadie abre a tiempo es más seguro que uno de 72 horas.
• No reutilices el texto del enlace en registros ni analítica: la URL es la credencial del solicitante.
• Usa la redireccion para devolver al solicitante a tu app o web y mostrarle «estamos revisando tus datos». No le muestres una decisión: la decisión llega por webhook cuando la toma tu oficial.