Penyedia Device Sound Box QRIS dengan Koneksi MQTT dan API

MSM Parking menyediakan device Sound Box QRIS dengan koneksi MQTT dan API untuk kebutuhan merchant, pengembang aplikasi, system integrator, operator parkir, vending machine, loket otomatis, dan berbagai sistem pembayaran berbasis IoT.

Perangkat ini dapat menerima informasi transaksi dari server melalui webhook dan broker MQTT. Setelah pembayaran berhasil diverifikasi, Sound Box memberikan notifikasi suara sehingga petugas atau pengguna tidak hanya bergantung pada tampilan aplikasi.

Solusi dapat dikembangkan untuk satu perangkat maupun implementasi banyak device dengan identitas serial number yang berbeda.

Ringkasnya API menerima status pembayaran, server memvalidasi transaksi, MQTT meneruskan pesan ke perangkat berdasarkan serial number, kemudian Sound Box mengumumkan pembayaran berhasil.

Apa Itu Sound Box QRIS MQTT?

Sound Box QRIS MQTT adalah perangkat notifikasi pembayaran yang terhubung dengan server menggunakan protokol Message Queuing Telemetry Transport atau MQTT.

MQTT menggunakan mekanisme publish–subscribe. Server menerbitkan pesan ke suatu topik, sedangkan perangkat yang telah terdaftar berlangganan pada topik tersebut. Spesifikasi OASIS menjelaskan MQTT sebagai protokol client-server publish–subscribe yang ringan dan sesuai untuk komunikasi machine-to-machine serta perangkat IoT dengan sumber daya atau bandwidth terbatas. (OASIS MQTT 5.0)

Pada implementasi MSM Parking, setiap Sound Box dapat dipetakan menggunakan serial number atau SN, misalnya

{SN}/payment

Contoh topik untuk perangkat tertentu

MSMQRIS000123/payment

Dengan pemisahan tersebut, setiap device hanya menerima pesan transaksi yang ditujukan kepadanya.

Cara Kerja Integrasi Sound Box QRIS

Arsitektur Sound Box QRIS berbasis MQTT dan API dapat menggunakan alur berikut

1. Pelanggan melakukan pembayaran melalui QRIS.
2. Penyedia layanan pembayaran memproses transaksi.
3. Status transaksi dikirim ke endpoint webhook milik merchant atau integrator.
4. Backend memverifikasi autentikasi, nominal, ID transaksi, status, dan merchant.
5. Jika status dinyatakan berhasil, backend menerbitkan pesan ke broker MQTT.
6. Pesan dikirim melalui topik {SN}/payment.
7. Sound Box yang terdaftar menerima pesan dan mengumumkan nominal pembayaran.

Status seperti PENDING atau FAILED dapat dicatat oleh backend, tetapi notifikasi pembayaran berhasil sebaiknya hanya diterbitkan setelah server menerima dan memverifikasi status final SUCCESS atau status ekuivalen dari PJP.

Verifikasi harus dilakukan di sisi server. OWASP merekomendasikan agar pemenuhan transaksi hanya mempercayai callback server-to-server, menggunakan ID transaksi unik, menolak transaksi kedaluwarsa atau yang telah diproses, serta menyimpan log callback. (OWASP Payment Gateway Integration)

Contoh Arsitektur API dan MQTT

Berikut gambaran sederhana arsitektur integrasinya

PJP atau Payment Gateway │ │ HTTPS Webhook ▼
Backend Merchant atau Integrator │ ├── Verifikasi signature ├── Validasi transaction_id ├── Periksa merchant dan nominal ├── Cegah duplikasi callback └── Pemetaan Merchant ID → Serial Number │ │ MQTT Publish ▼
Topic: {SN}/payment │ ▼
Sound Box QRIS │ ▼
“Pembayaran berhasil sebesar Rp50.000”

Arsitektur tersebut memisahkan proses pembayaran dari komunikasi perangkat. Kredensial pembayaran tidak perlu disimpan di Sound Box karena perangkat hanya menerima pesan yang sudah divalidasi oleh backend.

Contoh Payload Webhook

Struktur payload aktual harus mengikuti dokumentasi PJP atau payment gateway yang digunakan. Contoh konseptual

{ "transaction_id": "TRX-20260905-000123", "merchant_id": "MID-00123", "amount": 50000, "currency": "IDR", "status": "SUCCESS", "paid_at": "2026-09-05T14:30:25Z", "signature": "provider-generated-signature"
}

Backend kemudian mencari serial number yang terhubung dengan merchant tersebut dan membentuk pesan MQTT.

{ "event": "PAYMENT_SUCCESS", "transaction_id": "TRX-20260905-000123", "amount": 50000, "currency": "IDR", "timestamp": "2026-09-05T14:30:25Z"
}

Pesan tersebut dipublikasikan ke

MSMQRIS000123/payment

Contoh ini bukan format baku QRIS. Nama field, metode autentikasi, signature, dan status transaksi harus disesuaikan dengan kontrak API penyedia pembayaran.

