nomiDocumentación
SoporteVolver al sitio
  • Primeros pasos

    • Introducción
    • Qué es Nomi
    • Inicio rápido
    • Conceptos
    • Autenticación
  • Credenciales

    • Crear una credencial
    • Emitir una credencial
    • Ciclo de vida
    • Revocar una credencial
    • Verificar una credencial
    • Verificación por QR
  • Distribución

    • Apple Wallet
    • Google Wallet
    • Correo
    • Entrega de credenciales
    • Emisión masiva
  • API

    • Panorama del API
    • Autenticación
    • API de credenciales
    • Destinatarios
    • Verificación
    • Revocación
    • Webhooks
    • Errores
  • Integraciones

    • Moodle
    • WordPress
    • API REST
    • Webhooks
  • Seguridad

    • Autenticación
    • Llaves de API
    • Seguridad de webhooks
    • Protección de datos
    • Buenas prácticas
  • Recursos

    • Preguntas frecuentes
    • Glosario
    • Cambios
  1. Documentación
  2. /
  3. Credenciales
  4. /
  5. Revocar una credencial

Revocar una credencial

Terminar una credencial para siempre, y qué pasa con la copia que ya está en un teléfono.

POST/v1/credentials/{id}/revoke

Termina la credencial para siempre y deja escrito quién lo hizo.

Solicitud

curl -X POST https://api.nomi-tech.com/v1/credentials/cred_…/revoke \
  -H "Authorization: Bearer nomi_sk_live_EXAMPLE" \
  -H "Content-Type: application/json" \
  -d '{ "reason": "membership_cancelled" }'

La respuesta es la credencial, ya en revoked, con revokedAt y revocationReason puestos. La verificación la rechaza desde ese instante — incluida la página pública que un tercero había guardado y, en una credencial académica firmada, la lista de estado que un verificador consulta sin llamarnos.

Revocar no se deshace. Si la relación puede reanudarse —alguien atrasado con un pago, un contratista entre dos encargos—, la llamada es suspend, y resume la devuelve.

Revocar muchas de una vez

POST /v1/credentials/bulk

curl -X POST https://api.nomi-tech.com/v1/credentials/bulk \
  -H "Authorization: Bearer nomi_sk_live_EXAMPLE" \
  -H "Content-Type: application/json" \
  -d '{
    "credentialIds": ["cred_…", "cred_…"],
    "action": "revoke",
    "reason": "programme_ended"
  }'

La respuesta dice cuántas se aplicaron y cuáles fallaron, cada una con su motivo, para que una corrida de cuatrocientas no se detenga en la primera fila mala.

Verificar una credencial

Qué ve un verificador después.

API de revocación

Los endpoints, exactos.

AnteriorCiclo de vidaSiguienteVerificar una credencial

¿Sigues atascado?

Si esta página no te lo resolvió, el centro de ayuda tiene el lado operativo de la misma pregunta — y lo que escribas ahí lo lee una persona.

Ir al centro de ayuda →
nomi

Infraestructura de credenciales digitales. Crea, emite y administra credenciales desde los sistemas que ya usas.

Operado por

País y moneda

Plataforma

  • Cómo funciona
  • Plantillas
  • Ciclo de vida
  • Desarrolladores
  • Precios
  • Preguntas frecuentes
  • Nomi Academic

Credenciales

  • Membresías
  • Carnés de empleado
  • Carnés estudiantiles
  • Eventos y lealtad

Desarrolladores

  • Documentación
  • Inicio rápido
  • Referencia del API
  • Webhooks
  • Integraciones

Soporte

  • Centro de ayuda
  • Apple y Google Wallet
  • Verificación
  • Contactar a soporte

Empresa

  • Solicitar una demo
  • Hablar con Nomi
  • Legal
  • Codingraph
PrivacidadTérminosCookiesSeguridadContacto

© 2026 Codingraph S.A. Todos los derechos reservados.

Nomi is a registered trademark used by Codingraph S.A. under licence.

Se factura en CRC

Apple Wallet y Google Wallet son marcas de sus respectivos dueños.