Quickstart

Este es el camino más rápido a una verificación funcionando: pegá una etiqueta de script en una página y después leé el veredicto desde tu propio backend.

Qué vas a tener al final

• Una página con el widget de Veridia renderizado
• Un flujo real de captura de documento + selfie
• Un verificationId que tu servidor puede consultar
• Un verdict de approved, review o rejected con un puntaje de confianza

Alrededor de 10 minutos. Sumale 10 más si querés dejar los webhooks conectados.

Tres pasos

1. Instalación — obtené tus claves, embebé el widget en una página
2. Primera verificación — corré una verificación de prueba de punta a punta
3. Manejo de resultados — leé el veredicto por polling o por webhooks

Qué vas a necesitar

• Una cuenta de Veridia (registrate acá)
• Dos claves de API desde la sección API keys del panel: una publicable y una secreta. Mirá abajo.
• Una página donde puedas pegar un par de etiquetas de script (cualquier framework, o HTML plano)
• Un dispositivo real con cámara para probar

Necesitás dos claves, no una

Esto hace tropezar a casi toda primera integración, así que va antes que cualquier otra cosa.

Familia de clave	Prefijo (test / live)	Dónde corre	Qué puede hacer
Publicable	qv_pubt_ / qv_pub_	Navegador, app móvil	Iniciar una verificación (/v1/verify/init) y enviarla (/v1/verify/submit)
Secreta	qv_sect_ / qv_sec_	Solo tu servidor	Todo lo anterior, más leer veredictos (GET /v1/verify/{id})

La clave publicable va en tu HTML. Está pensada para ser visible: el widget no puede funcionar de otra manera.

La clave secreta nunca sale de tu servidor. GET /v1/verify/{id} rechaza una clave publicable con HTTP 401 y el código de error secret_key_required, y lo hace a propósito: una clave publicable queda en el código fuente de tu página, así que aceptarla ahí sería publicar los veredictos KYC de todos tus clientes a cualquiera que abra las herramientas de desarrollo.

Los prefijos de test son qv_pubt_ y qv_sect_

No qv_pub_test_. La t se inserta dentro del prefijo mismo, antes del guion bajo. Si estás trabajando en modo test, las dos claves llevan esa t: una clave qv_sec_ no existe en tu entorno de test y va a volver como invalid_api_key.

Usá el par de test mientras integrás; cambiá las dos claves al par live cuando salgas a producción.

¿Ya integraste algo parecido?

Si integraste Stripe Elements, Sumsub u Onfido antes, el modelo mental es el mismo:

Concepto	Equivalente en Stripe / Sumsub	Veridia
Clave publicable	pk_test_*	qv_pubt_*
Clave secreta	sk_test_*	qv_sect_*
Widget de frontend	Stripe Elements / Sumsub WebSDK	<veridia-widget>
Confirmación desde el servidor	Webhook + firma	Webhook + HMAC-SHA256
Consultar el estado	GET /v1/payment_intents/:id	GET /v1/verify/:id

La diferencia principal: del lado del navegador, Veridia es una sola etiqueta HTML — no hace falta instalar un SDK ni un wrapper de framework.

¿Listo? Paso 1 →