QRIS API: QRIS dinamis untuk setiap transaksi.
Buat kode QRIS dengan nominal terkunci lewat satu request, tampilkan di website atau aplikasi, dan terima webhook setelah pembeli membayar.
Uji dulu dengan test key, tanpa uang sungguhan.
curl https://api.fintar.id/v1/transactions \
-H "Authorization: Bearer ft_test_..." \
-H "Idempotency-Key: order-1234" \
-H "Content-Type: application/json" \
-d '{
"order_items": [
{ "name": "Kaos polos", "price": 75000, "quantity": 2 }
],
"external_id": "ORD-1234",
"payment_methods": ["qris"],
"customer": { "name": "Budi", "email": "budi@toko.dev" }
}'
Rp 150.000
Tiga langkah dari pesanan ke lunas.
Buat transaksi
Kirim POST /v1/transactions dengan payment_methods berisi "qris". Respons memuat qr_string.
Tampilkan QR
Ubah qr_string menjadi gambar QR di halaman sendiri. Nominal sudah terkunci, jadi pembeli tidak mengetik angka.
Terima webhook
Event payment.paid dikirim ke server setelah pembayaran berhasil. Status juga bisa dicek lewat GET /v1/transactions/:id.
Satu kode, semua aplikasi pembayaran.
- Semua aplikasi QRIS. Satu kode diterima GoPay, OVO, DANA, ShopeePay, LinkAja, dan aplikasi bank yang mendukung QRIS.
- Konfirmasi cepat. Konfirmasi masuk beberapa detik setelah kode di-scan dan dibayar.
- Tanpa data pembeli. QRIS tidak mewajibkan nama atau email pembeli.
- Rp1.000 sampai Rp10.000.000. Batas nominal default per pembayaran QRIS.
- Masa berlaku bisa diatur. Default 60 menit, dan bisa diatur sampai 24 jam lewat expires_in_minutes.
{
"id": "payreq_9b2f...",
"status": "pending",
"payment_method": "qris",
"payment": {
"type": "qr",
"qr_string": "00020101021226670016COM.FINTAR.WWW...6304A1B2"
},
"expires_at": "2026-08-27T13:00:00+07:00"
}
QRIS dinamis dan QRIS statis: apa bedanya?
QRIS statis adalah satu kode tetap yang dicetak dan dipakai berulang. Pembeli mengetik nominal sendiri, dan penjual mencocokkan pembayaran secara manual.
QRIS dinamis dibuat baru untuk setiap transaksi dengan nominal yang sudah terkunci, sehingga sistem tahu persis pesanan mana yang dibayar.
QRIS API Fintar menghasilkan QRIS dinamis. Karena setiap kode terikat pada satu transaksi, website atau aplikasi bisa menandai pesanan lunas secara otomatis begitu webhook masuk, tanpa memeriksa mutasi rekening.
Pertanyaan tentang QRIS API
Apakah QRIS dari Fintar bisa dibayar dari semua e-wallet?
Bisa dari aplikasi bank dan e-wallet yang mendukung QRIS, termasuk GoPay, OVO, DANA, ShopeePay, dan LinkAja.
Berapa nominal minimum dan maksimum QRIS?
Minimum Rp1.000 dan maksimum Rp10.000.000 per pembayaran. Batas yang berlaku untuk sebuah akun selalu bisa dicek lewat GET /v1/payment_methods.
Berapa lama kode QRIS berlaku?
Secara default 60 menit sejak dibuat. Masa berlaku bisa diatur lewat expires_in_minutes sampai 24 jam.
Bagaimana menguji QRIS tanpa uang sungguhan?
Pakai test key berawalan ft_test_. Di Sandbox, pembayaran bisa disimulasikan berhasil atau kedaluwarsa tanpa scan sungguhan.
Apakah pembayaran QRIS bisa di-refund?
Pembayaran QRIS tidak bisa dibatalkan atau di-refund lewat Fintar. Pengembalian dana ditransfer merchant dari rekening bank sendiri, di luar Fintar.
Apakah QRIS dari API bisa dicetak untuk dipajang di toko?
Tidak. QRIS dari API berlaku untuk satu transaksi dengan nominal tertentu. Untuk pembeli berikutnya, buat transaksi baru.
Terima QRIS dari website sendiri.
Buat akun, ambil test key, dan tampilkan QRIS pertama dalam beberapa menit.