QRIS Statis Sound Box TechDok dengan Koneksi MQTT dan API

QRIS Statis Sound Box TechDok adalah perangkat notifikasi suara yang membantu merchant mengetahui pembayaran QRIS secara otomatis. Setelah transaksi berhasil diverifikasi oleh server, perangkat akan mengumumkan status dan nominal pembayaran.

Sound Box dapat diintegrasikan menggunakan API, webhook, dan protokol MQTT, sehingga cocok untuk merchant retail, area parkir, loket, restoran, tempat wisata, vending machine, serta sistem pembayaran berbasis IoT.

Cara kerjanya: pelanggan memindai QRIS statis, melakukan pembayaran, PJP mengirim callback ke server, server memvalidasi transaksi, kemudian notifikasi dikirim melalui MQTT ke Sound Box berdasarkan serial number perangkat.

Apa Itu QRIS Statis?

QRIS statis adalah kode QR yang dapat digunakan berulang kali oleh merchant. Pelanggan memindai kode tersebut menggunakan aplikasi pembayaran, memasukkan nominal transaksi, kemudian menyelesaikan pembayaran.

Bank Indonesia menjelaskan bahwa QRIS mendukung Merchant Presented Mode atau MPM dalam bentuk statis dan dinamis. Pada QRIS statis, merchant cukup menampilkan satu kode QR, sementara pelanggan memasukkan sendiri nilai pembayaran. (Bank Indonesia)

Karena nominal dimasukkan oleh pelanggan, merchant perlu memastikan:

• Nominal pembayaran sesuai tagihan
• Transaksi masuk ke merchant yang benar
• Status pembayaran benar-benar berhasil
• Transaksi tidak hanya diperlihatkan melalui tangkapan layar
• Notifikasi berasal dari sistem pembayaran yang terverifikasi

Sound Box membantu memberikan notifikasi operasional, tetapi verifikasi utama tetap dilakukan oleh backend berdasarkan callback resmi dari PJP atau payment gateway.

Fungsi QRIS Statis Sound Box

QRIS Statis Sound Box berfungsi memberikan pemberitahuan suara setiap kali pembayaran berhasil diterima.

Perangkat ini dapat mengumumkan informasi seperti:

“Pembayaran berhasil sebesar lima puluh ribu rupiah.”

Dengan notifikasi tersebut, petugas tidak harus terus-menerus memeriksa aplikasi merchant. Risiko menerima bukti transfer palsu atau tangkapan layar pembayaran juga dapat dikurangi karena notifikasi berasal dari data transaksi yang diterima server.

Namun, Sound Box bukan perangkat pemroses pembayaran. Perangkat hanya mengumumkan transaksi yang telah diperiksa dan dinyatakan berhasil oleh sistem backend.

Cara Kerja Sound Box QRIS Statis TechDok

Alur integrasi dapat dibangun sebagai berikut:

1. Pelanggan memindai QRIS statis milik merchant.
2. Pelanggan memasukkan nominal pembayaran.
3. Transaksi diproses oleh PJP QRIS.
4. PJP atau payment gateway mengirim callback ke endpoint merchant.
5. Backend memverifikasi signature dan data transaksi.
6. Merchant ID dipetakan dengan serial number Sound Box.
7. Server menerbitkan notifikasi melalui broker MQTT.
8. Sound Box menerima pesan dan mengumumkan pembayaran.

Contoh topik MQTT:

{SN}/payment

Contoh penerapan:

TECHDOK-QSB-000123/payment

Setiap serial number dipetakan dengan merchant tertentu. Dengan demikian, satu perangkat tidak menerima notifikasi pembayaran milik merchant lain.

Arsitektur MQTT dan API

Pembayaran QRIS │ ▼
PJP atau Payment Gateway │ │ HTTPS Webhook ▼
Backend Merchant │ ├── Verifikasi signature ├── Validasi Merchant ID ├── Validasi nominal ├── Periksa transaction ID └── Cegah transaksi duplikat │ │ MQTT Publish ▼
Topic: {SN}/payment │ ▼
Sound Box TechDok │ ▼
Notifikasi suara pembayaran

MQTT merupakan protokol client-server dengan pola komunikasi publish–subscribe. Protokol ini dirancang ringan dan cocok digunakan untuk komunikasi machine-to-machine serta perangkat IoT. (OASIS MQTT 5.0)

Contoh Payload Webhook

Format webhook mengikuti dokumentasi PJP atau payment gateway yang digunakan. Berikut contoh konseptual:

