Cómo revocar una Open Badge (y qué pasa con la copia del destinatario)
La revocación en Open Badges: cómo funciona, qué cambia para el destinatario y la forma correcta de manejar «emitida por error» frente a «credencial vencida» frente a «violación de política».
Nacho founded Badges Ninja to make issuing verifiable digital credentials as simple as a single API call — Open Badge v2.0 badges and certificates, minted, hosted, and verifiable without standing up your own issuer infrastructure.
Tarde o temprano, todo programa que emite credenciales digitales tiene que retirar alguna. Un certificado llegó a la persona equivocada. Se descubrió que un alumno hizo trampa en la evaluación final. Terminó el contrato con un socio y las insignias que decían «Certified Partner» ya no deberían ser válidas. Emitir es el camino feliz; revocar es lo que decide si tus credenciales son realmente confiables.
Esta guía explica cómo funciona la revocación en Open Badges, qué ve y qué no ve el destinatario después, y cómo revocar una credencial o unos cientos en https://badges.ninja, desde el panel o desde la API.
Qué significa «revocar» en Open Badges
En la especificación Open Badges v2.0, cada insignia emitida es una aserción (assertion): un pequeño documento JSON-LD alojado en una URL pública que dice «este emisor otorgó esta insignia a este destinatario en esta fecha». Revocar es, simplemente, un cambio en ese documento alojado. La aserción pasa a tener "revoked": true y, opcionalmente, una cadena "revocationReason" que explica el motivo.
Ese diseño tiene una consecuencia importante que sorprende a muchos responsables de programas:
- La aserción alojada es la fuente de verdad. Cualquiera que verifique la credencial al consultar la URL de la aserción o abrir la página de verificación ve el estado de revocada al instante.
- Las copias no se retiran. Si el destinatario descargó la imagen de la insignia o el JSON, o la fijó en un porfolio, ese archivo no cambia. Sigue conteniendo un enlace a tu aserción alojada, así que un verificador que lo siga verá que está revocada, pero una persona que mire un PNG guardado no lo notará.
Por lo tanto, la revocación es una declaración hecha en el punto de verificación, no un borrado. Piensa en ello como estampar «NULO» en el registro maestro en lugar de perseguir cada fotocopia.
Si quieres ver más de cerca el documento en sí, nuestro recorrido por el JSON-LD de Open Badge repasa cada campo.
Revocar, reemitir o eliminar: elige la acción correcta
Antes de hacer clic en nada, decide cuál de las tres acciones encaja con la situación. No son intercambiables.
| Situación | Mejor acción | Por qué |
|---|---|---|
| La credencial se emitió a la persona equivocada o con un error tipográfico | Eliminar (si nunca se envió) o Revocar y luego reemitir | Eliminar borra el registro por completo; revocar conserva un rastro de auditoría |
| El alumno violó una política o la credencial se obtuvo de forma indebida | Revocar, con un motivo | El registro sigue siendo verificable como revocado, que es justo lo que quieres en una disputa |
| La credencial simplemente llegó a su fecha de fin | No hagas nada; define una caducidad al emitir | La caducidad es un evento normal del ciclo de vida, no una revocación |
| Programa cancelado, cohorte anulada | Revocación masiva | Un trabajo, un motivo, aplicado a todos |
| Los datos eran incorrectos pero la credencial es válida | Editar antes de enviar, o revocar y reemitir después de enviar | Mantiene limpia la experiencia del destinatario |
Dos reglas prácticas:
- Prefiere revocar a eliminar en todo lo que sea real. La página pública de una credencial eliminada devuelve un error de «no encontrada». Una revocada sigue resolviendo y dice claramente que está revocada, lo cual es mucho mejor evidencia si alguien pregunta más tarde qué pasó.
- Nunca uses la revocación como sustituto de la caducidad. Si una credencial solo es válida por dos años, define una fecha de caducidad al emitirla. Una insignia que caduca en silencio es distinta de una que fue retirada, y tu página de verificación debería indicar cuál es el caso.
Revocar desde el panel
Para un puñado de credenciales, el panel es la ruta más rápida y no requiere código.
- Inicia sesión y abre Awards en la barra lateral.
- Busca la credencial. La lista muestra el destinatario, el nombre de la insignia, la fecha de emisión y la caducidad, y puedes buscar por destinatario.
- Haz clic en la fila (o en View) para abrir el modal de detalle de la credencial.
- Haz clic en Revoke.
- En el cuadro de confirmación, escribe opcionalmente un motivo y, también opcionalmente, marca Email the recipient that their credential was revoked.
- Confirma.

