Cara Mencabut Open Badge (dan Apa yang Terjadi pada Salinan Penerima)
Pencabutan (revocation) di Open Badges: cara kerjanya, apa yang berubah bagi penerima, dan cara yang tepat menangani kasus «diterbitkan karena kesalahan», «kredensial kedaluwarsa», dan «pelanggaran kebijakan».
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.
Cepat atau lambat, setiap program yang menerbitkan kredensial digital harus menarik kembali satu kredensial. Sertifikat terkirim ke orang yang salah. Seorang peserta ketahuan menyontek saat penilaian akhir. Kontrak mitra berakhir dan lencana bertuliskan “Certified Partner” seharusnya tidak berlaku lagi. Menerbitkan adalah bagian yang menyenangkan; pencabutan adalah bagian yang menentukan apakah kredensial Anda benar-benar bisa dipercaya.
Panduan ini menjelaskan cara kerja pencabutan di Open Badges, apa yang dilihat dan tidak dilihat penerima setelahnya, serta cara mencabut satu kredensial atau beberapa ratus sekaligus di https://badges.ninja, lewat dasbor maupun API.
Apa arti “revoke” di Open Badges
Dalam spesifikasi Open Badges v2.0, setiap lencana yang diterbitkan adalah sebuah assertion: dokumen JSON-LD kecil yang di-host di URL publik dan menyatakan “penerbit ini memberikan lencana ini kepada penerima ini pada tanggal ini.” Pencabutan hanyalah perubahan pada dokumen yang di-host tersebut. Assertion mendapat "revoked": true, dan secara opsional string "revocationReason" yang menjelaskan alasannya.
Desain ini punya konsekuensi penting yang sering mengejutkan pemilik program:
- Assertion yang di-host adalah sumber kebenaran. Siapa pun yang memverifikasi kredensial dengan membuka URL assertion atau halaman verifikasi langsung melihat status dicabut.
- Salinan tidak ditarik kembali. Jika penerima mengunduh gambar lencana atau JSON-nya, atau menyematkannya ke portofolio, berkas itu tidak berubah. Berkas tersebut masih memuat tautan ke assertion Anda, sehingga verifikator yang mengikuti tautan akan melihat statusnya dicabut, tetapi orang yang hanya melihat PNG yang tersimpan tidak.
Jadi pencabutan adalah pernyataan di endpoint verifikasi, bukan penghapusan. Bayangkan seperti membubuhkan cap “VOID” pada catatan induk, bukan mengejar setiap fotokopi.
Jika Anda ingin melihat dokumennya lebih dekat, panduan JSON-LD Open Badge kami membahas setiap field.
Revoke, terbitkan ulang, atau hapus: pilih tindakan yang tepat
Sebelum mengklik apa pun, tentukan mana dari tiga tindakan yang cocok dengan situasinya. Ketiganya tidak bisa saling menggantikan.
| Situasi | Tindakan terbaik | Alasan |
|---|---|---|
| Kredensial diterbitkan ke orang yang salah atau ada salah ketik | Hapus (jika belum dikirim) atau Revoke, lalu terbitkan ulang | Hapus menghilangkan catatan sepenuhnya; revoke menjaga jejak audit |
| Peserta melanggar kebijakan atau kredensial diperoleh secara tidak sah | Revoke, dengan alasan | Catatan tetap dapat diverifikasi sebagai dicabut, yang Anda butuhkan saat terjadi sengketa |
| Kredensial hanya mencapai tanggal berakhirnya | Tidak perlu apa-apa; atur masa berlaku saat menerbitkan | Kedaluwarsa adalah siklus hidup normal, bukan pencabutan |
| Program dibatalkan, kohort dibatalkan | Bulk revoke | Satu job, satu alasan, berlaku untuk semua |
| Detail salah tetapi kredensial selebihnya valid | Edit sebelum dikirim, atau revoke lalu terbitkan ulang setelah dikirim | Menjaga pengalaman penerima tetap bersih |
Dua aturan praktis:
- Pilih revoke daripada hapus untuk apa pun yang nyata. Halaman publik kredensial yang dihapus mengembalikan error not-found. Kredensial yang dicabut tetap bisa dibuka dan jelas menyatakan bahwa ia dicabut, bukti yang jauh lebih baik jika kelak ada yang menanyakan apa yang terjadi.
- Jangan pernah memakai pencabutan sebagai pengganti kedaluwarsa. Jika kredensial hanya berlaku dua tahun, atur tanggal kedaluwarsa saat menerbitkannya. Lencana yang berakhir diam-diam berbeda dengan yang ditarik, dan halaman verifikasi Anda harus menyatakan mana yang terjadi.
Mencabut dari dasbor
Untuk beberapa kredensial saja, dasbor adalah jalan tercepat dan tidak perlu kode.
- Masuk lalu buka Awards dari sidebar.
- Temukan kredensialnya. Daftar menampilkan penerima, nama lencana, tanggal terbit, dan masa berlaku, dan Anda bisa mencari berdasarkan penerima.
- Klik baris tersebut (atau View) untuk membuka modal detail kredensial.
- Klik Revoke.
- Pada dialog konfirmasi, isi alasan (opsional), dan centang Email the recipient that their credential was revoked jika perlu.
- Konfirmasi.

