Lewati ke konten
Dasar API QRIS

API QRIS Dinamis: Setiap Pesanan Punya QRIS Bernominal

Ubah QRIS statis yang Anda punya menjadi QRIS dinamis lewat satu panggilan API.

Halaman ini bagian dari layanan API QRIS gratis APIQris: pakai QRIS milik Anda sendiri, tanpa potongan dari kami, dana langsung ke rekening Anda.

  • 0% fee APIQris
  • Dana langsung ke Anda
  • Webhook HMAC

Jawaban singkatAPI QRIS dinamis membuat kode QRIS yang sudah berisi nominal pembayaran untuk satu pesanan. APIQris membaca QRIS statis yang Anda upload, menambahkan nominal plus kode unik, menghitung ulang checksum CRC, lalu mengembalikan string dan gambar QR yang siap discan.

Ingin tahu gambaran besarnya dulu? Baca juga pengertian QRIS API dan bagaimana API QRIS gratis APIQris menghubungkan QRIS Anda ke website, aplikasi, dan chatbot.

Rp0potongan dari APIQris
24/7konfirmasi otomatis
100%dana ke rekening Anda
Masalah

Tanpa API QRIS dinamis, ini yang biasa terjadi

Cek mutasi satu per satu

Admin membuka aplikasi merchant setiap ada pesanan hanya untuk memastikan uang sudah masuk.

Pembeli salah ketik nominal

QRIS statis membuat pembeli mengetik sendiri, kurang Rp1.000 saja sudah bikin repot.

Minta screenshot bukti bayar

Bukti transfer bisa diedit dan memperlambat proses pesanan.

Dana tertahan di pihak ketiga

Payment gateway menampung uang Anda dan mencairkannya belakangan dengan potongan.

Solusinya: API QRIS dinamis dari APIQris mengotomatiskan semuanya, tanpa mengganti QRIS yang sudah Anda punya.

Panduan

Memahami API QRIS dinamis secara lengkap

01

Beda QRIS statis dan QRIS dinamis

QRIS statis tidak punya nominal, jadi pembeli mengetik sendiri. QRIS dinamis sudah membawa nominal sehingga pembeli tinggal konfirmasi.

  • Statis: satu kode untuk semua transaksi, nominal diketik pembeli
  • Dinamis: satu kode per tagihan, nominal terkunci
  • Dinamis jauh lebih mudah dicocokkan secara otomatis
02

Cara API kami membuat QRIS dinamis

QRIS memakai format EMV QR Code. Saat Anda memanggil endpoint tagihan, kami mengubah penanda inisiasi menjadi dinamis, menyisipkan tag nominal, lalu menghitung CRC-16 baru. Data merchant seperti NMID dan nama penjual tidak kami ubah, sehingga dana tetap ke akun Anda.

03

Kode unik agar tiap tagihan terbedakan

Jika dua pembeli memesan Rp50.000 pada waktu bersamaan, sistem menambahkan kode unik kecil (misalnya Rp50.123 dan Rp50.481). Dengan begitu setiap notifikasi dana masuk bisa dicocokkan tepat ke pesanan yang benar.

Cara kerja

Alur API QRIS dinamis dari scan sampai lunas

Dana dan data berjalan di jalur berbeda. Uang pembeli langsung ke QRIS Anda, APIQris hanya mengurus QRIS dinamis, pencocokan, dan webhook.

Infografis cara kerja API QRIS APIQris Dana pembeli mengalir dari pembeli ke penyedia QRIS lalu langsung ke rekening Anda. Jalur data terpisah: notifikasi dari HP merchant Anda dibaca APIQris lalu dikirim sebagai webhook ke website atau bot Anda. Rp Rp bayar dana langsung notifikasi kirim mutasi webhook buat tagihan → tampilkan QRIS dinamis ke pembeli Pembeli Scan & bayar Penyedia QRISAnda Bank / e-wallet Rekening Anda Langsung ke Anda HP MerchantAnda Notif dana masuk APIQris Cocokkan tagihan Website /Bot Anda Webhook lunas APIQris tidak menyentuh dana
Jalur dana: pembeli → penyedia QRIS → rekening Anda Jalur data: notifikasi → APIQris → webhook ke sistem Anda
  1. 1

    Daftar gratis

    Buat akun APIQris dengan email, tanpa biaya dan tanpa dokumen perusahaan.

  2. 2

    Upload QRIS Anda

    Unggah gambar QRIS merchant dari bank atau e-wallet Anda. Sistem membaca data QRIS secara otomatis.

  3. 3

    Pasang aplikasi pendamping

    Pasang aplikasi APIQris di HP Android yang menerima notifikasi dana masuk, lalu pindai kode pairing.

  4. 4

    Pakai API key

    Salin API key, buat tagihan QRIS dinamis dari website atau chatbot, dan terima webhook saat lunas.

