Sovra ID es la plataforma para emitir y verificar datos firmados por tu organización: una licencia, una membresía, un certificado, una constancia. Todo lo que emitís lleva tu firma digital y su estado (vigente, suspendido, revocado) se publica en SovraChain, una cadena de bloques pública. Así, quien lo recibe puede comprobar que es auténtico sin tener que preguntarte nada.
Tu servidor habla con la API usando una API key de workspace (Authorization: Bearer sovra_sk_...).
La primera decisión: credencial o documento
La plataforma emite dos cosas distintas, y elegir bien entre las dos es lo primero.
| Credencial verificable | Documento firmado | |
|---|---|---|
| Qué es | La versión digital de una tarjeta que la persona lleva en su wallet | Una hoja que la institución emite y reparte, sin dueño que la custodie |
| Quién la guarda | La wallet del ciudadano | Quien la recibe: un archivo, un enlace, un papel |
| Qué se muestra | Lo que la persona elige, campo por campo | Todo el contenido, a la vista |
| Casos típicos | Licencias, identidad, membresías, títulos habilitantes | Certificados, constancias, actas, comprobantes |
La regla práctica: si el dato es sobre una persona y ella decide cuándo y cuánto mostrarlo, es una credencial. Si es una hoja que la institución emite y reparte, es un documento.
Una credencial, además, se puede emitir en dos formatos: SD-JWT VC (el formato por defecto) o mDoc (el de la licencia de conducir móvil). Los detalles están en Tipos de credenciales.
Por dónde seguir
Conceptos
Cómo funciona todo, en lenguaje llano: quién participa, qué se emite y cómo cambia de estado.
Primeros pasos
Acceso, workspace, API key, webhook y tu primera llamada.
Credenciales
Crear el esquema y emitir credenciales SD-JWT VC y mDoc a la wallet del ciudadano.
Verificadores
Pedir campos concretos de una credencial y leer el resultado.
Documentos
Emitir, repartir, mostrar y verificar documentos firmados.
Referencia de API
Cada endpoint, con sus parámetros y respuestas.