Kredensial tetap ada di daftar Anda dengan chip merah Revoked di samping penerima, sehingga Anda dan tim selalu bisa melihat apa yang ditarik. Pencabutan tidak mengembalikan kredensial ke kuota paket Anda. Anda sudah menerbitkannya, dan itu sudah dihitung.
Catatan tentang kolom alasan
Alasan bersifat opsional, tetapi isilah. Alasan disimpan bersama kredensial, muncul sebagai revocationReason pada assertion Open Badges yang publik, dan disertakan dalam payload webhook yang diterima sistem Anda. Karena bersifat publik pada assertion, tulislah seolah untuk pembaca luar. “Issued in error” atau “Program cancelled” tidak masalah. “Jane menyontek di soal 14” tidak boleh. Simpan detail pribadi di catatan internal Anda dan jaga alasan publik tetap netral.
Haruskah penerima diberi email?
Biasanya ya. Peserta yang baru tahu kredensialnya mati ketika seorang perekrut mengklik tautan verifikasi berhak kecewa kepada Anda. Notifikasi ini bersifat opt-in justru karena sebagian pencabutan (misalnya pembersihan massal award uji coba) tidak perlu mengganggu siapa pun. Panduan kami:
- Kirim email jika pencabutan memengaruhi orang sungguhan yang mungkin masih menampilkan kredensial tersebut.
- Lewati email jika Anda sedang merapikan data uji internal atau membatalkan kredensial yang belum pernah dikirim.
Mencabut banyak kredensial sekaligus
Program jarang perlu mencabut satu kredensial saja; lebih sering satu kohort penuh. Di daftar Awards:
- Centang kotak kredensial yang ingin ditarik.
- Klik Revoke selected pada bilah aksi massal.
- Tambahkan alasan dan tentukan apakah penerima akan diberi tahu, lalu konfirmasi.
Pencabutan massal berjalan sebagai job latar belakang yang tahan gangguan, jadi beberapa ratus kredensial tidak akan membuat tab browser Anda timeout. Kredensial yang sudah dicabut dilewati alih-alih menggagalkan batch, dan job yang terhenti di tengah jalan bisa dilanjutkan. Mekanisme yang sama menjalankan penerbitan massal dari spreadsheet, yang kami bahas di cara menerbitkan Open Badges dari CSV.
Mencabut lewat API
Jika sistem pembelajaran atau platform HR Anda yang menentukan siapa yang tidak lagi tersertifikasi, Anda bisa mencabut secara terprogram. Endpoint-nya adalah POST /awards/{awardId}/revoke, diautentikasi dengan API key (X-Api-Key: bws_<32-hex>) atau Bearer token Cognito. ID award diletakkan di path; reason dan notify ada di body JSON dan keduanya opsional.
Dengan 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>"}
Dalam 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
Dan dalam 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
Beberapa detail praktis yang perlu diketahui:
- Bersifat idempoten. Mencabut kredensial yang sudah dicabut mengembalikan respons sukses yang sama dan tidak mengirim notifikasi kedua. Ini aman dipanggil dari job yang melakukan retry.
- Alasan dipotong hingga 500 karakter.
notifysecara default false. Tidak ada email yang dikirim kecuali Anda memintanya.- Bulk revoke tersedia lewat endpoint massal dengan
action: "revoke"dan daftar ID award; endpoint ini mengembalikan ID job yang dapat Anda pantau. Parameter lengkapnya ada di referensi API awards.
Anda hanya memerlukan API ketika pencabutan digerakkan oleh sistem lain. Untuk kasus sekali-sekali, dasbor lebih cepat dan memiliki langkah konfirmasi yang melindungi Anda dari ID yang salah ketik.
Apa yang dilihat penerima dan verifikator
Setelah Anda mencabut, inilah yang berubah dan seberapa cepat.
Di halaman verifikasi publik. Halaman di https://badges.ninja/awards/<award-id> menampilkan kredensial sebagai dicabut, dan judul halaman untuk berbagi di media sosial diawali “[Revoked]” agar tautan yang dibagikan tidak tampak seperti kredensial aktif di kartu pratinjau.
Di assertion Open Badges v2.0. JSON yang di-host di https://api.badges.ninja/certify-badge/award/<award-id> kini memuat "revoked": true, ditambah "revocationReason" jika Anda mengisinya. Assertion yang dicabut di-cache hanya sekitar 30 detik, sedangkan yang aktif di-cache lima menit, sehingga perubahan cepat sampai ke verifikator.
Di kredensial Open Badges 3.0. Pencabutan juga membalik bit kredensial pada W3C Bitstring Status List, yang digunakan dompet verifiable credential dan verifikator untuk mendeteksinya. Daftar itu di-cache singkat, jadi perkirakan propagasi dalam sekitar satu menit. Jika Anda menimbang kedua versi, lihat Open Badges v2 vs v3.
Di salinan milik penerima. Tidak ada yang berubah pada berkas yang mereka unduh. Gambar lencana di laptop mereka tampak sama persis. Yang berubah adalah hasil verifikasi: siapa pun yang mengeklik tautan atau memeriksa kredensial secara terprogram mendapat jawaban dicabut. Jika Anda memberi tahu mereka, mereka juga menerima email yang menjelaskan alasannya.
Di LinkedIn. Kredensial yang ditambahkan ke profil LinkedIn adalah tautan beserta metadata yang mengarah ke halaman verifikasi Anda. LinkedIn tidak memeriksa pencabutan atas nama Anda, sehingga entri bisa tetap ada di profil, tetapi siapa pun yang mengikuti tautan akan tiba di halaman yang menyatakan dicabut. Ini alasan lain untuk mengirim notifikasi dan meminta penerima menghapus entri tersebut.
Beri tahu sistem Anda sendiri: webhook
Pencabutan jarang menjadi akhir cerita di dalam organisasi Anda. Peserta mungkin perlu kehilangan akses ke sebuah komunitas, catatan pemberi kerja perlu diperbarui, atau tag CRM perlu dihapus. Badges Ninja mengirim event webhook credential.revoked ketika kredensial dicabut, dengan URL award dan alasannya:
{
"awardId": "https://api.badges.ninja/certify-badge/award/<award-id>",
"reason": "Issued in error"
}
Berlanggananlah ke event ini dan sistem hilir Anda tetap sinkron tanpa perlu ada yang ingat memperbaruinya. Detail pengaturan ada di dokumentasi webhook, dan model event yang lebih luas kami bahas di pengaturan webhook untuk event lencana.
Kebijakan pencabutan sederhana yang bisa Anda terapkan hari ini
Alat adalah separuh yang mudah. Separuh yang lebih sulit adalah memutuskan sejak awal kapan Anda akan mencabut dan siapa yang berwenang. Kebijakan tertulis yang singkat mencegah perdebatan di kemudian hari. Templat yang bisa dipakai:
- Dasar pencabutan. Daftarkan: diterbitkan karena kesalahan, diperoleh lewat pelanggaran, persyaratan tidak lagi terpenuhi (misalnya keanggotaan berakhir), atau program ditarik.
- Siapa yang memutuskan. Sebut peran, bukan orang. Batasi izin revoke pada peran tersebut.
- Pemberitahuan. Nyatakan bahwa penerima diberi tahu lewat email beserta alasannya, kecuali kredensial belum pernah dikirim.
- Banding. Beri penerima cara untuk menyanggah keputusan dan sebutkan berapa lama Anda akan menanggapi. Jika banding berhasil, terbitkan kredensial baru alih-alih mencoba membatalkan pencabutan, sehingga riwayat tetap bersih.
- Catatan. Simpan catatan internal tentang siapa yang mencabut apa dan mengapa, terpisah dari alasan publik yang netral.
Publikasikan kebijakan itu di halaman yang sama tempat Anda menjelaskan kredensial, agar penerima tahu aturannya sebelum mendaftar.
Kesalahan umum yang perlu dihindari
- Menghapus padahal maksudnya mencabut. Hapus bersifat permanen dan tidak bisa dibatalkan, serta membuat halaman publik hilang. Gunakan hanya untuk kesalahan murni pada kredensial yang belum dilihat siapa pun.
- Menaruh detail pribadi di alasan. Alasan bersifat publik pada assertion.
- Mengharapkan salinan tersimpan ikut berubah. Pencabutan berada di endpoint verifikasi. Minta penerima menghapus kredensial dari profil dan portofolio mereka.
- Mencabut padahal seharusnya kedaluwarsa. Gunakan tanggal kedaluwarsa untuk kredensial yang berbatas waktu.
- Mengira ada pengembalian. Kredensial yang dicabut tetap dihitung terhadap kuota paket Anda.
- Melupakan sistem hilir. Pasang webhook agar akses dan catatan mengikuti status kredensial.
Pertanyaan yang sering diajukan
Bisakah saya membatalkan pencabutan? Tidak lewat antarmuka. Jika Anda mencabut karena keliru, terbitkan kredensial baru untuk penerima. Yang dicabut tetap ada sebagai bagian dari jejak audit.
Apakah penerima perlu melakukan sesuatu? Tidak. Jika Anda memilih memberi tahu mereka, mereka menerima email. Jika tidak, perubahan terjadi diam-diam di halaman verifikasi.
Apakah pencabutan berlaku untuk kredensial yang belum pernah dikirim? Ya, meskipun untuk kredensial belum terkirim dengan kesalahan sederhana Anda mungkin lebih suka mengeditnya sebelum dikirim, atau menghapusnya jika belum ada yang melihat.
Adakah batas jumlah yang bisa saya cabut? Pencabutan massal berjalan sebagai job latar belakang yang dapat dilanjutkan, sehingga batch besar ditangani dalam satu operasi, bukan satu per satu.
Apakah pemberi kerja akan melihat bahwa kredensial telah dicabut? Siapa pun yang memverifikasinya lewat URL publik atau assertion akan melihat status dicabut beserta alasannya, jika Anda mengisinya.
Kesimpulan
Mencabut Open Badge adalah tindakan kecil dengan dampak nyata bagi kepercayaan. Lakukan dari dasbor untuk satu kredensial, gunakan bulk revoke untuk satu kohort, dan gunakan API atau webhook ketika sistem lain yang memegang keputusan. Jaga alasan tetap netral, beri tahu orang yang perlu tahu, dan ingat bahwa pencabutan mengubah apa yang dilihat verifikator, bukan berkas yang sudah ada di tangan penerima.
Siap menerbitkan kredensial terverifikasi pertama Anda? Mulai gratis di badges.ninja — desainer visual, halaman verifikasi publik, sertifikat PDF, keluaran Open Badge v2.0. Tanpa kartu kredit.
Bagaimana artikel ini dibuat
Beberapa artikel di blog ini disusun dengan bantuan asisten AI, lalu ditinjau, diperiksa faktanya, dan disunting oleh tim Badges Ninja sebelum dipublikasikan. Setiap contoh kode dan harga diverifikasi terhadap produk yang aktif. Baca selengkapnya tentang proses editorial dan AI kami di halaman proses editorial .

Tentang penulis
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.
Lainnya dari Nacho Coll
- Open Badges untuk Bootcamp Coding: Menerbitkan Kredensial Terverifikasi dalam Skala Angkatan19 Nov 2026 · 10menit baca
- Menyiapkan Webhook untuk Peristiwa Lencana: Integrasi Real-Time dengan Backend Anda16 Nov 2026 · 8menit baca
- Masa Berlaku dan Perpanjangan Open Badge: Manajemen Siklus Hidup Kredensial Berbatas Waktu12 Nov 2026 · 10menit baca


