Cara Pakai TemanQRIS, dari nol sampai dibayar.
Panduan langsung buat mulai terima pembayaran QRIS dinamis. Cocok untuk pemula, UMKM, dan developer. Setupnya kira-kira lima menit, tanpa drama.
Sebelum mulai, siapkan ini
QRIS statis, yaitu kode QR tanpa nominal yang kamu dapat dari e-wallet atau bank. Belum punya? Daftar gratis dulu di GoPay, OVO, DANA, atau bank kamu.
TemanQRIS tetap butuh QRIS statis dari PSP atau bank. Setelah itu, dashboard kami yang mengurus nominal dinamis, payment link, webhook, dan callback supaya transaksi lebih rapi.
Pilih fitur yang mau kamu pelajari dulu.
Daftar akun gratis
Buat akun TemanQRIS pakai email kamu. Nggak perlu bayar, nggak perlu kartu kredit. Cukup isi nama, email, dan password, selesai dalam 30 detik.
Tips: pakai email aktif supaya nggak ketinggalan info penting.
Daftar sekarangUpload QRIS statis
Buka menu Generator, lalu upload gambar QRIS statis kamu. Bisa foto dari HP atau screenshot, yang penting jernih dan tidak blur.
Tips: cukup upload sekali. Setelah itu kamu bisa generate QRIS berulang kali tanpa upload ulang.
Isi nominal, lalu bagikan
Masukkan nominal yang mau ditagih, klik Generate. QRIS dinamis siap diunduh atau dibagikan ke pelanggan lewat WhatsApp, Telegram, dan lainnya.
Buat payment link atau generate QRIS
Setelah login, buka menu Payment Links atau Generate QRIS di dashboard. Isi nominal dan deskripsi pembayaran, link langsung jadi.
Tips: payment link cocok untuk invoice, tagihan, atau jualan online tanpa coding.
Buat payment linkKirim ke pelanggan
Salin link pembayaran lalu kirim lewat WhatsApp, Telegram, email, atau tempel di website. Pelanggan tinggal buka dan scan QRIS.
Konfirmasi di Cek Order
Setelah bayar, pelanggan menekan Sudah Bayar. Ordernya muncul di menu Cek Order dengan status Menunggu Konfirmasi, tinggal kamu cek mutasi lalu approve.
Lihat Cek OrderWebhook sudah aktif untuk integrasi otomatis
Kalau kamu mengisi webhook_url dan sudah membuat Webhook Secret di Settings, bagian API & Webhook, server TemanQRIS mengirim notifikasi ke servermu saat pelanggan menekan Sudah Bayar. Kalau mengisi callback_url, halaman bayar menampilkan tombol Kembali ke Merchant yang mengarah ke halaman terima kasih atau detail order milikmu. Pelanggan sendiri yang menekan tombol itu, tidak ada redirect otomatis.
# Atau buat lewat API
curl -X POST https://temanqris.com/api/qris/payment-link \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"amount": 125000,
"description": "Invoice INV-2026-0001",
"order_id": "INV-2026-0001",
"webhook_url": "https://company.com/webhooks/temanqris",
"callback_url": "https://company.com/orders/INV-2026-0001/thank-you"
}'
# callback_url jadi tombol "Kembali ke Merchant" di halaman bayar.
# Pelanggan tidak di-redirect otomatis, dia sendiri yang menekan tombolnya.
Webhook memakai header X-TemanQRIS-Signature untuk verifikasi. Event yang umum diterima: payment.awaiting_confirmation saat pelanggan konfirmasi bayar, dan payment.confirmed setelah kamu memverifikasi pembayarannya.
Ambil Merchant ID
Login ke dashboard, buka menu Widget, lalu salin Merchant ID kamu. Ini ID unik untuk widget-mu.
Tips: Merchant ID itu ID publik khusus widget, bukan API Key, jadi aman ditaruh di HTML. API Key tetap jangan pernah ditempel di halaman website.
Lihat Merchant IDTempel satu baris kode
Taruh tag script ini di halaman, di tempat kamu mau tombol bayar muncul. Ganti YOUR_MERCHANT_ID dengan Merchant ID kamu.
<script src="https://temanqris.com/widget.js"
data-merchant="YOUR_MERCHANT_ID"></script>
| Atribut opsional | Fungsinya |
|---|---|
data-amount="50000" | Nominal tetap |
data-button-text="Bayar Sekarang" | Teks tombol |
data-button-color="#22c55e" | Warna tombol |
data-description="Pembayaran Invoice" | Deskripsi pembayaran |
data-callback="https://yoursite.com/thank-you" | Callback URL. Widget mengalihkan pelanggan ke URL ini otomatis setelah konfirmasi, dengan query order_id, amount, dan status. Jangan jadikan ini bukti bayar, tunggu webhook. |
data-webhook="https://yoursite.com/webhook" | Webhook untuk notifikasi ke servermu |
Widget siap dipakai
Setelah kode terpasang, tombol Bayar dengan QRIS muncul otomatis. Pelanggan klik, masukkan nominal, scan QRIS, beres. Widget jalan di mode manual, jadi tetap cek dan konfirmasi ordernya di Cek Order.
Untuk opsi lanjutan dan integrasi API, lihat API Documentation.
Pertanyaan yang sering muncul.
Belum ketemu jawabannya? Tanya langsung ke admin.
Apa bedanya QRIS statis dan dinamis?
Di QRIS statis, pelanggan mengetik nominal sendiri saat bayar. Di QRIS dinamis nominal sudah terisi otomatis, jadi lebih cepat dan nggak ada risiko salah ketik. TemanQRIS membantu mengubah QRIS statis jadi dinamis dengan nominal sesuai kebutuhanmu.
Apakah TemanQRIS gratis?
Ya, gratis untuk mulai. Kamu bisa generate sampai 50 request per hari tanpa bayar (batas bawaan). Kalau butuh lebih banyak, tinggal upgrade ke Premium dengan harga terjangkau.
Uangnya masuk ke mana?
Di mode manual, uang langsung masuk ke akun GoPay, OVO, DANA, atau bank yang QRIS-nya kamu upload. TemanQRIS tidak memegang dananya. Di mode gateway otomatis, dana masuk ke wallet TemanQRIS kamu dan bisa dicairkan dari dashboard.
Apakah ada notifikasi pembayaran?
Webhook sudah aktif. Buat dulu Webhook Secret di Settings, bagian API & Webhook, karena tanpa secret webhook tidak dikirim. Lalu isi webhook_url saat membuat payment link, generate QRIS, atau memasang widget. Servermu akan menerima event payment.awaiting_confirmation dan payment.confirmed dengan header X-TemanQRIS-Signature untuk verifikasi. Isi juga callback_url kalau mau halaman bayar menampilkan tombol Kembali ke Merchant setelah pelanggan menekan Sudah Bayar.
Berapa lama QRIS dinamis berlaku?
QRIS dinamis yang di-generate berlaku 24 jam untuk akun Free dan 7 hari untuk Premium (bawaan, bisa diubah admin). Setelah itu, generate ulang kalau pelanggan belum membayar.