Esta sección es para el emisor: cómo definir una credencial, cómo hacerla llegar a la wallet del ciudadano y cómo administrarla después. El recorrido es el mismo para SD-JWT VC y para mDoc; lo que cambia es el esquema y cómo se codifican los valores, no los endpoints.
Antes de empezar
- Un workspace aprovisionado, con su DID, una API key y un endpoint de webhook. Todo eso está en Primeros pasos.
- Saber qué formato vas a emitir. Si todavía no lo decidiste, leé Tipos de credenciales.
El flujo en una pantalla
- Creás un esquema: qué datos lleva la credencial, en qué formato y cuánto vale.
Antes de usarlo tiene que quedar registrado en SovraChain (
registered). - Creás una oferta con el
schema_idy los valores. Te devuelve uncredential_id, que identifica a la credencial toda su vida, y unoffer_uri. - Mostrás el
offer_uricomo QR. Vale 24 horas y es de un solo uso. - El ciudadano lo escanea y la wallet recibe la credencial, firmada con la llave de tu workspace.
- Recibís el webhook
credential.issuedcon la credencial firmada. - Administrás su estado: suspender, reactivar o revocar. Cualquier verificador lo ve, porque se publica on-chain.
sequenceDiagram
autonumber
participant E as Tu sistema (emisor)
participant S as Sovra
participant W as Wallet del ciudadano
E->>S: Crea el esquema (y espera "registered")
E->>S: POST /issuer/credential-offer
S-->>E: credential_id, offer_uri
E->>W: QR con offer_uri
W->>S: Canjea la oferta
S-->>W: Credencial firmada
S->>E: Webhook credential.issued
Las páginas de esta sección
Esquema SD-JWT VC
Crear el esquema desde el dashboard o por API, y el diseño de la tarjeta.
Esquema mDoc
Namespace ISO o propio, las decisiones que no se pueden cambiar, foto y firma.
Emitir SD-JWT VC
La oferta, el QR y el webhook credential.issued.
Emitir mDoc
La oferta mDoc, cómo mandar cada tipo de dato, imágenes y vigencia.
Estados y revocación
Suspender, reactivar y revocar una credencial.
Errores de emisión
Todos los errores de esquemas y de emisión.
Para el modelo conceptual, mirá Esquemas y Ciclo de vida. Los endpoints, uno por uno, están en la referencia de API: Credenciales y Esquemas.