GeekzPay REST API
Integrasikan pembayaran QRIS dengan mudah dalam aplikasi Anda
⚡ Quick Start
Base URL
Simpan Base URL untuk digunakan di Live Test
💳 QRIS Dinamis
Buat kode QRIS dinamis dengan jumlah yang dapat disesuaikan
Parameter
| Field | Tipe | Keterangan |
|---|---|---|
base_amount | int | Jumlah dasar (wajib dengan unique_code) |
unique_code | int (1-999) | Kode unik untuk total |
amount | int | Jumlah langsung (alternatif) |
payload_static | string | Payload QRIS static custom (opsional) |
qr | string | "png" untuk mendapatkan gambar QR |
🧪 Live Test - QRIS Dinamis
Gunakan payload QRIS static custom jika ingin override default
🔄 QR Converter
Konversi gambar QRIS static menjadi payload code
📷 Upload Gambar QR
Drop gambar QR di sini atau klik untuk upload
Format: PNG, JPG, JPEG (max 2MB)
Preview Gambar
🔔 Webhook Payment
Terima notifikasi pembayaran dari berbagai dompet digital
🧪 Live Test - Webhook
📊 Riwayat Pembayaran
Endpoint
GET /webhook/status?token=USER123&limit=5
Mendapatkan ringkasan pembayaran terbaru
📚 Contoh Penggunaan
Membuat QRIS Dinamis dengan Payload Custom
curl -X POST https://restapi.amgeekz.my.id/qris/dynamic \
-d base_amount=20000 \
-d unique_code=777 \
-d payload_static='00020101021126...6304ABCD' \
-d qr=png{
"base_amount": 20000,
"unique_code": 777,
"total": 20777,
"payload": "00020101021126...",
"qr_png_data_url": "data:image/png;base64,..."
}Mengirim Webhook
curl -X POST 'https://restapi.amgeekz.my.id/webhook/payment?token=USER123' \
-H 'Content-Type: application/json' \
-d '{ "message": "Pembayaran Rp 15.250 diterima" }'Baca Notifikasi QRIS Otomatis
Termux Forwarder membaca notifikasi dari aplikasi QRIS (ShopeePay, Gopay, dll) dan meneruskan ke webhook secara otomatis
Melihat Riwayat
curl -X GET 'https://restapi.amgeekz.my.id/webhook/summary?token=USER123&limit=3'{
"ok": true,
"token": "USER123",
"event_id": "a6ac10590d18d2190e7082552c03a0395bc9142c",
"received_at": "2025-09-24T11:49:30.018Z",
"amount": 10338,
"method": "POST",
"ip": "0.0.0.0",
"body": {
"message": "Pembayaran masuk Rp 10.338 dari ShopeePay"
}
}📱 Termux Forwarder
Membaca notifikasi dari aplikasi QRIS dan meneruskannya ke webhook secara otomatis
📥 Instalasi Termux & Dependencies
Unduh dan Instal Termux
Download aplikasi Termux dari F-Droid untuk environment Linux di Android
📥 Download Termux APKUnduh dan Instal Termux:API
Untuk akses fitur sistem Android seperti notifikasi
📥 Download Termux:API APKUnduh dan Instal Termux:Boot
Untuk menjalankan script forwarder secara otomatis saat boot
📥 Download Termux:Boot APK🚀 Instalasi Forwarder
Setelah menginstal semua aplikasi di atas, buka Termux dan jalankan perintah berikut:
pkg update && pkg upgrade -y && pkg install -y curl && \
bash <(curl -sSL https://restapi.amgeekz.my.id/installer.sh)⚠️ Catatan Penting
- • Pastikan koneksi internet stabil selama proses instalasi
- • Berikan semua izin yang diminta oleh aplikasi Termux
- • Simpan token yang dihasilkan selama instalasi untuk konfigurasi webhook
- • Forwarder akan berjalan otomatis di latar belakang setelah instalasi selesai
✅ Keuntungan
- • Notifikasi real-time langsung di perangkat Android
- • Tidak memerlukan server eksternal yang mahal
- • Berjalan otomatis di latar belakang
- • Mudah dikonfigurasi dan dikustomisasi
🔄 Cara Kerja
- 1. Termux membaca notifikasi dari aplikasi QRIS (ShopeePay, Gopay, dll)
- 2. Data pembayaran diproses dan dikonversi ke format webhook
- 3. Webhook dikirim ke API GeekzPay
- 4. Sistem menerima konfirmasi pembayaran secara real-time
❓ Troubleshooting
Instalasi gagal
Pastikan storage permission sudah diberikan ke Termux dan koneksi internet stabil.
Forwarder tidak berjalan
Coba jalankan ulang script installer atau restart aplikasi Termux.
Notifikasi tidak muncul
Pastikan Termux:API sudah terinstal dan izin notifikasi sudah diberikan.
Webhook tidak terkirim
Periksa token dan pastikan perangkat terkoneksi internet.
