Un documento firmado es una credencial sin holder: vos lo firmás y lo entregás. No hay wallet ni flujo de aceptación. Una sola llamada valida los datos, los firma y ancla la firma on-chain (la registra en SovraChain). El resultado es un string, el credential, que cualquiera puede verificar contra la cadena sin depender de Sovra.
Si lo que necesitás es una credencial que viva en la wallet de una persona, andá a Credenciales. La comparación entre los dos está en Documentos firmados.
El flujo de punta a punta
sequenceDiagram
autonumber
participant S as Tu servidor
participant API as API de Sovra
participant C as SovraChain
participant D as Destinatario
S->>API: POST /api/v1/issuer/documents
API-->>S: 201 status signed + credential
API->>C: Ancla la firma
API-->>S: Webhook document.status-changed (anchored)
S-->>D: Entrega el credential o un enlace público
D->>C: Verifica firma, emisor y anclaje
El mismo flujo con curl:
export BASE_URL="https://test-api-sovra.flagonsa.com"
export SOVRA_API_KEY="sovra_sk_..."
# 1. Emitir: valida, firma y responde enseguida con status "signed".
curl -s -X POST "$BASE_URL/api/v1/issuer/documents" \
-H "Authorization: Bearer $SOVRA_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"schema_id": "document_example",
"claims": { "date": "20-08-2026", "idDocument": 1234567,
"content": "Contenido de Prueba", "isConfidential": false }
}'
# Guardá `credential`: ese string ES el documento.
# 2. Esperar el webhook document.status-changed con status "anchored".
# 3. (Opcional) Publicarlo para compartir un enlace. Todo documento nace privado.
curl -s -X PUT -H "Authorization: Bearer $SOVRA_API_KEY" \
"$BASE_URL/api/v1/issuer/documents/$DOCUMENT_ID/visibility/public"
# 4. El destinatario lo lee sin API key, y lo verifica contra la cadena.
curl -s "$BASE_URL/api/v1/documents/$DOCUMENT_ID"Cuatro cosas para saber antes de integrar
- Guardá
credential. Es el documento. El resto de la respuesta se puede volver a pedir. - El anclaje tarda. La emisión responde con
status: "signed", y un verificador rechaza todo lo que no estéanchored. Entregá cuando llegue el webhookdocument.status-changed. - Todo documento nace privado. Volverlo privado cierra el enlace, pero no las copias ya entregadas.
- No hay endpoint de verificación, a propósito. Un veredicto habría que creerlo; una firma se puede comprobar.
Las páginas de esta sección
Crear un esquema
El molde del documento: sus campos, el diseño de la hoja y cuándo está listo para emitir.
Emitir
La llamada, qué guardar y cómo listar lo emitido.
Estados y revocación
signed, anchored, failed y revoked, y cuándo un documento se puede entregar.
Visibilidad y entrega
Publicar, despublicar y las dos formas de hacerle llegar el documento a alguien.
Renderizado
Cómo dibujar la hoja A4 a partir del JSON público.
Verificación
Cómo comprobar un documento contra la cadena, y qué no prueba un resultado válido.
Errores de documentos
Cada código de error, con su causa y su arreglo.
Referencia de la API
Todos los endpoints de documentos firmados.
Recursos
- Colección de Postman: importala y configurá
base_url,api_keyyschema_id. Más detalle en Emitir. - Especificación OpenAPI en vivo:
GET {baseUrl}/openapi/api. - Boilerplate de renderizado
document-render-boilerplate: dibuja la hoja A4 a partir del JSON público. Ver Renderizado.