๐Ÿš€ GeekzPay API v1.0

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

FieldTipeKeterangan
base_amountintJumlah dasar (wajib dengan unique_code)
unique_codeint (1-999)Kode unik untuk total
amountintJumlah langsung (alternatif)
payload_staticstringPayload QRIS static custom (opsional)
qrstring"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)

๐Ÿ”” 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

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

๐Ÿ“ฑ Geekz Forwarder

Aplikasi Android untuk membaca notifikasi pembayaran dan meneruskannya ke webhook secara otomatis

๐Ÿ””

Notifikasi Reader

Baca notifikasi dari berbagai aplikasi pembayaran

๐Ÿ”„

Forward ke Webhook

Kirim data pembayaran ke endpoint webhook

๐Ÿ“Š

Riwayat

Simpan history notifikasi yang masuk

โšก

Multi Format

Support JSON, Form Data, Plain Text

โš™๏ธ Cara Setting

1

Open Notification Access

Tap, cari Geekz Forwarder, aktifkan izin notifikasi

2

Enabled & Wi-Fi Only

Centang Enabled, kosongkan Wi-Fi Only

3

App Filtering

Centang Enable App Filter, tap Select Apps pilih aplikasi yang mau diforward (ShopeePay, GoPay, DANA, dll)

4

Endpoint

URL:

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

โš ๏ธ Ganti USER123 dengan token Anda sendiri

Protocol:

Pilih JSON

Enable Authentication:

Kosongkan (jangan dicentang)

๐Ÿ“‹ Ringkasan Setting

Enabledโœ… Centang
Wi-Fi Onlyโฌœ Kosongkan
Enable App Filterโœ… Centang
Select AppsPilih sendiri aplikasinya
ProtocolJSON
Authenticationโฌœ Kosongkan

๐Ÿ“ฆ Cara Install

  1. Download APK dari tombol di atas
  2. Buka Settings โ†’ Security โ†’ Aktifkan "Install from Unknown Sources"
  3. Buka file APK yang sudah di download dan install
  4. Ikuti panduan setting di atas