Quickstart
Este es el camino mas rapido a una verificacion funcionando: pega un par de tags de script en una pagina, y listo.
Que vas a tener al final
- Una pagina con el widget de Veridia renderizado
- Un flujo real de captura de documento + selfie
- Un
verificationIdque podes consultar, o un evento webhook que recibis - Un
verdictdeapproved,revieworejectedcon un score de confianza
Aproximadamente 5 minutos para una integracion basica. Agrega 10 minutos mas si queres webhooks.
Tres pasos
- Instalacion — obtene una API key, embebe el widget en una pagina
- Primera verificacion — corre una verificacion de prueba end-to-end
- Manejando resultados — recibi el veredicto via eventos, polling o webhooks
Que vas a necesitar
- Una cuenta Veridia (registrate aqui)
- Una API key publica
qv_pub_*(creada automaticamente al registrarte — buscala en el dashboard, seccion API keys) - Una pagina donde puedas pegar un par de tags de script (cualquier framework, o HTML plano)
- Dos minutos de acceso a camara en un dispositivo real para testear
Modo test vs produccion
Cada tenant de Veridia tiene dos environments:
| Environment | Prefijo de key | Proposito |
|---|---|---|
| Test | qv_pub_test_* | Verificaciones gratis, pipeline ML real, los resultados no cuentan para facturacion |
| Live | qv_pub_* | Verificaciones reales, facturacion real |
Usa la test key mientras integras. Cambia a la live key cuando estes listo para production.
Integraste algo similar antes?
Si integraste Stripe Elements, Sumsub o Onfido antes, el modelo mental es el mismo:
| Concepto | Equivalente Stripe / Sumsub | Veridia |
|---|---|---|
| Publishable key | pk_test_* | qv_pub_test_* |
| Widget de frontend | Stripe Elements / Sumsub WebSDK | <veridia-widget> |
| Confirmacion server | Webhook + signature | Webhook + HMAC-SHA256 |
| Poll de status | GET /v1/payment_intents/:id | GET /v1/verify/:id |
La diferencia principal: Veridia es una sola tag HTML, sin install de SDK ni wrapper de framework.
Listo? Paso 1 →