Verificar es pedirle a un ciudadano que te muestre datos de una credencial de su wallet, y comprobar que son auténticos, vigentes y suyos. Y que muestre solo lo que pediste: si solo necesitás saber que es mayor de edad, pedís eso y nada más.
Son tres movimientos: creás una sesión diciendo qué datos querés (con una consulta DCQL, un JSON corto), mostrás un QR, y recibís un webhook con el veredicto. Funciona igual para SD-JWT VC y para mDoc; solo cambia cómo se nombra cada dato. El protocolo por debajo es OpenID4VP.
El flujo en una pantalla
sequenceDiagram
autonumber
participant V as Tu servidor (verificador)
participant S as Sovra
participant W as Wallet del holder
participant C as SovraChain
V->>S: POST /api/v1/verifier/verifications (dcql_query)
S-->>V: 201 session_id, authorization_request_uri(_ref), expires_at
V->>W: Muestra el QR (la sesión vive 10 minutos)
W->>W: El ciudadano aprueba o rechaza cada campo
W->>S: vp_token / DeviceResponse firmado por el holder
S->>C: Emisor, llaves del holder y estado de revocación
alt pasa todas las validaciones
S-->>V: Webhook presentation.verified (claims divulgados)
else falla alguna validación
S-->>V: Webhook presentation.failed (error)
end
Tu servidor crea la sesión y muestra el QR. El ciudadano lo escanea, ve exactamente
qué datos le pedís y los aprueba uno por uno. Sovra comprueba que la credencial sea
auténtica, vigente y del ciudadano, y te avisa con presentation.verified o
presentation.failed. La sesión vive 10 minutos; sus estados están en
Estados de la sesión.
Dos formas de verificar
Con Sovra (recomendada para empezar). Creás una sesión, Sovra valida y te avisa por webhook. Son dos llamadas HTTP y un webhook.
Sin Sovra, con el SDK. Todo lo necesario para verificar (emisor, llaves, lista de
confianza, revocación) está en SovraChain. Con @sovrahq/verification-sdk y acceso
RPC verificás por tu cuenta, sin API key ni dependencia de la disponibilidad de
Sovra. Conviene si no podés depender de un tercero, si verificás en un entorno
aislado, para auditar credenciales guardadas, o si querés verificar credenciales
sin ser cliente de Sovra.
Las comprobaciones criptográficas son idénticas en los dos caminos, y se pueden combinar. El detalle está en Verificar sin Sovra.
En esta sección
Verificar SD-JWT VC
Crear la sesión, escribir la consulta DCQL, mostrar el QR y leer el resultado.
Verificar mDoc
DCQL para mDoc con namespace ISO o propio, y las claves cualificadas del resultado.
Habilitar mDL ISO
El trámite de certificado para emitir licencias con el docType oficial de ISO.
Verificar sin Sovra
Verificar presentaciones con el SDK directamente contra SovraChain.
Estados de la sesión
Cada estado de una sesión de verificación, qué lo dispara y qué webhook se emite.
Errores de verificación
Todos los valores de error al crear la sesión y al presentar, con causa y solución.