Saltar al contenido principal
POST
Recibo de acuñación
Crea un evento de recibo criptográficamente firmado y anclado en el registro de transparencia. Los recibos se validan contra el esquema de tipo de recibo registrado antes de la firma.

Tipos de recibos

Encabezados

Respuesta

string
UUID del recibo creado.
string
El nombre del tipo de recibo.
string
active
string
UUID del emisor firmante.
string
Identificador de sujeto.
object
Firma criptográfica: alg, kid, value.
string
Marca de tiempo ISO 8601.

Evento de webhook

Se entrega un evento de webhook receipt.created a todos los puntos finales configurados después de una acuñación exitosa.

Autorizaciones

X-API-Key
string
header
requerido

Clave API para autenticación máquina a máquina

Encabezados

Idempotency-Key
string
requerido

UUID para acuñación idempotente

Cuerpo

application/json
issuer_id
string
requerido

UUID del emisor que firma el recibo

kid
string
requerido

ID de clave de la clave de firma

payload
any
requerido

Carga útil del recibo validada contra el esquema

receipt_type
string
requerido

Nombre del tipo de recibo

subject
string
requerido

Identificador de sujeto

alg
enum<string>

Algoritmo de firma que coincide con la clave.

Opciones disponibles:
Ed25519,
ES256,
ES384,
ES512,
RS256,
RS384,
RS512,
PS256,
PS384,
PS512
metadata
any

Metadatos opcionales

receipt_version
string
retention_policy
string

Respuesta

Recibo creado

receipt_id
string
receipt_type
string
status
string
issuer_id
string
subject
string
signature
object
issued_at
string