Dukungan QRIS Statis dan Dinamis

Bank Indonesia membagi QRIS menjadi model Merchant Presented Mode dan Consumer Presented Mode. Pada MPM, kode QR ditampilkan oleh merchant untuk dipindai pelanggan. MPM tersedia dalam bentuk statis dan dinamis. (Bank Indonesia – QRIS)

QRIS Statis

Pada QRIS statis, satu kode digunakan berulang kali. Pelanggan biasanya memasukkan nominal pembayaran secara manual.

Sound Box berfungsi mengumumkan transaksi setelah server memperoleh callback dari penyedia pembayaran. Sistem tetap harus mencocokkan merchant, nilai transaksi, waktu, dan ID transaksi sebelum mengirim notifikasi ke perangkat.

QRIS Dinamis

Pada QRIS dinamis, nominal transaksi ditentukan oleh aplikasi dan dimasukkan ke dalam QR pembayaran. Dokumentasi Open API QRIS tertentu, misalnya, menunjukkan bahwa aplikasi dapat membuat invoice dan menerima konten QRIS untuk ditampilkan sebagai QR Code. Implementasinya harus mengikuti dokumentasi PJP yang digunakan. (Dokumentasi Create Invoice QRIS)

QRIS dinamis lebih mudah dihubungkan dengan

• Sistem parkir otomatis
• Mesin pembayaran mandiri
• Vending machine
• Aplikasi kasir atau POS
• Sistem tiket dan loket
• Mesin akses berbayar
• Kios pembayaran mandiri

Fitur Integrasi untuk Developer

1. REST API dan Webhook

API digunakan untuk pertukaran data antara aplikasi merchant, payment gateway, dan backend integrator. Webhook menerima perubahan status transaksi secara server-to-server.

Endpoint produksi dapat ditempatkan pada infrastruktur milik pelanggan sehingga pelanggan tetap memiliki kendali atas data dan log transaksi.

2. MQTT Berdasarkan Serial Number

Setiap perangkat mendapatkan serial number unik. Serial number digunakan untuk aktivasi device dan pemetaan antara merchant dengan topik MQTT.

Struktur topik yang disarankan

{SN}/payment
{SN}/command
{SN}/ack

Untuk implementasi minimal, topik {SN}/payment sudah dapat digunakan sebagai jalur notifikasi transaksi.

3. Quality of Service

MQTT menyediakan tiga tingkat Quality of Service. Untuk notifikasi pembayaran, QoS 1 dapat dipertimbangkan karena pesan dikirim minimal satu kali dan memerlukan pengakuan penerimaan. Konsekuensinya, sistem harus siap menangani kemungkinan pesan duplikat. (OASIS MQTT 5.0)

Karena itu, Sound Box atau backend sebaiknya menyimpan transaction_id terakhir agar transaksi yang sama tidak diumumkan dua kali.

4. Device Acknowledgement

Setelah menerima pesan, perangkat dapat mengirim acknowledgement melalui topik

{SN}/ack

Contoh

{ "transaction_id": "TRX-20260905-000123", "device_status": "ANNOUNCED", "received_at": "2026-09-05T14:30:27Z"
}

Fitur ini membantu pengelola mengetahui apakah pesan telah sampai dan diputar oleh perangkat.

5. Remote Configuration

Jika firmware perangkat mendukung, konfigurasi berikut dapat dikelola dari server

• Volume suara
• Pilihan bahasa
• Format penyebutan nominal
• Identitas merchant
• Status koneksi
• Pembaruan konfigurasi
• Restart perangkat
• Pengujian suara jarak jauh

Keamanan Integrasi API dan MQTT

Sistem pembayaran tidak boleh hanya mengandalkan status yang dikirim oleh browser, aplikasi pelanggan, atau nominal yang tampil pada layar.

OWASP merekomendasikan penggunaan HTTPS pada REST API untuk melindungi kredensial dan integritas data selama transmisi. (OWASP REST Security)

Beberapa kontrol keamanan yang perlu diterapkan meliputi

• HTTPS/TLS pada endpoint API dan webhook
• TLS pada koneksi MQTT
• Verifikasi signature callback
• Username dan password unik per perangkat
• Access Control List untuk setiap topik
• Validasi Merchant ID dan serial number
• Transaction ID unik
• Pemeriksaan timestamp dan masa berlaku
• Idempotency untuk mencegah notifikasi ganda
• Penyimpanan audit log
• Pembatasan percobaan autentikasi
• Rotasi kredensial perangkat
• Penolakan payload yang tidak sesuai skema

Perangkat dengan SN tertentu tidak boleh dapat berlangganan pada topik milik perangkat atau merchant lain.

Integrasi dengan Sistem Parkir

Sebagai perusahaan yang berpengalaman dalam sistem parkir dan akses otomatis, MSM Parking dapat mengembangkan Sound Box QRIS sebagai bagian dari ekosistem

• Sistem parkir cashless
• Mesin tiket parkir
• Payment station
• POS parkir
• Gerbang otomatis
• Palang parkir
• Sistem pembayaran di pintu keluar
• Parkir on-street
• Sistem pembayaran tenant
• Mesin akses berbasis pembayaran

