Cara Menerima Pembayaran QRIS di Website (Panduan 2026)

Menerima pembayaran QRIS di website kini jadi kebutuhan dasar bagi pemilik toko online di Indonesia. Pembeli sudah terbiasa membayar cukup dengan memindai satu kode QR dari aplikasi bank atau e-wallet mana pun. Panduan ini membahas cara terima QRIS di website langkah demi langkah untuk 2026: mulai dari menyiapkan akun dan KYC, membuat QRIS dinamis, sampai memastikan status pembayaran masuk otomatis lewat webhook. Cocok untuk pemilik UMKM yang ingin praktis maupun developer yang butuh integrasi rapi.

Sebelum masuk teknis, satu hal penting soal posisi BorderPay. BorderPay adalah produk PT Border Tech Indonesia yang berperan sebagai lapisan teknologi (software) di atas mitra Payment Gateway yang berlisensi Bank Indonesia. Artinya pemrosesan dan penyimpanan dana dilakukan oleh mitra berlisensi, sementara BorderPay memberi Anda antarmuka, dashboard, API, dan alat integrasi yang mudah dipakai.

Kenapa QRIS untuk website?

QRIS (Quick Response Code Indonesian Standard) adalah standar kode QR nasional. Satu kode bisa dibayar dari hampir semua aplikasi pembayaran di Indonesia, jadi Anda tidak perlu memasang banyak metode terpisah. Untuk website, yang paling relevan adalah QRIS dinamis: nominal sudah terisi otomatis sesuai pesanan, dan setiap transaksi punya kode unik sehingga rekonsiliasi jauh lebih mudah dibanding QRIS statis yang nominalnya diketik manual pembeli.

Untuk toko online, QRIS dinamis hampir selalu pilihan yang benar karena nominal dan status pembayaran bisa dicocokkan langsung ke setiap pesanan tanpa pencocokan manual.

Langkah 1 — Daftar akun dan pahami mode test

Mulailah dengan membuat akun di halaman register. Setelah itu Anda langsung mendapat akses ke mode test/sandbox sejak hari pertama. Di mode ini Anda bisa membuat QRIS, mensimulasikan pembayaran, dan menguji webhook tanpa uang sungguhan. Integrasi dan pengujian di sandbox memang bisa dikerjakan cepat karena tidak menunggu verifikasi apa pun.

Yang perlu dicatat: untuk menerima uang sungguhan (go-live), Anda wajib menyelesaikan proses KYC terlebih dulu. KYC adalah verifikasi identitas usaha yang diminta mitra berlisensi, dan prosesnya butuh peninjauan — jadi bukan sesuatu yang instan. Rencanakan ini lebih awal supaya saat website siap, akun Anda sudah bisa menerima transaksi riil.

Kabar baiknya, tidak ada biaya pendaftaran maupun langganan. Biaya hanya muncul saat ada transaksi. Rincian tarif sengaja tidak kami sebut di sini karena bisa berubah; lihat halaman pricing untuk angka terkini.

Langkah 2 — Pilih cara integrasi

BorderPay menyediakan beberapa jalur, dari tanpa koding sampai penuh lewat API. Pilih sesuai kemampuan tim dan kebutuhan website Anda.

Untuk kebanyakan pemilik toko, Embed Checkout adalah titik tengah yang enak: Anda cukup menempelkan satu snippet ke halaman, dan pembeli mendapat tampilan pembayaran QRIS yang rapi tanpa Anda membangun UI sendiri. Bila jualan lebih banyak lewat percakapan, payment link praktis dibagikan langsung ke pembeli.

Developer yang ingin alur otomatis (misalnya QR dibuat begitu pembeli menekan "Bayar") sebaiknya pakai REST API. BorderPay juga menyediakan endpoint discovery GET /payment-methods sehingga aplikasi Anda bisa menampilkan metode pembayaran yang tersedia secara dinamis. Detail teknisnya ada di dokumentasi.

Langkah 3 — Buat QRIS dinamis

Inti dari cara terima QRIS di website adalah membuat charge QRIS untuk setiap pesanan. Alurnya kurang lebih:

1. Pembeli menyelesaikan keranjang dan menekan tombol bayar.
2. Website Anda meminta pembuatan pembayaran QRIS dengan nominal sesuai total order (lewat dashboard, Embed Checkout, atau API).
3. BorderPay mengembalikan QR dinamis yang menampilkan nominal otomatis.
4. Pembeli memindai QR dari aplikasi pembayaran apa pun yang mendukung QRIS.

