Anatomi QRIS

Masalahnya

Kita memindai kode QR setiap hari, tapi hampir tidak pernah melihat bagaimana satu kode dibuat. Penjelasan yang beredar di internet berhenti di "ini bitstream, ini matriksnya". Koreksi galat dan masking tetap jadi kotak hitam, bahkan di tutorial untuk developer.

Di Indonesia ada celah kedua. QRIS, standar pembayaran QR nasional, tertempel di meja kasir hampir setiap warung. Isi di balik stiker itu adalah teks biasa yang bisa dibaca, berisi nama merchant, penyedia pembayaran, dan checksum. Parser QRIS yang ada menampilkan teks itu sebagai tabel, lalu selesai.

Saya ingin menyambungkan keduanya. Pilih "nama merchant" di data pembayaran, dan kotak hitam yang membawa huruf-huruf itu langsung menyala di kodenya. Aplikasi ini dibuat untuk dua pembaca sekaligus: orang awam yang penasaran, dan developer yang ingin memeriksa setiap angka dengan tangan.

Yang saya bangun

Encoder yang mengingat letak setiap bit

Saya menulis encoder QR sendiri supaya ia bisa mencatat setiap langkahnya. Untuk setiap kotak, encoder mencatat kenapa kotak itu gelap atau terang: byte dan bit mana yang dibawanya, atau pola tetap mana yang memilikinya, dan apakah mask membaliknya. Semua fitur membaca dari catatan yang sama. Sorotan isian, pelacakan kerusakan, urutan animasi, dan perbandingan mask berasal dari situ. Catatan ini saya bangun dan uji sebelum ada satu layar pun, jadi tidak ada tampilan yang menghitung tata letaknya sendiri lalu berbeda dari yang lain.

Layarnya menampilkan perhitungan yang sebenarnya

Saat menambahkan koreksi galat, encoder menyimpan setiap langkah pembagian panjangnya. Tampilan pembagian menggambar langkah-langkah itu, sehingga pembaca bisa memeriksa satu baris dengan pensil. Encoder juga menilai kedelapan pola mask, walaupun hanya satu yang menang. Galeri mask menampilkan kedelapannya beserta skor penaltinya, jadi selalu cocok dengan pemenangnya.

Setiap kode dicek oleh pustaka independen

Sebuah tes membandingkan hasil saya kotak demi kotak dengan pustaka QR independen. Cakupannya versi 1 sampai 15, keempat tingkat koreksi galat, ketiga mode teks, dan kedelapan mask. Kalau gagal, deploy diblokir. Keduanya berbeda di satu tempat. Untuk satu aturan penalti, pustaka itu membulatkan ke atas, sedangkan spesifikasi ISO membulatkan ke bawah, dan itu bisa mengubah mask pemenang. Saya mengikuti spesifikasi, dan ada tes yang mencatat perbedaan ini supaya tidak terlupakan.

Kode pembayaran yang ditempel tetap di perangkat

Orang menempelkan kode pembayaran asli ke aplikasi ini. Selama dipakai, aplikasi tidak mengirim permintaan jaringan apa pun: tanpa analitik, tanpa pelaporan error, dan font ikut dalam halaman. Pemeriksaan saat build akan gagal kalau ada bagian hasil build yang bisa memanggil jaringan. Teks yang diketik masuk ke URL supaya tautannya bisa dibagikan. Kode QRIS yang ditempel tidak pernah masuk ke URL, dan tombol salin tautan hilang selama kode itu dimuat.

Hasilnya

Anatomi QRIS sudah live dan terbuka untuk umum, dalam bahasa Indonesia dan Inggris. Aplikasi ini menelusuri sembilan tahap, dari teks yang diketik sampai kode yang rusak, lewat slider yang bisa digeser. Kodenya tidak pernah bergeser atau berubah ukuran, jadi di tengah dua tahap kita melihat keduanya setengah jadi. Di lab kerusakan, kita bisa menghapus kotak-kotak dan melihat koreksi galat memperbaikinya secara langsung. Kalau melewati batasnya, kodenya gagal di depan mata, lengkap dengan alasannya. Saya membangunnya dalam sekitar 28 jam selama dua hari pada September 2026.