QRPay

Tutorial QRPay

Dari daftar sampai menerima webhook PAID. Semua langkah bisa dicoba gratis dulu; langganan hanya untuk REST API.

1 · Buat akun

Daftar dengan email atau Google di halaman daftar. Setelah masuk, aktifkan 2FA di Akun → Keamanan agar dashboard lebih aman.

2 · Pasang QRIS statis

Buka menu QRIS → Upload gambar QRIS. Ambil gambar QRIS statis dari aplikasi merchant Anda (mis. GoBiz → QRIS → Unduh), lalu upload. QRPay membaca QR-nya di browser, mengenali penerbit (GoPay, ShopeePay, DANA, OVO, LinkAja, BCA, atau bank lain), dan menyimpannya setelah Anda konfirmasi.

3 · Hubungkan sumber pembayaran

Di menu Sumber Pembayaran, cara yang disarankan dan langsung pakai adalah Notifikasi HP — berlaku untuk GoPay/GoBiz, ShopeePay, DANA, OVO, dan bank sekaligus, tanpa menyimpan password akun apa pun.

  1. Pilih kartu Notifikasi HP, beri nama (mis. "HP Kasir"), buat, lalu salin URL ingest rahasia-nya.
  2. Cara termudah — aplikasi QRPay Listener: pasang di HP, tempel URL ingest, pilih aplikasi (GoPay/GoBiz/ShopeePay), izinkan Akses Notifikasi. Selesai — tanpa setel body manual.
  3. Alternatif — MacroDroid: buat macro Notifikasi Diterima → HTTP Request POST ke URL ingest, body {"text":"[notification]","source":"[app_name]"}.
  4. Saat pembayaran masuk, QRPay membaca nominalnya dari notifikasi dan mencocokkannya ke order bernominal unik → status jadi PAID. Notifikasi transfer keluar, gagal, atau kode OTP otomatis diabaikan.

Panduan lengkap: file docs/NOTIFIKASI-HP.md di paket aplikasi. Catatan: metode ini bergantung pada HP yang hidup & online. Untuk skala besar/komersial, gunakan agregator QRIS berlisensi (QRIS resmi + webhook).

4 · Order uji pertama

Buka Order → buat order dengan nominal kecil (mis. Rp1.000). QRPay menambahkan kode unik sehingga nominal akhir jadi, misalnya, Rp1.027. Bayar persis sebesar itu dari HP lain. Dalam semenit status berubah menjadi PAID.

5 · Aktifkan API

Kalau sistem sudah cocok, isi Kredit API (top-up, biaya per transaksi), lalu buat API key qrp_live_… di API & Webhook. Simpan key hanya di server Anda. Panduan endpoint ada di Dokumentasi.

6 · Pasang webhook

Isi URL webhook di API & Webhook. Saat order PAID, QRPay mengirim POST bertanda tangan HMAC ke URL itu. Verifikasi signature sebelum memproses — contohnya ada di Dokumentasi bagian Verifikasi signature.

Tips

Mulai sekarang →