FQrisDocs
SitusStatus
Mulai

Quickstart

Dari nol sampai pembayaran pertama terkonfirmasi otomatis di mode uji, sekitar 10 menit.

10 menit bacaDiperbarui 17 Okt 2026

Prasyarat

Kamu butuh akun FQris, satu project, dan API key test berawalan fq_test_. Mode uji tidak memerlukan QRIS terverifikasi, jadi kamu bisa mulai sebelum memasang Listener.

Mode uji terpisah total
API key, data, dan webhook test tidak pernah tercampur dengan live. Uang sungguhan yang dibayar ke QR uji tidak akan mencocokkan payment uji.

Gambaran alur

1. Instal SDK

terminal
1npm install @fqris/node

2. Buat payment

Kirim nominal dasar dalam rupiah bulat. FQris menambahkan kode unik dan mengembalikan final_amount serta checkout_url. Selalu kirim Idempotency-Key agar retry tidak membuat payment ganda.

buat-payment
1import FQris from '@fqris/node';
2const fqris = new FQris(process.env.FQRIS_KEY);
3
4const payment = await fqris.payments.create({
5 amount: 20000,
6 reference_id: 'TOPUP-88812',
7});
8console.log(payment.checkout_url);
Penting
Jangan pernah menaruh API key di aplikasi Android atau browser. Panggil API hanya dari backend.

3. Arahkan pembeli

  1. 1
    Redirect ke checkout_url Pembeli melihat QR, nominal Rp20.137, dan countdown 15 menit.
  2. 2
    Atau render qris.string Untuk aplikasi native, render string QR sendiri dan tetap pakai expires_at + server_time.
  3. 3
    Simulasikan bayar Di mode uji, tekan tombol Simulasikan bayar di checkout atau panggil POST /v1/sandbox/payments/{id}/simulate.

4. Terima webhook

Setelah pembayaran terdeteksi, FQris mengirim payment.paid ke endpoint-mu. Lanjutkan ke panduan Webhook untuk verifikasi signature.

Selesai
Pembayaran pertamamu sudah terkonfirmasi otomatis. Saat siap live, verifikasi QRIS source dengan pembayaran Rp1.000 + kode unik.
Apakah halaman ini membantu?