---
title: "Verificar credenciales"
description: "Cómo pedir y validar credenciales con OID4VP y DCQL: con una sesión de verificación de Sovra o por tu cuenta, leyendo SovraChain."
---

> Documentation Index
> Fetch the complete documentation index at: https://sovra-id-docs-1044960690985.us-central1.run.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Verificar credenciales

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

```mermaid
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](https://sovra-id-docs-1044960690985.us-central1.run.app/verificadores/estados-de-la-sesion/).

## 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](https://sovra-id-docs-1044960690985.us-central1.run.app/verificadores/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.

Source: https://sovra-id-docs-1044960690985.us-central1.run.app/verificadores/index.mdx
