1. Daftar gratis
Buat akun APIQris dengan email, tanpa biaya dan tanpa dokumen perusahaan.
Cara kerja
Cara Kerja API QRIS APIQris
Dari upload QRIS sampai webhook lunas, begini perjalanan setiap pembayaran. Dana selalu langsung ke rekening Anda, APIQris hanya mengurus datanya.
- 6 langkah
- Tanpa password bank
- Dana tidak ditampung
QRIS AndaUpload sekali
Checkout #INV-1024MenungguLunas
Total bayarRp50.123
Kode unik 123 otomatis QR
Dana masukQRIS merchant · Rp50.123
webhook
POST /webhook/qris event: invoice.paid signature: valid ✓ ← 200 OK Ringkasan
API QRIS dalam 4 langkah singkat
Kalau hanya punya satu menit, ini intinya.
2. Upload QRIS Anda
Unggah gambar QRIS merchant dari bank atau e-wallet Anda. Sistem membaca data QRIS secara otomatis.
3. Pasang aplikasi pendamping
Pasang aplikasi APIQris di HP Android yang menerima notifikasi dana masuk, lalu pindai kode pairing.
4. Pakai API key
Salin API key, buat tagihan QRIS dinamis dari website atau chatbot, dan terima webhook saat lunas.
Langkah demi langkah
Perjalanan lengkap sebuah pembayaran QRIS
Setiap langkah dijelaskan dengan apa yang terjadi di belakang layar.
1
Daftar dan upload QRIS Anda
Buat akun gratis dengan email, lalu unggah gambar QRIS merchant dari bank atau e-wallet Anda. Sistem membaca isi QR secara otomatis.
- Tidak perlu dokumen PT atau NIB untuk mulai
- Data penting dibaca otomatis: NMID, nama merchant, kota, acquirer
- Bisa menambah lebih dari satu QRIS untuk toko berbeda
- QRIS asli tidak diubah, hanya dijadikan dasar QRIS dinamis
QRIS statis Nominal diketik pembeli
POST /invoices - tag 01 → 12
- + tag 54 nominal
- CRC-16 baru
QRIS dinamis Rp75.042 terkunci
2
Pasang aplikasi pendamping di HP Android
Pasang aplikasi APIQris di HP yang juga terpasang aplikasi merchant QRIS Anda, lalu pindai kode pairing dari dashboard.
- Izinkan akses notifikasi (hanya untuk membaca dana masuk)
- Matikan optimasi baterai agar tetap aktif 24 jam
- Status online/offline terlihat di dashboard
- HP lama pun bisa dipakai selama notifikasi stabil
Kode pairing AQ7K-2P9X ● HP online
3
Buat tagihan lewat API atau dashboard
Kirim nominal dan order ID ke endpoint tagihan. APIQris menambahkan kode unik, membuat QRIS dinamis, dan mengembalikan string QR serta URL gambarnya.
- Nominal + kode unik agar setiap tagihan bisa dibedakan
- Masa berlaku bisa diatur (misalnya 15 menit sampai 24 jam)
- order_id idempoten: request ulang tidak membuat tagihan ganda
- Tanpa coding? Pakai link pembayaran dari dashboard
checkout.js
const qris = await fetch(API, {method: 'POST',body: JSON.stringify({ amount: 75000 }),}).then(r => r.json());
201 Createdwebhook ✓ 200
4
Pembeli scan dan bayar
Pembeli memindai QR dari m-banking atau e-wallet mana pun yang mendukung QRIS. Nominal sudah terisi, jadi tidak ada salah ketik.
- Bisa dibayar dari semua aplikasi yang mendukung QRIS
- Dana masuk langsung ke akun merchant Anda
- Halaman bayar menampilkan hitung mundur dan status
- Pembeli tidak perlu mengirim bukti transfer
Checkout · Pesanan #1024
✓
Total bayarRp75.042
Menunggu pembayaranPembayaran diterima
5
Pembayaran terdeteksi dan dicocokkan
Aplikasi merchant memunculkan notifikasi dana masuk. Aplikasi pendamping meneruskannya, lalu server mencocokkan nominal dengan tagihan yang menunggu.
- Cocok berdasarkan total unik + QRIS + waktu
- Notifikasi uang keluar diabaikan
- Notifikasi ganda dari dua HP disaring otomatis
- Mutasi yang tidak cocok bisa dipasangkan manual
09:41
Jumat, 17 Oktober
QR
QRIS MerchantDana masuk Rp75.042
AQ
APIQrisINV-77 cocok · ditandai lunas
↗
Webhookinvoice.paid → 200 OK
6
Webhook lunas terkirim ke sistem Anda
Begitu cocok, status tagihan berubah lunas dan APIQris mengirim webhook bertanda tangan HMAC SHA-256 ke callback URL Anda.
- Event invoice.paid, invoice.expired, invoice.cancelled
- Kirim ulang otomatis bila server Anda gagal membalas
- Log respons webhook bisa dilihat di dashboard
- Opsional: kabar WhatsApp ke pembeli
webhook.log
POST /webhook/qrisX-APIQris-Signature: t=…,v1=…{ "event": "invoice.paid","order_id": "INV-77","total_amount": 75042 }
201 Createdwebhook ✓ 200
Alur dana & data
Uang dan data berjalan di jalur berbeda
Inilah perbedaan utama APIQris dengan payment gateway: kami tidak pernah memegang uang Anda.
Kode unik
Bagaimana dua pembayaran Rp50.000 tidak tertukar?
Notifikasi dana masuk hanya berisi nominal. Agar setiap pembayaran bisa dikenali, setiap tagihan diberi tambahan angka kecil yang berbeda, disebut kode unik.
Selama tagihan masih menunggu, tidak ada dua tagihan di QRIS yang sama dengan total persis sama. Begitu dana Rp50.123 masuk, sistem tahu itu milik pesanan A.
Rentang kode unik bisa diatur. Anda juga bisa memilih kode unik menambah atau mengurangi nominal.
| Pesanan | Nominal | Kode unik | Total dibayar |
|---|---|---|---|
| Pesanan A | Rp50.000 | 123 | Rp50.123 |
| Pesanan B | Rp50.000 | 481 | Rp50.481 |
| Pesanan C | Rp75.000 | 42 | Rp75.042 |
| Pesanan D | Rp125.000 | 318 | Rp125.318 |
Siklus status
Dari pending sampai webhook terkirim
Tagihan dibuat pending
Status pending. Total = nominal + kode unik, QRIS dinamis siap discan.
Menunggu pembayaran pending
Halaman bayar menampilkan QR dan hitung mundur. Polling status boleh setiap 2 detik.
Notifikasi dana masuk diproses
Aplikasi merchant memberi tahu ada dana masuk. Aplikasi pendamping mengirimnya ke server.
Tagihan lunas paid
Nominal cocok dengan tagihan pending di QRIS yang sama. Status berubah paid.
Webhook dikirim invoice.paid
POST ke callback URL dengan header X-APIQris-Signature. Gagal? Diulang 1 mnt, 5 mnt, 15 mnt, 1 jam, 6 jam, 24 jam.
Atau kedaluwarsa expired
Bila tidak dibayar sampai batas waktu, status menjadi expired dan event invoice.expired dikirim.
Kasus khusus
Bagaimana jika ada yang tidak berjalan mulus?
Situasi nyata yang sering ditanyakan, dan cara sistem menanganinya.
Pembeli membayar nominal berbeda
Pembayaran tidak otomatis dicocokkan karena totalnya beda. Mutasi tetap tercatat dan bisa Anda pasangkan manual ke tagihan dalam satu klik.
HP pendamping sempat offline
Notifikasi disimpan di antrean lokal dan dikirim berurutan saat koneksi kembali. Dashboard juga memberi tahu bila HP offline terlalu lama.
Webhook gagal diterima server
APIQris mencoba lagi hingga 6 kali dengan jeda bertahap. Anda juga bisa menekan "kirim ulang" dari dashboard.
Dua pembeli, nominal sama
Kode unik membuat totalnya berbeda (misalnya Rp50.123 dan Rp50.481), jadi masing-masing tetap tercocokkan ke pesanan yang benar.
Pembeli bayar setelah kedaluwarsa
Ada masa tenggang singkat untuk pembayaran yang terlambat. Di luar itu, mutasi tetap tercatat untuk ditindaklanjuti manual.
Punya beberapa QRIS
Setiap tagihan terikat ke satu QRIS. Pencocokan hanya dilakukan dengan notifikasi dari aplikasi penerbit QRIS tersebut.
Yang dibutuhkan
Hanya tiga hal untuk mulai
QRIS merchant resmi
Dari bank atau e-wallet (GoPay Merchant, ShopeePay, DANA Bisnis, BRI, BCA, Mandiri, dan lainnya).
Satu HP Android
Terpasang aplikasi merchant penerbit QRIS dan aplikasi pendamping APIQris, terhubung internet.
Website, bot, atau dashboard
Server untuk menerima webhook, atau cukup pakai link pembayaran bila belum punya website.
FAQ
Pertanyaan tentang cara kerja
Apakah APIQris menyimpan password bank saya?
Tidak. Aplikasi pendamping hanya membaca notifikasi dana masuk. Password, PIN, dan OTP tidak pernah diminta.
Seberapa cepat pembayaran terdeteksi?
Biasanya beberapa detik setelah notifikasi dana masuk muncul di HP, tergantung kecepatan aplikasi merchant dan koneksi internet HP.
Kenapa butuh HP Android?
Karena dana masuk langsung ke QRIS Anda, cara paling cepat dan aman mengetahuinya adalah dari notifikasi aplikasi merchant di HP Anda sendiri, tanpa menyimpan kredensial bank di server.
Apakah iPhone bisa?
Aplikasi pendamping saat ini untuk Android, karena iOS tidak mengizinkan aplikasi membaca notifikasi aplikasi lain.
Apakah QRIS saya diubah?
Data merchant (NMID, acquirer, nama penjual) tidak diubah. Yang ditambahkan hanya nominal dan checksum CRC baru sehingga menjadi QRIS dinamis.
Bagaimana jika saya tidak punya server?
Gunakan link pembayaran dari dashboard. Status tetap otomatis tercatat, hanya saja tidak ada webhook ke sistem Anda.
Pelajari lebih dalam
Panduan terkait cara kerja
QRIS APIPanduan lengkap QRIS API dengan bahasa sederhana, dari konsep sampai baris kode… API QRIS dinamisUbah QRIS statis yang Anda punya menjadi QRIS dinamis lewat satu panggilan API. API QRIS callbackJangan polling terus. Biarkan APIQris yang mengabari server Anda saat QRIS… API cek mutasi QRISHentikan kebiasaan membuka aplikasi merchant setiap ada pesanan. Biarkan sistem… API notifikasi QRISSatu pembayaran, banyak tujuan kabar: server Anda, pembeli, dan admin toko. generate QRIS dinamisKonversi QRIS statis ke dinamis yang benar, tanpa merusak data merchant.
Sudah paham alurnya?
Coba sendiri API QRIS gratis, tanpa potongan dari kami.