Notification Listener
APK companion mengirim notifikasi mobile banking ke ingestion API yang ditandatangani HMAC.
Rekonsiliasi transfer bank & QRIS otomatis, tanpa API resmi bank.
AAPay membaca notifikasi mobile banking dari device Android Anda, mencocokkannya dengan order lewat unique code, lalu mengirim webhook terverifikasi ke backend Anda.
- < 3 detik
- Deteksi pembayaran
- 99 kode
- Unique code per merchant
- 5x retry
- Webhook otomatis
- 24/7
- Listener berjalan
Fitur
Semua yang dibutuhkan untuk terima pembayaran
Matching Engine
Unique code 1–99 rupiah dipesan atomik per merchant, matching anti-race lewat row lock.
Webhook Retry
Pengiriman dengan tanda tangan HMAC dan retry eksponensial 0s → 30s → 2m → 10m → 1j.
API Key Hashed
Key & secret disimpan ter-hash. Dukungan signature HMAC untuk request merchant.
Keamanan Ketat
Rate limit sliding window, replay protection nonce, audit log setiap aksi sensitif.
Dashboard Live
Status device online/offline, feed transaksi, dan log webhook yang selalu diperbarui.
Kelebihan
Kenapa memilih AAPay
- Tanpa proses merchant aggregator yang panjang — cukup rekening & QRIS yang sudah Anda miliki.
- Biaya jauh lebih ringan dibanding payment gateway konvensional.
- Rekonsiliasi otomatis 24/7, tidak perlu cek mutasi manual.
- Mendukung multi QRIS statis (GoPay, ShopeePay, BRI, dan lainnya) dengan pemilihan akun aktif.
- Simulasi transaksi bawaan untuk memastikan device, API key, dan webhook benar-benar berfungsi.
- Kompatibel dengan bahasa apa pun — cukup HTTP request biasa.
Tutorial
Cara penggunaan dalam 6 langkah
Dari pendaftaran sampai transaksi pertama masuk — biasanya selesai kurang dari 15 menit.
1. Daftar & buat API key
Registrasi akun merchant, lalu buat API key di menu API Keys. Simpan secret-nya sekali saja saat ditampilkan.
2. Pasang APK listener
Tambah device baru di menu Device untuk mendapat enrollment code, lalu pairing APK di HP Android yang menerima notifikasi mobile banking.
3. Unggah QRIS statis
Upload QRIS statis Anda di menu QRIS lalu tandai satu akun sebagai aktif. Sistem akan mengubahnya jadi QRIS dinamis bernominal.
4. Pasang webhook
Isi URL webhook backend Anda. Setiap order lunas dikirim dengan tanda tangan HMAC dan retry otomatis bila gagal.
5. Buat order & terima notifikasi
Panggil endpoint order, tampilkan QR/nominal unik ke pembeli. Saat notifikasi masuk, order otomatis lunas.
6. Tes transaksi
Jalankan simulasi QRIS dinamis di dashboard untuk memverifikasi seluruh alur end-to-end sebelum go-live.
Integrasi
Dokumentasi API
Base URL https://aapay.web.id — autentikasi memakai header X-API-Key. Dokumentasi lengkap beserta contoh kode tersedia di dashboard.
| Method | Endpoint | Keterangan |
|---|---|---|
| POST | /api/public/v1/orders | Buat order baru & dapatkan nominal unik. |
| GET | /api/public/v1/orders/:id | Cek status order (pending/paid/expired). |
| POST | /api/public/v1/orders/:id/cancel | Batalkan order yang masih pending. |
| POST | /api/public/device/enroll | Pairing device Android dengan enrollment code. |
| POST | /api/public/device/heartbeat | Menjaga status device tetap online. |
| POST | /api/public/device/notification | Kirim notifikasi mobile banking ke matching engine. |
Membuat order
curl -X POST https://aapay.web.id/api/public/v1/orders \
-H "X-API-Key: np_live_xxx" \
-H "Content-Type: application/json" \
-d '{"amount":100000,"external_ref":"INV-001","expires_in_minutes":15}'
# → { "final_amount": 100042, "unique_code": 42, "status": "pending" }Payload webhook (ditandatangani HMAC)
POST https://backend-anda.com/webhook
X-Signature: sha256=<hmac(secret, body)>
{
"event": "order.paid",
"order_id": "ord_123",
"external_ref": "INV-001",
"final_amount": 100042,
"paid_at": "2026-08-14T12:00:00Z"
}Siap terima pembayaran otomatis?
Buat akun merchant, pairing satu device Android, dan terima konfirmasi pembayaran realtime hari ini juga.