Contoh skenario

Sebelum dan sesudah memakai API QRIS dinamis

Toko voucher game online dengan ±150 pesanan per hari. Ilustrasi alur kerja, bukan testimoni pelanggan.

Sebelum

Dua admin bergantian mengecek aplikasi merchant dan membalas chat konfirmasi. Pesanan malam baru diproses keesokan harinya.

Sesudah

Setiap pesanan mendapat QRIS dinamis bernominal unik. Begitu pembeli membayar, webhook API QRIS dinamis menandai pesanan lunas dan voucher terkirim otomatis.

Perbandingan

QRIS statis manual vs API QRIS dinamis vs payment gateway

AspekQRIS statis manualAPI QRIS dinamis (APIQris)Payment gateway
NominalDiketik pembeliTerkunci otomatisTerkunci otomatis
Konfirmasi bayarCek mutasi manualWebhook otomatisWebhook otomatis
Penerima danaRekening AndaRekening AndaRekening gateway
Potongan perantaraRp0Rp0±0,7% + biaya tarik
Bekerja 24 jamTergantung adminYaYa
Keamanan

Aman sejak baris kode pertama

HTTPS di semua endpoint

Data tagihan dan API key selalu terenkripsi saat dikirim.

API key bisa dirotasi

Kunci bocor? Buat kunci baru dari dashboard, kunci lama langsung mati.

Webhook HMAC SHA-256

Setiap callback ditandatangani agar server Anda bisa menolak yang palsu.

Dana tidak lewat kami

Tidak ada saldo yang bisa dibekukan, karena uang langsung ke QRIS Anda.

Sebelum go-live

Checklist API QRIS dinamis

  • QRIS merchant resmi sudah diupload dan terbaca benar
  • Aplikasi pendamping di HP Android berstatus online
  • Optimasi baterai dimatikan untuk aplikasi merchant & pendamping
  • Uji bayar Rp1.000 berhasil terdeteksi lunas
  • URL webhook memakai HTTPS dan membalas 200
  • Tanda tangan HMAC diverifikasi sebelum memproses pesanan
  • Proses webhook idempoten berdasarkan order_id
  • API key disimpan di server, tidak di frontend
Istilah

Glosarium singkat

QRIS
Quick Response Code Indonesian Standard, standar QR pembayaran nasional dari Bank Indonesia.
QRIS dinamis
QRIS yang membawa nominal untuk satu transaksi, berbeda dengan QRIS statis tanpa nominal.
NMID
National Merchant ID, nomor identitas merchant yang tertanam di QRIS Anda.
MDR
Merchant Discount Rate, biaya yang dipotong penyedia QRIS atas transaksi sesuai ketentuan.
Kode unik
Angka kecil yang ditambahkan ke nominal agar setiap tagihan bisa dibedakan.
Webhook
HTTP POST otomatis dari APIQris ke server Anda saat status tagihan berubah.
FAQ

Pertanyaan umum tentang API QRIS dinamis

Apakah QRIS dinamis dari API ini bisa dibayar semua aplikasi?

Ya, selama QRIS asli Anda sah. QRIS dinamis tetap mengikuti standar QRIS sehingga bisa dibayar dari m-banking dan e-wallet yang mendukung QRIS.

Berapa lama QRIS dinamis berlaku?

Anda bisa mengatur masa berlaku per tagihan, misalnya 15 menit sampai 24 jam. Tagihan kedaluwarsa otomatis berubah status menjadi expired.

Apakah dana dari API QRIS dinamis ditampung APIQris?

Tidak. Pembeli membayar ke QRIS milik Anda sendiri, sehingga dana langsung masuk ke rekening atau saldo merchant Anda.

Berapa biaya memakai APIQris?

Daftar gratis dan APIQris tidak memotong fee per transaksi. MDR dari penyedia QRIS Anda (bila ada) mengikuti ketentuan penyedia.

Apakah perlu HP khusus?

Cukup satu HP Android yang terpasang aplikasi merchant penerbit QRIS Anda dan aplikasi pendamping APIQris. HP lama pun bisa selama notifikasinya stabil.

Mulai API QRIS dinamis hari ini

Gratis, tanpa potongan per transaksi, dana langsung ke rekening Anda. Pelajari dulu API QRIS selengkapnya atau langsung daftar.