Pay Relay Hub

Aplikasi Android Peringkas Notifikasi & Webhook Relay yang Kuat, Aman, dan Real-Time.

---

Pay Relay Hub adalah solusi aplikasi Android berbasis React Native yang dirancang secara khusus untuk menangkap notifikasi (seperti dari aplikasi E-Wallet, mutasi bank, atau aplikasi PPOB) dan meneruskannya (relay) secara otomatis ke Webhook server Anda.

Dibangun dengan arsitektur Background Service yang tangguh, sistem akan terus memantau masuknya transaksi walaupun aplikasi tidak sedang dibuka atau ketika layar ponsel mati.

Daftar Isi

• Demo Aplikasi
• Fitur Unggulan
• Cuplikan Layar (Screenshots)
• Audit Keamanan & Privasi (Security Audit)
• Prasyarat Sistem
• Instalasi & Penggunaan
• Format Payload Webhook
• Kontribusi & Dukungan

---

Demo Aplikasi

Perekaman langsung navigasi fitur aplikasi dalam balutan Clinical Minimalist UI:

Jika video tidak muncul, klik di sini untuk menonton Video Demo.

---

Fitur Unggulan

• Clinical Minimalist UI - Antarmuka (UI) didesain ulang dengan gaya bersih, modern, elegan, dan sangat ringan, memberikan pengalaman navigasi yang intuitif.
• Keamanan PIN Terintegrasi - Mengamankan akses menu konfigurasi Webhook menggunakan sistem PIN dan Numpad kustom untuk menghindari modifikasi tidak sah.
• Persistent Background Listener - Memanfaatkan Headless JS untuk mendengarkan notifikasi secara terus menerus, didukung dengan Battery Optimization Bypass.
• Webhook Relay Cerdas - Meneruskan payload notifikasi hanya dari aplikasi target (berdasarkan Package Name) secara otomatis (Real-Time) melalui HTTP POST.
• Riwayat Log via SQLite - Mencatat seluruh log keberhasilan (HTTP 200 OK) dan kegagalan (Network Error) langsung ke dalam database SQLite internal (offline).
• Dashboard Statistik - Memantau status tangkapan dan relay Webhook harian dalam desain antarmuka yang estetik dan dilengkapi fitur Pull-to-Refresh.
• Do Not Disturb (DND) Access - Aplikasi tetap mampu membaca dan memproses notifikasi penting bahkan saat ponsel berada dalam mode Jangan Ganggu.

---

Cuplikan Layar (Screenshots)

         

---

Audit Keamanan & Privasi (Security Audit)

Keamanan data finansial dan privasi notifikasi Anda adalah prioritas utama. Pay Relay Hub dibangun dengan prinsip Privacy by Design. Berikut adalah hasil audit keamanan dari aplikasi ini:

1. Penyimpanan Lokal Sepenuhnya (100% Local Storage) Seluruh riwayat notifikasi, kredensial PIN, dan konfigurasi webhook disimpan secara enkripsi/lokal di perangkat menggunakan AsyncStorage dan SQLite. Tidak ada cloud sync dari pihak ketiga.
2. Tidak Ada Pelacakan (Zero Tracking & Analytics) Aplikasi ini bebas dari SDK pelacakan, iklan, atau analytics yang dapat membocorkan kebiasaan pengguna. Kode murni hanya berfokus pada fungsi relay.
3. Autentikasi Lapis Ganda (App-level Security) Untuk mengubah target package aplikasi atau URL Webhook, pengguna wajib melewati layar autentikasi PIN yang dikelola secara in-memory tanpa celah injeksi.
4. Isolasi Proses Background Proses Notification Listener dan Headless JS berjalan dalam Sandbox Android OS. Aplikasi hanya mem-parsing bundle notifikasi dan langsung mengirimkannya via jalur HTTPS (disarankan) menuju server pemilik tanpa ada middleware/proxy di tengah-tengah.
5. Transparansi Akses (Explicit Permissions) Aplikasi meminta izin Notification Access, Ignore Battery Optimizations, dan DND Access secara eksplisit kepada pengguna melalui antarmuka Pengaturan bawaan sistem operasi.

---

Prasyarat Sistem

Pastikan komputer (development machine) Anda memenuhi spesifikasi berikut:

1. Node.js: Versi 18 atau lebih baru.
2. Java Development Kit (JDK): Versi 17 (Rekomendasi untuk standar React Native modern).
3. Android Studio: Dilengkapi dengan SDK, NDK, dan Emulator ter-install.
4. Environment Variables: Path ANDROID_HOME yang telah terkonfigurasi.

---

Instalasi & Penggunaan

1. Kloning Repository

git clone https://github.com/zifaucode/pay-relay-hub.git
cd pay-relay-hub

2. Install Dependensi

Catatan Penting: Karena aplikasi bergantung pada arsitektur background listener spesifik, Anda wajib menggunakan flag legacy.

npm install --legacy-peer-deps

3. Menjalankan Aplikasi (Debugging)

Pastikan Emulator aktif, atau Smartphone Android Anda telah terhubung melalui kabel USB dengan fitur USB Debugging menyala.

npm run android

4. Build APK Release (Untuk Produksi)

Untuk mendapatkan performa maksimal, stabilitas background, dan ukuran aplikasi teringan:

cd android
./gradlew assembleRelease

Lokasi File APK: android/app/build/outputs/apk/release/app-release.apk

---

Format Payload Webhook

Setiap kali aplikasi menangkap notifikasi (dari Package yang telah Anda whitelist), sistem otomatis meluncurkan HTTP POST ke Webhook URL dengan body JSON mentah sebagai berikut:

{
  "package": "com.nama.aplikasi.ewallet",
  "title": "Transfer Masuk",
  "body": "Anda menerima pembayaran sebesar Rp50.000 dari Budi.",
  "raw": {
     "app": "com.nama.aplikasi.ewallet",
     "title": "Transfer Masuk",
     "text": "Anda menerima pembayaran sebesar Rp50.000 dari Budi.",
     "...": "(Objek ekstra lainnya dari intent notifikasi bawaan Android)"
  }
}

Tips: Pastikan server backend Anda mendukung penerimaan HTTP POST dengan tipe konten application/json.

---

Kontribusi & Dukungan

Proyek ini dikembangkan dan dirancang oleh zifaucode.

Jika Anda menemukan celah bug atau ingin menambah fitur baru, jangan ragu untuk melakukan Pull Request atau membuka Issues. Kunjungi profil saya untuk proyek otomasi lainnya!

GitHub: @zifaucode

Silakan tekan tombol ⭐ di pojok kanan atas untuk mendukung pengembangan proyek terbuka ini!