{ "transaction_id": "QRIS-20260905-00125", "merchant_id": "MID-TECHDOK-001", "amount": 50000, "currency": "IDR", "status": "SUCCESS", "paid_at": "2026-09-05T13:30:20Z", "signature": "provider-generated-signature"
}

Backend tidak boleh langsung meneruskan setiap payload ke Sound Box. Data harus divalidasi terlebih dahulu, khususnya:

• Signature callback
• Merchant ID
• Transaction ID
• Nominal pembayaran
• Status transaksi
• Waktu pembayaran
• Kemungkinan callback berulang

Jika data valid dan status transaksi adalah SUCCESS, backend menerbitkan pesan MQTT ke perangkat terkait.

Contoh Pesan MQTT

{ "event": "PAYMENT_SUCCESS", "transaction_id": "QRIS-20260905-00125", "merchant_id": "MID-TECHDOK-001", "amount": 50000, "currency": "IDR", "timestamp": "2026-09-05T13:30:20Z"
}

Pesan tersebut diterbitkan ke topik:

TECHDOK-QSB-000123/payment

Format ini merupakan contoh arsitektur integrasi, bukan format baku yang ditetapkan Bank Indonesia. Struktur sebenarnya perlu disesuaikan dengan dokumentasi API penyedia pembayaran.

Mengapa Menggunakan MQTT?

MQTT mempunyai sejumlah keunggulan untuk Sound Box QRIS:

• Ringan untuk perangkat IoT
• Konsumsi bandwidth relatif kecil
• Mendukung komunikasi real-time
• Topik dapat dipisahkan berdasarkan serial number
• Mudah diterapkan untuk banyak perangkat
• Mendukung autentikasi perangkat
• Menyediakan beberapa tingkat Quality of Service
• Dapat dihubungkan dengan backend berbasis cloud

Untuk notifikasi pembayaran, MQTT QoS 1 dapat dipertimbangkan agar pesan dikirim minimal satu kali. Karena mekanisme ini memungkinkan terjadinya pengiriman ulang, backend dan perangkat tetap perlu menerapkan pemeriksaan transaction_id agar pembayaran yang sama tidak diumumkan dua kali.

Pemetaan Merchant dan Serial Number

Setiap QRIS Statis Sound Box TechDok memiliki identitas perangkat berupa serial number.

Contoh pemetaan:

Backend menggunakan Merchant ID pada callback untuk menentukan Sound Box tujuan. Sistem juga dapat dikembangkan agar satu merchant menggunakan beberapa perangkat di beberapa kasir atau cabang.

Fitur Integrasi untuk Developer

REST API dan Webhook

Endpoint webhook menerima pemberitahuan transaksi dari PJP atau payment gateway. Endpoint produksi dapat ditempatkan di server pelanggan atau pada layanan integrasi yang disepakati.

MQTT per Perangkat

Setiap Sound Box menerima pesan melalui topik yang dibatasi berdasarkan serial number. Broker perlu menerapkan Access Control List agar perangkat tidak dapat membaca topik merchant lain.

Device Acknowledgement

Perangkat dapat mengirim konfirmasi setelah notifikasi diterima dan diputar.

{SN}/ack

Contoh payload:

{ "transaction_id": "QRIS-20260905-00125", "status": "ANNOUNCED", "received_at": "2026-09-05T13:30:22Z"
}

Monitoring Perangkat

Jika didukung oleh firmware, dashboard dapat menampilkan:

• Perangkat online atau offline
• Waktu koneksi terakhir
• Versi firmware
• Volume Sound Box
• Riwayat notifikasi
• Merchant yang terhubung
• Status acknowledgement
• Kualitas koneksi jaringan

Pengaturan Jarak Jauh

Perangkat dapat dikembangkan untuk menerima konfigurasi volume, bahasa, format suara, pengujian speaker, dan pembaruan pengaturan dari server.

Keamanan Sound Box QRIS

Integrasi pembayaran perlu menggunakan keamanan berlapis. OWASP merekomendasikan agar konfirmasi pembayaran mengandalkan callback server-to-server, menggunakan transaction ID unik, menolak ID yang telah diproses, dan menyimpan catatan callback. (OWASP Payment Gateway Integration)

Kontrol keamanan yang disarankan meliputi:

• HTTPS/TLS untuk API dan webhook
• TLS untuk koneksi MQTT
• Verifikasi signature callback
• Kredensial unik per perangkat
• Pembatasan akses topik MQTT
• Transaction ID unik
• Idempotency untuk mencegah duplikasi
• Validasi timestamp
• Penyimpanan audit log
• Rotasi kredensial
• Pembatasan percobaan login
• Pemisahan data antarmerchant