Satu hal penting soal masa berlaku: QRIS berlaku 60 menit. Setelah itu kode otomatis kedaluwarsa — tidak ada mekanisme bayar-telat. (Sebagai perbandingan, Virtual Account berlaku lebih lama, 24 jam.) Karena itu, tampilkan hitung mundur atau instruksi jelas di halaman pembayaran agar pembeli tidak menunda. Jika kedaluwarsa, cukup buatkan QR baru.

Ingin menawarkan alternatif selain QR? Anda juga bisa menyediakan Virtual Account di checkout yang sama. Pelajari bedanya di QRIS vs Virtual Account supaya bisa memilih metode yang paling pas untuk pembeli Anda.

Langkah 4 — Pastikan pembayaran lewat webhook

Ini bagian yang paling sering diabaikan padahal krusial. Jangan mengandalkan pembeli menekan tombol "Saya sudah bayar", dan jangan pula menganggap pembayaran sukses hanya karena halaman QR ditutup. Sumber kebenaran adalah webhook dari BorderPay.

Webhook adalah notifikasi otomatis yang dikirim server BorderPay ke endpoint di server Anda saat status pembayaran berubah. Event yang perlu Anda tangani:

• payment.paid — pembayaran berhasil; di sinilah Anda menandai order lunas dan memproses pesanan.
• payment.expired — QR kedaluwarsa tanpa dibayar.
• payment.failed — pembayaran gagal.

Beberapa praktik wajib di sisi merchant:

• Verifikasi tanda tangan HMAC. Setiap notifikasi ditandatangani agar Anda yakin benar-benar berasal dari BorderPay, bukan pihak lain yang memalsukan. Selalu validasi tanda tangan sebelum memproses.
• Terapkan idempotensi. Webhook bisa terkirim lebih dari sekali. Pastikan memproses event yang sama dua kali tidak menggandakan order atau pengiriman barang.
• Balas cepat, proses belakangan. Terima notifikasi, simpan, lalu balas 200; kerjakan logika berat secara asinkron.

BorderPay juga menyimpan log webhook dan mendukung kirim ulang, sehingga jika endpoint Anda sempat down, Anda tetap bisa memulihkan status. Untuk detail teknis event dan payload, lihat dokumentasi sebelum Anda mulai menyusun endpoint penerima.

Langkah 5 — Uji end-to-end di sandbox

Sebelum menerima uang riil, jalankan pengujian menyeluruh di mode test:

• Buat QRIS dinamis dengan beberapa nominal berbeda.
• Simulasikan pembayaran sukses dan pastikan payment.paid masuk serta order berubah lunas.
• Biarkan satu QR kedaluwarsa untuk memverifikasi penanganan payment.expired.
• Kirim ulang webhook untuk menguji idempotensi.

Setelah semua hijau di sandbox, selesaikan KYC (jika belum) lalu pindah ke mode live.

Setelah pembayaran: settlement dan penarikan

Uang yang masuk tidak langsung mendarat di rekening Anda begitu QR dibayar. Dana tertahan sebentar lalu tersedia sesuai jadwal per metode. Perhitungan mengikuti hari kerja, melewati akhir pekan dan libur nasional. Status serta tanggal ketersediaan selalu tampil di dashboard, jadi Anda tidak perlu menebak.

Untuk mencairkan saldo, penarikan diproses otomatis ke rekening bank Indonesia. Ada biaya per penarikan (lihat pricing), dan bila penarikan gagal, saldo dikembalikan penuh ke akun Anda.

Keamanan dan kepatuhan

Karena BorderPay berjalan di atas mitra berlisensi Bank Indonesia, pemrosesan dan penyimpanan dana ditangani pihak yang tunduk pada ketentuan yang berlaku. Tugas Anda sebagai merchant tetap penting: lindungi kunci API, verifikasi tanda tangan webhook, dan jangan pernah menganggap pembayaran sah tanpa konfirmasi dari webhook. Untuk limit transaksi QRIS dan aturan terkait, ikuti ketentuan yang berlaku dari otoritas terkait — jangan mematok angka sendiri. Punya pertanyaan lanjutan soal alur ini? Cek FAQ.

Penutup

Menerima QRIS di website tidak rumit bila alurnya jelas: daftar dan uji di sandbox, selesaikan KYC untuk go-live, buat QRIS dinamis per pesanan, dan andalkan webhook (dengan verifikasi tanda tangan + idempotensi) sebagai sumber kebenaran status. Karena QRIS hanya berlaku 60 menit, buat halaman pembayaran yang jelas agar pembeli tidak menunda. Mulai tanpa biaya pendaftaran di register, pelajari detail di dokumentasi, dan cek FAQ bila ada pertanyaan lanjutan.