QRIS Menyalakan Relay | Kartanagari

Panduan IoT: Cara Mengintegrasikan Pembayaran QRIS untuk Mengontrol Relay Otomatis

Di era digital saat ini, QRIS (Quick Response Code Indonesian Standard) telah menjadi pilar utama transaksi non-tunai di Indonesia. Namun, pemanfaatan QRIS kini tidak lagi terbatas pada kasir toko retail atau aplikasi e-commerce. Dalam dunia Internet of Things (IoT), integrasi antara sistem pembayaran digital dan kontrol perangkat keras (hardware) membuka peluang bisnis otomatisasi yang sangat masif.

Bayangkan sebuah sistem di mana konsumen cukup memindai QRIS, melakukan pembayaran, dan beberapa detik kemudian sebuah mesin cuci koin, loker otomatis, vending machine, atau dispenser air pintar langsung menyala sendiri. Kunci di balik otomatisasi fisik ini adalah menghubungkan koneksi data pembayaran QRIS untuk mengaktifkan modul relay.

Sebagai perusahaan rekayasa teknologi dan otomatisasi, PT Karta Nagari Grup akan membagikan panduan dasar dan arsitektur sistem bagaimana cara membuat koneksi QRIS untuk menyalakan relay berbasis mikrokontroler.

Arsitektur Sistem: Bagaimana QRIS Berbicara dengan Hardware?

Untuk menghubungkan dunia finansial cloud dengan dunia fisik hardware, kita memerlukan jembatan komunikasi yang runtut. Berikut adalah diagram alur kerja (workflow) sistem yang ideal:

1. User Side:

   Pelanggan memindai QRIS dinamis yang tertera pada layar perangkat dan menyelesaikan pembayaran di aplikasi m-banking atau e-wallet mereka.

2. Payment Gateway Side:

   Setelah dana masuk, penyedia layanan QRIS (seperti Midtrans, Xendit, atau iPaymu) mendeteksi transaksi tersebut sukses secara real-time.

3. Server Side (Webhook):

   Payment Gateway akan mengirimkan data pemberitahuan (callback/webhook) berupa file JSON ke server web (backend) milik Anda.

4. IoT Broker Side:

   Server Anda memvalidasi data tersebut. Jika status transaksi dinyatakan success atau settlement, server akan mengirimkan perintah instruksi singkat ke mikrokontroler melalui protokol komunikasi IoT seperti MQTT atau HTTP WebSocket.

5. Hardware Side:

   Mikrokontroler yang terhubung ke internet menerima perintah, mengubah status pin GPIO menjadi HIGH, dan memicu sakelar relay untuk menyalakan mesin fisik.

Langkah Demi Langkah Implementasi Teknis

Berikut adalah langkah-langkah praktis untuk mulai merakit prototipe sistem ini:

Langkah 1: Persiapan Komponen Perangkat Keras

Siapkan komponen utama berikut untuk membuat modul penerima perintah pembayaran:

• Mikrokontroler

  ESP32 atau ESP8266 (dipilih karena sudah dilengkapi modul Wi-Fi internal berbiaya murah).

• Modul Relay

  Modul Relay 5V (1-Channel atau sesuai jumlah beban perangkat yang ingin dikontrol).

• Display (Opsional)

  Layar LCD I2C atau OLED SSD1306 untuk menampilkan kode QRIS dinamis dan status transaksi kepada konsumen.

Langkah 2: Registrasi Akun Merchant / Payment Gateway

Anda memerlukan akun Payment Gateway resmi yang mendukung fitur QRIS Dinamis API. Akun tipe sandbox (uji coba) biasanya disediakan secara gratis untuk memfasilitasi tim developer melakukan simulasi transaksi tanpa uang sungguhan selama masa pengembangan program.

Langkah 3: Membuat Skrip Webhook di Server (Backend)

Buatlah sebuah skrip sederhana (bisa menggunakan Node.js, PHP, atau Python) di server web Anda untuk menangkap kiriman data dari Payment Gateway.

Skrip ini bertugas menyaring data kiriman, mengecek apakah nomor ID perangkat cocok, dan memastikan jumlah nominal uang yang ditransfer sudah sesuai. Setelah valid, skrip akan menerbitkan (publish) pesan perintah (misalnya: "relay_on") ke topik MQTT tertentu yang telah didengarkan (subscribe) oleh ESP32.

Langkah 4: Pemrograman Mikrokontroler (ESP32)

Tulis kode program pada Arduino IDE untuk ESP32 Anda. Logika pemrograman dasarnya adalah sebagai berikut:

1. Hubungkan ESP32 ke jaringan Wi-Fi lokal.

2. Hubungkan ke MQTT Broker (seperti HiveMQ, Mosquitto, atau Adafruit IO).

3. Buat fungsi callback MQTT. Jika ESP32 menerima pesan "relay_on", maka program akan mengeksekusi perintah:

   C++

   digitalWrite(RELAY_PIN, LOW); // Menyalakan relay (untuk modul tipe Active Low)
   delay(60000);                 // Membiarkan perangkat menyala (misal: 60 detik)
   digitalWrite(RELAY_PIN, HIGH);// Mematikan kembali relay
   
   

Aspek Keamanan (Security) yang Wajib Diperhatikan

Karena sistem ini melibatkan transaksi finansial dan kendali perangkat fisik, ada beberapa proteksi keamanan yang wajib Anda terapkan pada kode program:

• Verifikasi Signature Key

  Selalu validasi kode signature yang dikirimkan oleh Payment Gateway ke server webhook Anda. Ini penting untuk mencegah peretas (hacker) mengirimkan data transaksi palsu ke server Anda.

• Enkripsi Data Token

  Jangan pernah mengirimkan perintah menyalakan relay dari server ke ESP32 secara teks polos (plain text). Gunakan protokol MQTT yang terenkripsi (MQTTS / TLS) atau sertakan token autentikasi unik yang berubah setiap terjadi transaksi baru.

• Proteksi Hardware (Timeout Handling)

  Berikan logika pembatas waktu otomatis (hardware timeout) di dalam memori ESP32. Jika karena suatu alasan koneksi internet terputus saat mesin sedang menyala, ESP32 harus mampu mematikan relay secara mandiri demi menghindari kerusakan alat atau pemborosan daya.

Kesimpulan

Mengintegrasikan koneksi pembayaran QRIS dengan kontrol modul relay adalah solusi rekayasa teknologi yang sangat aplikatif untuk memodernisasi model bisnis konvensional menjadi serba otomatis dan mandiri (unattended bisnis). Dengan arsitektur webhook server yang aman dan program mikrokontroler yang presisi, Anda dapat menciptakan berbagai inovasi perangkat pintar bernilai ekonomi tinggi.

Ingin Mengembangkan Sistem Otomatisasi Bisnis Berbasis QRIS dan IoT?

PT Karta Nagari Grup menyediakan layanan rekayasa teknologi ujung-ke-ujung (end-to-end), mulai dari perancangan sirkuit perangkat keras kustom, pemrograman firmware mikrokontroler, integrasi API sistem pembayaran, hingga pembuatan dasbor pemantauan IoT terpadu. Hubungi tim engineering kami hari ini untuk mulai mewujudkan inovasi teknologi pintar terbaik bagi bisnis Anda.