FQrisDocs
Referensi

FAQ

Jawaban singkat untuk pertanyaan yang paling sering muncul.

5 menit bacaDiperbarui 29 Okt 2026

Uang pembeli masuk ke mana?

Langsung ke QRIS milikmu, yaitu akun DANA Bisnis yang kamu daftarkan. FQris bersifat non-custodial: FQris tidak pernah menampung, memegang, atau meneruskan dana, hanya mencatat dan mengonfirmasi. Karena uangnya tidak lewat FQris, tidak ada settlement.

Berapa biaya FQris?

Tidak ada potongan per transaksi: uang pembeli masuk utuh ke QRIS-mu. Rencana harganya satu plan langganan bulanan, dan kebijakan finalnya diumumkan sebelum FQris dibuka untuk publik. Lihat halaman Harga untuk informasi terbaru.

Aplikasi apa yang bisa dipakai pembeli untuk membayar?

Aplikasi apa pun yang bisa memindai QRIS, seperti e-wallet dan m-banking. Pembeli yang membayar dari HP yang sama menekan Simpan QR di halaman checkout, lalu memilih gambar itu dari galeri di aplikasi pembayarannya.

Aplikasi QRIS mana yang didukung di sisi penerima?

Saat ini DANA Bisnis. Listener membaca notifikasi uang masuk dari DANA Bisnis, dan parsernya sudah terbukti dengan pembayaran uang nyata di produksi. Sumber lain belum didukung.

Kenapa nominal yang dibayar pembeli lebih besar dari harganya?

FQris menambahkan kode unik acak (rentang bawaan 1 sampai 499) ke nominal dasar, misalnya Rp20.000 menjadi Rp20.137. Kode unik itulah yang mencocokkan pembayaran ke payment yang tepat. Pembeli harus membayar final_amount persis.

Bagaimana kalau HP Listener mati atau offline?

Dashboard menandai perangkat Offline dan Owner mendapat notifikasi. Selama tidak ada Listener yang online, membuat payment live gagal dengan 503 NO_HEALTHY_SOURCE, kecuali project-mu diatur tetap menerimanya; payment itu ditandai detection_degraded. Notifikasi yang tertahan di antrean HP dikirim ulang setelah online, sampai 72 jam. Pembayaran yang terlewat bisa dicocokkan manual di Rekonsiliasi.

Bagaimana kalau pembeli membayar dengan nominal yang salah?

Kalau nominalnya tidak cocok dengan payment mana pun, payment aslinya tetap pending dan notifikasinya masuk antrean Rekonsiliasi. Owner atau Staff bisa menghubungkannya ke payment yang benar dengan catatan, menandainya bukan pembayaran FQris, atau membuat payment retroaktif.

Bagaimana kalau pembeli membayar setelah payment kedaluwarsa?

QR tetap bisa dibayar di aplikasi pembayar setelah expires_at, jadi FQris masih mencocokkan pembayaran selama masa tenggang, bawaan 30 menit. Payment menjadi paid dengan paid_late: true dan webhook payment.paid terkirim. Setelah masa tenggang habis, pembayaran itu masuk Rekonsiliasi.

Bagaimana refund bekerja?

FQris tidak memindahkan uang. Kamu mengembalikan dana ke pembeli secara manual lewat aplikasi DANA, lalu mencatatnya dengan POST /v1/payments/{id}/refunds. Status payment menjadi partially_refunded atau refunded, dan webhook payment.refunded terkirim. Refund yang salah catat bisa dibatalkan (void) dalam 24 jam.

Apa yang terjadi kalau webhook gagal terkirim?

FQris mencoba sampai 8 percobaan: segera, lalu setelah sekitar 30 detik, 2 menit, 10 menit, 30 menit, 1 jam, 3 jam, dan 6 jam. Respons 2xx dianggap sukses. Endpoint yang terus gagal selama 3 hari dinonaktifkan otomatis. Sebagai cadangan, ambil status lewat GET /v1/payments/{id}.

Berapa batas nominal dan masa berlaku payment?

Nominal dasar Rp1.000 sampai Rp5.000.000 dalam rupiah bulat; project bisa mempersempit rentang ini, dan di luarnya API menjawab AMOUNT_TOO_LOW atau AMOUNT_TOO_HIGH. Masa berlaku bawaan 15 menit, bisa diatur 5 sampai 60 menit lewat expiry_minutes. Satu project maksimal punya 2.000 payment pending.

Apakah halaman ini membantu?