La credencial permanece en tu lista con una etiqueta roja Revoked junto al destinatario, para que tú y tu equipo siempre veáis qué se retiró. Revocar no devuelve la credencial a la cuota de tu plan. La emitiste, y contó.
Una nota sobre el campo de motivo
El motivo es opcional, pero complétalo. Se guarda con la credencial, aparece como revocationReason en la aserción pública de Open Badges y se incluye en el payload del webhook que reciben tus sistemas. Como es público en la aserción, escríbelo pensando en un lector externo. «Emitida por error» o «Programa cancelado» está bien. «Jane hizo trampa en la pregunta 14» no. Guarda los datos personales en tus propios registros y mantén neutral el motivo público.
¿Debes avisar al destinatario por correo?
Normalmente sí. Un alumno que se entera de que su credencial ya no vale solo cuando un empleador hace clic en el enlace de verificación tiene todo el derecho a estar molesto contigo. La notificación es opcional precisamente porque algunas revocaciones (por ejemplo, una limpieza masiva de credenciales de prueba) no necesitan molestar a nadie. Nuestra recomendación:
- Envía el correo cuando la revocación afecte a una persona real que quizá siga mostrando la credencial.
- Omite el correo cuando estés ordenando datos de prueba internos o anulando credenciales que nunca se enviaron.
Revocar muchas credenciales a la vez
Un programa rara vez necesita revocar una credencial de forma aislada; lo más habitual es una cohorte entera. En la lista de Awards:
- Marca las casillas de las credenciales que quieres retirar.
- Haz clic en Revoke selected en la barra de acciones masivas.
- Añade un motivo, decide si notificar a los destinatarios y confirma.
La revocación masiva se ejecuta como un trabajo duradero en segundo plano, así que unos cientos de credenciales no harán que se agote el tiempo de tu pestaña del navegador. Las credenciales que ya están revocadas se omiten en lugar de hacer fallar el lote, y un trabajo interrumpido a medias puede reanudarse. La misma maquinaria impulsa la emisión masiva desde una hoja de cálculo, que explicamos en cómo emitir Open Badges desde un CSV.
Revocar a través de la API
Si tu sistema de aprendizaje o tu plataforma de RR. HH. decide quién deja de estar certificado, puedes revocar de forma programática. El endpoint es POST /awards/{awardId}/revoke, autenticado con una clave de API (X-Api-Key: bws_<32-hex>) o un token Bearer de Cognito. El ID del award va en la ruta; reason y notify van en el cuerpo JSON y ambos son opcionales.
Con curl:
curl -X POST https://api.badges.ninja/awards/<award-id>/revoke \
-H "X-Api-Key: bws_YOUR_KEY_HERE" \
-H "Content-Type: application/json" \
-d '{"reason":"Issued to the wrong recipient","notify":true}'
# 200 -> {"revoked":true,"awardId":"<award-id>"}
En JavaScript:
const res = await fetch(`https://api.badges.ninja/awards/${awardId}/revoke`, {
method: "POST",
headers: { "X-Api-Key": API_KEY, "Content-Type": "application/json" },
body: JSON.stringify({ reason: "Program cancelled", notify: false }),
});
const { revoked } = await res.json(); // true
Y en Python:
import requests
res = requests.post(
f"https://api.badges.ninja/awards/{award_id}/revoke",
headers={"X-Api-Key": API_KEY},
json={"reason": "Program cancelled", "notify": False},
)
print(res.json()["revoked"]) # True
Algunos detalles prácticos que conviene conocer:
- Es idempotente. Revocar una credencial que ya está revocada devuelve la misma respuesta de éxito y no envía una segunda notificación. Eso la hace segura para llamarla desde un trabajo con reintentos.
- Los motivos se truncan a 500 caracteres.
notifyes false por defecto. No se envía ningún correo a menos que lo pidas.- La revocación masiva está disponible mediante el endpoint masivo con
action: "revoke"y una lista de IDs de awards; devuelve un ID de trabajo que puedes seguir. Los parámetros completos están en la referencia de la API de awards.
Solo necesitas la API cuando la revocación la dispara otro sistema. Para un caso puntual, el panel es más rápido y tiene un paso de confirmación que te protege de un ID mal escrito.
Qué ven el destinatario y el verificador
Después de revocar, esto es lo que cambia y con qué rapidez.
En la página pública de verificación. La página en https://badges.ninja/awards/<award-id> muestra la credencial como revocada, y el título de la página para compartir en redes lleva el prefijo «[Revoked]», para que un enlace compartido no parezca una credencial vigente en una tarjeta de vista previa.
En la aserción Open Badges v2.0. El JSON alojado en https://api.badges.ninja/certify-badge/award/<award-id> ahora incluye "revoked": true, además de "revocationReason" si indicaste uno. Las aserciones revocadas se almacenan en caché solo unos 30 segundos, mientras que las vigentes se guardan cinco minutos, así que el cambio llega rápido a los verificadores.
En la credencial Open Badges 3.0. La revocación también activa el bit de la credencial en una W3C Bitstring Status List, que es como la detectan las carteras digitales y los verificadores de credenciales verificables. Esa lista se almacena en caché brevemente, así que espera una propagación de alrededor de un minuto. Si estás valorando ambas versiones, consulta Open Badges v2 vs v3.
En la copia del propio destinatario. No cambia nada en el archivo que descargó. La imagen de la insignia en su ordenador se ve idéntica. Lo que cambia es el resultado de la verificación: quien haga clic en el enlace o compruebe la credencial de forma programática obtiene la respuesta de revocada. Si lo notificaste, además tiene un correo que explica el motivo.
En LinkedIn. Una credencial añadida a un perfil de LinkedIn es un enlace más metadatos que apunta de vuelta a tu página de verificación. LinkedIn no consulta la revocación por ti, así que la entrada puede seguir en el perfil, pero quien siga el enlace llegará a la página de revocada. Es otra razón para enviar la notificación y pedirle al destinatario que elimine la entrada.
Avisa a tus propios sistemas: webhooks
La revocación rara vez es el final de la historia dentro de tu organización. Puede que el alumno deba perder el acceso a una comunidad, que haya que actualizar un registro de empleador o quitar una etiqueta del CRM. Badges Ninja emite un evento de webhook credential.revoked cuando se revoca una credencial, con la URL del award y el motivo:
{
"awardId": "https://api.badges.ninja/certify-badge/award/<award-id>",
"reason": "Issued in error"
}
Suscríbete y tus sistemas posteriores se mantienen sincronizados sin que nadie tenga que acordarse de actualizarlos. Los detalles de configuración están en la documentación de webhooks, y el modelo de eventos completo lo explicamos en configuración de webhooks para eventos de insignias.
Una política de revocación sencilla que puedes adoptar hoy
Las herramientas son la mitad fácil. La mitad difícil es decidir de antemano cuándo vas a revocar y quién puede hacerlo. Una política breve y por escrito evita discusiones después. Una plantilla que funciona:
- Motivos de revocación. Enuméralos: emitida por error, obtenida mediante conducta indebida, requisito que ya no se cumple (por ejemplo, una membresía vencida) o programa retirado.
- Quién decide. Nombra un rol, no una persona. Limita el permiso de revocar a ese rol.
- Aviso. Indica que los destinatarios reciben un correo con el motivo, salvo que la credencial nunca se haya entregado.
- Apelación. Da a los destinatarios una forma de impugnar la decisión e indica cuánto tardarás en responder. Si una apelación prospera, reemite una credencial nueva en lugar de intentar deshacer la revocación, y el historial se mantiene limpio.
- Registro. Guarda una nota interna de quién revocó qué y por qué, separada del motivo público neutral.
Publica la política en la misma página donde describes la credencial, para que quienes la obtienen conozcan las reglas antes de inscribirse.
Errores comunes que debes evitar
- Eliminar cuando querías revocar. Eliminar es permanente, no se puede deshacer y hace desaparecer la página pública. Úsalo para errores genuinos en credenciales que nadie ha visto.
- Poner datos privados en el motivo. Es público en la aserción.
- Esperar que las copias guardadas cambien. La revocación vive en el punto de verificación. Diles a los destinatarios que quiten la credencial de sus perfiles y porfolios.
- Revocar en lugar de caducar. Usa una fecha de caducidad para credenciales con vigencia limitada.
- Suponer un reembolso. Las credenciales revocadas siguen contando contra la cuota de tu plan.
- Olvidar los sistemas posteriores. Configura el webhook para que los accesos y registros sigan el estado de la credencial.
Preguntas frecuentes
¿Puedo deshacer una revocación? No desde la interfaz. Si revocaste por error, emite una credencial nueva al destinatario. La revocada permanece como parte del rastro de auditoría.
¿Tiene que hacer algo el destinatario? No. Si elegiste notificarle, recibe un correo. Si no, el cambio ocurre en silencio en la página de verificación.
¿Funciona la revocación con credenciales que nunca se enviaron? Sí, aunque para una credencial sin enviar con un error simple quizá prefieras editarla antes de enviarla, o eliminarla si nadie la ha visto.
¿Hay un límite de cuántas puedo revocar? La revocación masiva se ejecuta como un trabajo reanudable en segundo plano, así que los lotes grandes se manejan en una sola operación en lugar de una por una.
¿Verán los empleadores que una credencial fue revocada? Cualquiera que la verifique a través de su URL pública o su aserción ve el estado de revocada y el motivo, si indicaste uno.
Conclusión
Revocar una Open Badge es una acción pequeña con consecuencias reales para la confianza. Hazlo desde el panel cuando se trate de una sola credencial, usa la revocación masiva para una cohorte y recurre a la API o a los webhooks cuando otro sistema sea quien decide. Mantén neutrales los motivos, avisa a quienes necesitan saberlo y recuerda que la revocación cambia lo que ven los verificadores, no los archivos que ya están en manos de los destinatarios.
¿Listo para emitir tu primera credencial verificable? Empieza gratis en badges.ninja: diseñador visual, página pública de verificación, certificado en PDF, salida Open Badge v2.0. Sin tarjeta de crédito.
Cómo se elaboró este artículo
Algunos artículos de este blog se redactan con ayuda de un asistente de IA y luego son revisados, verificados y editados por el equipo de Badges Ninja antes de publicarse. Cada ejemplo de código y cada precio se verifican contra el producto en vivo. Más información sobre nuestro proceso editorial y de IA en nuestra página de proceso editorial .

Sobre el autor
Nacho Coll
Founder & Engineer at Badges Ninja
Nacho founded Badges Ninja to make issuing verifiable digital credentials as simple as a single API call — Open Badge v2.0 badges and certificates, minted, hosted, and verifiable without standing up your own issuer infrastructure. Writes about the Open Badges spec, credential verification, and running a credentialing platform serverless on AWS, from the operator side of the wire.
Más de Nacho Coll
- Open Badges para bootcamps de programación: credenciales verificables a escala de cohorte19 nov 2026 · 12min de lectura
- Configura webhooks para eventos de insignias: integración en tiempo real con tu backend16 nov 2026 · 10min de lectura
- Caducidad y renovación de Open Badges: gestión del ciclo de vida de credenciales con vigencia limitada12 nov 2026 · 12min de lectura


