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

> 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.

# Emitir credenciales

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](https://sovra-id-docs-1044960690985.us-central1.run.app/primeros-pasos/).
- Saber qué formato vas a emitir. Si todavía no lo decidiste, leé
  [Tipos de credenciales](https://sovra-id-docs-1044960690985.us-central1.run.app/conceptos/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.

```mermaid
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
```

> **La credencial firmada llega una sola vez**
>
> La respuesta de la oferta trae solo una vista previa **sin firmar**. La credencial real
> llega en el webhook `credential.issued`, y no hay forma de volver a pedirla. Si tu
> sistema la necesita, guardala al recibir el evento.

## 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](https://sovra-id-docs-1044960690985.us-central1.run.app/conceptos/esquemas/) y
[Ciclo de vida](https://sovra-id-docs-1044960690985.us-central1.run.app/conceptos/ciclo-de-vida/). Los endpoints, uno por uno, están en la
referencia de API: [Credenciales](https://sovra-id-docs-1044960690985.us-central1.run.app/api/tags/credenciales/) y
[Esquemas](https://sovra-id-docs-1044960690985.us-central1.run.app/api/tags/esquemas/).

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