Skip to content

Emitir credenciales

Cómo se emite una credencial de punta a punta: esquema, oferta, QR, aceptación en la wallet, webhook y estados.

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

  1. 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).
  2. Creás una oferta con el schema_id y los valores. Te devuelve un credential_id, que identifica a la credencial toda su vida, y un offer_uri.
  3. Mostrás el offer_uri como QR. Vale 24 horas y es de un solo uso.
  4. El ciudadano lo escanea y la wallet recibe la credencial, firmada con la llave de tu workspace.
  5. Recibís el webhook credential.issued con la credencial firmada.
  6. 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

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.

Type to search…

↑↓ navigate↵ selectEsc close