FAQ API QRIS

API QRIS adalah antarmuka pemrograman yang memungkinkan website, aplikasi, atau chatbot membuat QRIS bernominal secara otomatis dan menerima kabar ketika QRIS tersebut sudah dibayar.

APIQris adalah layanan QRIS API yang memakai QRIS milik Anda sendiri. Kami membuat QRIS dinamis, mendeteksi pembayaran, dan mengirim webhook, sementara dana langsung masuk ke rekening Anda.

Payment gateway menampung dana lalu mencairkannya dengan potongan biaya. APIQris tidak menampung dana sama sekali, sehingga tidak ada potongan per transaksi dari kami.

Developer, toko online, pemilik chatbot WhatsApp atau Telegram, penyedia hosting (WHMCS), kasir/POS, komunitas, dan UMKM yang sudah punya QRIS merchant.

Bukan. APIQris tidak menampung atau memindahkan dana. Pembayaran tetap diproses oleh bank atau e-wallet penerbit QRIS Anda.

Tidak untuk mulai memakai API. Yang dibutuhkan adalah QRIS merchant resmi, termasuk QRIS atas nama perorangan atau UMKM.

Daftar gratis, tanpa biaya bulanan, dan tanpa potongan per transaksi dari APIQris.

MDR (bila ada) diterapkan oleh bank atau e-wallet penerbit QRIS Anda sesuai ketentuan Bank Indonesia dan kategori usaha. Itu bukan biaya dari APIQris.

Langsung ke akun merchant QRIS Anda. Penarikan ke rekening bank mengikuti aturan penyedia QRIS tersebut.

Tidak bisa, karena dana tidak pernah melewati APIQris.

Bisa diatur. Mode tambah membuat pembeli membayar sedikit lebih besar, mode kurang membuat pembeli membayar sedikit lebih kecil.

Tidak dari APIQris. Biaya penarikan saldo (bila ada) mengikuti penyedia QRIS Anda.

Semua bahasa yang bisa melakukan HTTP request. Contoh kode tersedia untuk cURL, PHP, Laravel, Node.js, Python, dan Go.

Kirim POST ke endpoint /invoices dengan header Authorization Bearer dan body berisi amount serta order_id. Respons berisi total, string QRIS, dan URL gambar QR.

Melalui webhook invoice.paid ke callback URL Anda. Sebagai cadangan, Anda juga bisa memanggil endpoint status tagihan.

Hitung HMAC SHA-256 dari timestamp + "." + body mentah memakai secret webhook, lalu bandingkan dengan nilai v1 di header X-APIQris-Signature secara constant-time.

Webhook dikirim ulang hingga 6 kali dengan jeda bertahap (1 menit sampai 24 jam). Anda juga bisa kirim ulang manual dari dashboard.

Ada. API key mode uji dan endpoint simulasi pembayaran memungkinkan Anda mengetes tanpa uang sungguhan.

Bisa. Bot memanggil API, mengirim gambar QR ke pengguna, lalu membalas otomatis saat webhook lunas diterima.

Ya, pola integrasinya tersedia. Lihat panduan API QRIS WooCommerce dan API QRIS WHMCS.

Pembayaran masuk langsung ke QRIS Anda. Cara tercepat dan teraman mengetahuinya adalah dari notifikasi aplikasi merchant di HP Anda, tanpa menyimpan kredensial bank di server.

Saat ini belum, karena iOS tidak mengizinkan aplikasi membaca notifikasi aplikasi lain.

Ya, agar pembayaran terdeteksi kapan saja. Sambungkan ke charger dan matikan optimasi baterai untuk aplikasi merchant dan aplikasi pendamping.

Notifikasi disimpan di antrean lokal dan dikirim berurutan saat koneksi kembali.

Bisa sebagai cadangan. Notifikasi ganda dari dua HP disaring otomatis agar tidak dihitung dua kali.

Aplikasi hanya memproses notifikasi dari aplikasi pembayaran yang terdaftar dan hanya mengambil informasi dana masuk.

QRIS merchant resmi dari bank atau e-wallet, misalnya GoPay Merchant, ShopeePay, DANA Bisnis, BRI, BCA, Mandiri Livin’ Merchant, BNI, dan lainnya, selama aplikasinya menampilkan notifikasi dana masuk berisi nominal.

Data merchant (NMID, acquirer, nama penjual) tidak diubah. Hanya nominal dan checksum yang ditambahkan agar menjadi QRIS dinamis.

Nama penjual mengikuti QRIS asli. Beberapa penyedia menolak transaksi bila nama diubah, jadi APIQris mempertahankannya.

Bisa. Tambahkan beberapa QRIS dan pilih QRIS yang dipakai per tagihan atau per toko.

Gunakan QRIS merchant. QRIS untuk transfer antar pengguna tidak disarankan dan bisa melanggar ketentuan penyedia.

Tidak pernah. Kami tidak meminta password internet banking, PIN, atau OTP.

Buat API key baru dari dashboard dan cabut kunci lama. Kunci yang dicabut langsung tidak berlaku.

Ya, semua endpoint memakai HTTPS. Webhook juga ditandatangani HMAC SHA-256.

Judi, penipuan, dan aktivitas ilegal lainnya. Akun yang melanggar akan dinonaktifkan.