Setelah transaksi terverifikasi, backend tidak hanya dapat mengirim notifikasi suara, tetapi juga meneruskan perintah ke sistem lain. Contohnya membuka palang, memvalidasi tiket, mengaktifkan mesin, atau memperbarui status pesanan.

Perintah operasional tetap harus dipisahkan dari pesan notifikasi dan dilindungi dengan autentikasi serta otorisasi yang memadai.

Layanan Penyediaan Sound Box QRIS MSM Parking

MSM Parking menyediakan layanan yang dapat disesuaikan dengan kebutuhan proyek, meliputi

• Pengadaan device Sound Box QRIS
• Registrasi dan pemetaan serial number
• Penyediaan atau integrasi broker MQTT
• Pembuatan endpoint webhook
• Pengembangan REST API
• Integrasi dengan PJP atau payment gateway
• Integrasi aplikasi POS
• Integrasi sistem parkir dan access control
• Dashboard pemantauan perangkat
• Pengujian sandbox dan produksi
• Dokumentasi integrasi untuk developer
• Dukungan implementasi dan pemeliharaan

Ruang lingkup akhir ditentukan berdasarkan dokumentasi API PJP, jumlah perangkat, metode QRIS, format callback, kebutuhan dashboard, serta kebijakan keamanan pelanggan.

MSM Parking Bukan Penerbit QRIS

MSM Parking bertindak sebagai penyedia perangkat dan integrator teknologi. Pendaftaran merchant, penerbitan kode QRIS, settlement, serta pemrosesan pembayaran harus dilakukan melalui Penyedia Jasa Pembayaran yang berizin Bank Indonesia.

Bank Indonesia mengarahkan calon merchant untuk memilih PJP QRIS berizin, melengkapi pendaftaran, dan menunggu proses verifikasi serta pembuatan Merchant ID. (Bank Indonesia – Cara Membuat QRIS)

Dengan pembagian tersebut, merchant memperoleh layanan pembayaran dari lembaga yang berwenang, sedangkan MSM Parking menyediakan perangkat, konektivitas, dan integrasi teknisnya.

Mengapa Menggunakan MQTT untuk Sound Box QRIS?

MQTT cocok digunakan karena

• Ringan untuk perangkat IoT
• Menggunakan model publish–subscribe
• Mendukung pemisahan topik per perangkat
• Dapat bekerja pada jaringan dengan bandwidth terbatas
• Mendukung beberapa tingkat jaminan pengiriman
• Mudah diintegrasikan dengan backend
• Dapat digunakan untuk implementasi banyak device

Namun, MQTT bukan mesin verifikasi pembayaran. Keputusan bahwa transaksi telah berhasil tetap harus berasal dari callback server-to-server yang telah diverifikasi.

Konsultasi Integrasi Sound Box QRIS

Apabila perusahaan Anda membutuhkan penyedia Sound Box QRIS dengan koneksi MQTT dan API, MSM Parking siap membantu dari tahap analisis kebutuhan, pengadaan perangkat, pengembangan endpoint, pemetaan merchant–SN, hingga pengujian integrasi.

Siapkan informasi berikut agar proses analisis lebih cepat

• Nama PJP atau payment gateway
• Dokumentasi API dan webhook
• Contoh payload callback
• Metode autentikasi atau signature
• Jumlah Sound Box
• Lokasi pemasangan
• Jenis QRIS statis atau dinamis
• Sistem yang akan diintegrasikan
• Kebutuhan broker MQTT
• Format suara dan bahasa
• Target waktu implementasi

Hubungi MSM Parking untuk mendapatkan konsultasi teknis dan penawaran Sound Box QRIS sesuai kebutuhan proyek Anda.

Pertanyaan Umum

Apakah Sound Box memverifikasi pembayaran secara langsung?

Tidak. Verifikasi transaksi dilakukan oleh backend berdasarkan callback resmi dari PJP atau payment gateway. Sound Box menerima hasil yang telah divalidasi melalui MQTT.

Apakah satu merchant dapat menggunakan beberapa Sound Box?

Bisa. Backend dapat memetakan satu merchant ke beberapa serial number, sesuai konfigurasi dan kebutuhan lokasi.

Apakah satu Sound Box dapat menerima transaksi merchant lain?

Secara desain sebaiknya tidak. Setiap perangkat harus dibatasi menggunakan kredensial dan izin topik agar hanya menerima pesan yang menjadi haknya.

Apakah MQTT dapat dihubungkan dengan FastAPI?

Bisa. FastAPI dapat digunakan untuk menerima webhook dan menjalankan proses validasi, sedangkan MQTT client menerbitkan pesan ke broker setelah transaksi dinyatakan valid.

Apakah QRIS disediakan langsung oleh MSM Parking?

MSM Parking menyediakan device dan integrasi teknologinya. Registrasi merchant serta layanan pembayaran QRIS harus menggunakan PJP berizin Bank Indonesia.