Status pembayaran dari browser atau aplikasi pelanggan tidak boleh digunakan sebagai satu-satunya dasar untuk mengumumkan transaksi.

Kegunaan QRIS Statis Sound Box

Perangkat dapat digunakan pada:

• Toko dan minimarket
• Restoran dan kafe
• Loket pembayaran
• Area parkir
• Tempat wisata
• Rumah sakit dan klinik
• Sekolah dan kampus
• Koperasi
• SPBU
• Vending machine
• Gerai layanan publik
• Pedagang dan UMKM

Untuk sistem parkir, Sound Box juga dapat diintegrasikan dengan POS, tiket parkir, payment station, atau dashboard transaksi.

Layanan QRIS Sound Box TechDok

TechDok menyediakan solusi pengadaan dan integrasi yang dapat disesuaikan dengan kebutuhan proyek, meliputi:

• Pengadaan device Sound Box QRIS
• Registrasi serial number
• Pemetaan Merchant ID dan perangkat
• Integrasi REST API
• Pembuatan endpoint webhook
• Integrasi broker MQTT
• Pengembangan backend
• Dashboard monitoring perangkat
• Integrasi POS dan sistem parkir
• Pengujian sandbox
• Dokumentasi untuk developer
• Dukungan implementasi produksi

Ruang lingkup pekerjaan ditentukan berdasarkan jumlah perangkat, dokumentasi PJP, metode autentikasi, kebutuhan broker, infrastruktur pelanggan, dan fitur monitoring yang diperlukan.

Catatan Penting tentang Penerbitan QRIS

TechDok bertindak sebagai penyedia perangkat dan integrator teknologi, bukan sebagai PJP penerbit QRIS—kecuali terdapat kerja sama resmi yang menyatakan berbeda.

Pendaftaran merchant, penerbitan QRIS, pemrosesan transaksi, dan settlement harus dilakukan melalui PJP QRIS berizin Bank Indonesia. Bank Indonesia mengarahkan merchant untuk memilih PJP berizin, mengajukan pendaftaran, dan melalui proses verifikasi sebelum Merchant ID diterbitkan. (Bank Indonesia)

Pesan QRIS Statis Sound Box TechDok

TechDok melayani kebutuhan QRIS Statis Sound Box dengan MQTT dan API untuk implementasi satu merchant maupun banyak perangkat.

Untuk memperoleh analisis teknis dan penawaran, siapkan:

• Nama PJP atau payment gateway
• Dokumentasi API
• Contoh payload webhook
• Metode verifikasi signature
• Jumlah perangkat
• Jumlah merchant
• Lokasi pemasangan
• Kebutuhan broker MQTT
• Kebutuhan dashboard
• Sistem yang akan diintegrasikan

Hubungi TechDok untuk konsultasi pengadaan perangkat, integrasi API, konfigurasi MQTT, dan implementasi QRIS Sound Box sesuai kebutuhan proyek.

Pertanyaan Umum

Apa perbedaan QRIS statis dan dinamis?

QRIS statis menggunakan satu kode secara berulang dan pelanggan memasukkan nominal. Pada QRIS dinamis, nominal transaksi dibentuk oleh sistem dan dimasukkan ke dalam QR pembayaran.

Apakah Sound Box menentukan transaksi berhasil?

Tidak. Sound Box hanya mengumumkan informasi yang diterima dari backend. Status pembayaran harus diverifikasi melalui callback resmi PJP atau payment gateway.

Apakah Sound Box dapat terhubung melalui MQTT?

Bisa. Perangkat dapat berlangganan pada topik khusus berdasarkan serial number, misalnya {SN}/payment.

Apakah tersedia API untuk developer?

Integrasi dapat disediakan melalui REST API, webhook, dan MQTT. Format implementasinya disesuaikan dengan dokumentasi PJP serta arsitektur sistem pelanggan.

Apakah satu merchant dapat menggunakan beberapa perangkat?

Bisa. Satu Merchant ID dapat dipetakan ke beberapa serial number sesuai jumlah kasir, ruangan, atau lokasi operasional.

Apakah QRIS diterbitkan oleh TechDok?

Penerbitan dan aktivasi QRIS dilakukan melalui PJP berizin Bank Indonesia. TechDok menyediakan perangkat serta layanan integrasinya.