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?

1. Website atau aplikasi Anda membuat kode QRIS Dinamis lengkap dengan Kode Unik di belakangnya (contoh: Rp 10.338).
2. Pembeli melakukan scan kode QRIS dan membayar pas sesuai angka tersebut.
3. HP Anda menerima notifikasi SMS atau pop-up dana masuk dari aplikasi bank/e-wallet Anda (seperti DANA, ShopeePay, OVO, dll).
4. Aplikasi Geekz Forwarder di HP otomatis membaca isi notifikasi teks tersebut, lalu mengirimkannya ke server Anda dalam hitungan detik.
5. Server website Anda menerima data itu, mencocokkan nominalnya, dan langsung merubah status pembelian menjadi LUNAS.

⚠️

Konfigurasi Alamat API Utama

Alamat URL server di bawah ini terdeteksi otomatis sesuai lokasi berjalannya aplikasi. Anda tidak perlu merubah bagian ini untuk menjalankan simulasi pengujian tombol di halaman dokumen.

// Alamat Base URL Server Anda (Terdeteksi Otomatis)

1. MENU BUAT QRIS DINAMIS

Membuat kode bayar yang memiliki nominal acak di belakangnya agar sistem tahu siapa pembelinya.

Harga Dasar Barang (IDR) *

Kode Unik Tambahan (Angka 1-999)

Biar Sistem Acak Kode Unik Otomatis

Atau Masukkan Total Nominal Mutlak (Tanpa Kode Unik Tambahan)

Isi Payload QRIS Statis Anda

⚡ PROSES & BUAT GAMBAR QRIS BERSIHKAN INPUT

HASIL // Hasil Data dari Server Utama

// Output Data Format JSON

// Tampilan Gambar QRIS Hasil Generate

Pembeli harus men-scan dan membayar tepat sesuai angka di atas.

2. SCAN ATAU BACA GAMBAR QRIS (QR CONVERTER)

Masukkan file gambar QRIS Anda di sini untuk diubah menjadi barisan teks kode mentah (payload string).

▢

Tarik dan jatuhkan file gambar ke sini, atau klik untuk mencari berkas

Ekstensi File: PNG, JPG, JPEG (Ukuran Maksimal: 2MB)

// Pratinjau Gambar Anda

Mulai Baca Gambar Hapus File

OUTPUT // Teks Kode Hasil Pembacaan

📋 Salin Teks Kode

3. SIMULATOR TES KIRIM NOTIFIKASI (WEBHOOK)

Uji coba untuk meniru cara kerja HP Forwarder saat mengirimkan teks mutasi dana masuk menuju ke server website Anda.

Kode Token Keamanan Akun Anda

Format Pengiriman Data application/json application/x-www-form-urlencoded text/plain

Isi Contoh Pesan Notifikasi Tiruan { "message": "Pembayaran masuk Rp 10.338 dari ShopeePay" }

🚀 KIRIM SIMULASI SEKARANG RESET FORM SIMULATOR

RESPON // Balasan dari Server Anda

4. ALAMAT URL CEK RIWAYAT PEMBAYARAN

// Jalur Akses: GET /webhook/status?token=USER123&limit=5

Gunakan alamat URL di bawah ini pada website Anda jika ingin mengambil data daftar pembayaran terakhir yang sukses masuk ke database.

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

📚 Contoh Perintah cURL (Bagi Developer Backend)

// A. Membuat Perintah QRIS Dinamis

Salin perintah di bawah ini untuk disuntikkan ke dalam sistem script website backend Anda.

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

// Contoh Struktur Balasan Sukses dari Server (JSON Response)

{
"base_amount": 20000,
"unique_code": 777,
"total": 20777,
"payload": "00020101021126...",
"qr_png_data_url": "data:image/png;base64,..."
}

// B. Perintah Kirim Notifikasi Pembayaran (Webhook Callback)

Perintah manual ini digunakan apabila Anda ingin mencoba mengetes lemparan mutasi data tanpa melalui aplikasi HP.

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

□

Info Penting Otomatisasi Terintegrasi:

Apabila aplikasi Android Geekz Forwarder sudah terpasang dan disetting dengan benar di HP Anda, maka Anda tidak perlu lagi mengetikkan kode cURL di atas. Setiap kali ada pembeli yang membayar, notifikasi HP akan langsung terkirim otomatis 100% ke website Anda tanpa henti.

📥 Buka Panduan Cara Setting Aplikasi HP

// C. Perintah Mengambil Riwayat Log Dana Masuk (Summary)

Untuk menarik rekaman data mutasi terakhir yang sukses diterima server log internal.

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

// Hasil Teks Array dari Server

{
"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"
}
}

// TABEL GLOSARIUM KODE STATUS (JIKA ADA MASALAH)

Kode Angka	Nama Status	Arti Masalah & Solusi Cara Memperbaikinya
200 / 201	Sukses / Berhasil	Koneksi lancar! Permintaan diproses server tanpa error.
400	Data Salah	Input data kurang atau keliru (contoh: mengisi kolom harga memakai huruf).
401	Akses Ditolak	Kode token otentikasi salah, palsu, atau belum terdaftar.
404	Alamat Salah	Salah mengetikkan URL endpoint tujuan pada server website Anda.
500 / 502	Server Rusak	Sistem website backend Anda mengalami crash, silakan periksa codingan server Anda.