PENTING

Panduan Sistem GeekzPay REST API

Sistem ini berfungsi untuk mengecek dan mencatat pembayaran QRIS secara otomatis hanya dengan membaca notifikasi handphone Anda sendiri secara langsung.

// LALU BAGAIMANA ALUR KERJA OTOMATISNYA?

Website Anda membuat QRIS Dinamis dengan Kode Unik (contoh: Rp 10.338).
Pembeli scan QRIS dan membayar sesuai nominal.
HP Anda menerima notifikasi dana masuk dari bank/e-wallet.
Aplikasi Geekz Forwarder membaca notifikasi dan mengirim ke server.
Server mencocokkan nominal dan mengubah status menjadi LUNAS.

Konfigurasi Alamat API Utama

Alamat URL server terdeteksi otomatis sesuai lokasi aplikasi.

1. BUAT QRIS DINAMIS

Membuat kode bayar dengan nominal acak.

Harga Dasar (IDR) *

Kode Unik (1-999)

Acak Kode Unik Otomatis

Atau Masukkan Total Nominal Mutlak

Isi Payload QRIS Statis

HASIL

2. SCAN GAMBAR QRIS

Upload file gambar QRIS untuk diubah menjadi teks payload.

Tarik file ke sini atau klik untuk pilih

PNG, JPG, JPEG (Maks. 2MB)

HASIL BACA

3. SIMULATOR WEBHOOK

Uji coba kirim notifikasi pembayaran ke server.

Token

Format

Pesan

RESPON SERVER

4. CEK RIWAYAT PEMBAYARAN

GET /webhook/status?token=USER123&limit=5

Contoh cURL

// A. QRIS Dinamis

curl -X POST https://restapi.amgeekz.my.id/qris/dynamic \
  -d base_amount=20000 \
  -d unique_code=777 \
  -d payload_static='000201...'

// B. Webhook Payment

curl -X POST 'https://restapi.amgeekz.my.id/webhook/payment?token=USER123' \
  -H 'Content-Type: application/json' \
  -d '{"message": "Pembayaran Rp 15.250"}'

// C. Riwayat Summary

curl -X GET 'https://restapi.amgeekz.my.id/webhook/summary?token=USER123&limit=3'

// KODE STATUS HTTP

Kode	Nama	Keterangan
200	Sukses	Permintaan berhasil
400	Data Salah	Input tidak valid
401	Akses Ditolak	Token salah
404	Tidak Ditemukan	Endpoint salah
500	Server Error	Cek backend

Cek Riwayat

Masukkan token untuk melihat transaksi terakhir

Token

Limit

Masukkan token dan klik cari

PANDUAN FORWARDER v2.0

3 langkah setting aplikasi Geekz Forwarder di HP

UNDUH APK

HIDUPKAN SERVICE STATE

Aktifkan izin Akses Notifikasi dan nyalakan tombol utama.

PILIH APP TARGET

Centang aplikasi bank/e-wallet di menu APP REGISTRY.

SET WEBHOOK URL

Isi URL di menu DATA PIPELINE:

https://restapi.amgeekz.my.id/webhook/payment?token=USER123

Ganti USER123 dengan token Anda

Method: JSON

// SETTINGAN TERBAIK

Service State HARUS ON

App Registry TERPILIH

Format Sink APPLICATION/JSON

Donasi

Bantu kami menyewa server

Scan QRIS Berikut

Klik gambar untuk memperbesar

QRIS Interoperabilitas Nasional

Terima kasih

PWA Monitor

Pantau pembayaran real-time dari HP

Buka Monitor

Install ke home screen untuk pengalaman native