FQrisDocs
Panduan

Bot Telegram & WhatsApp

Buat tagihan QRIS dan cek pembayaran langsung dari chat Telegram atau WhatsApp.

5 menit bacaDiperbarui 2 Nov 2026

Menautkan chat

Bot hanya menjawab chat yang sudah ditautkan ke akun FQris-mu. Buka Dasbor, Notifikasi, lalu pilih salah satu kanal di bawah. Kode tautan berlaku 10 menit dan hanya bisa dipakai sekali.

Telegram: tekan Hubungkan Telegram. Telegram terbuka ke bot FQris; tekan Start untuk menautkan chat itu.

WhatsApp: tekan Hubungkan WhatsApp. WhatsApp terbuka dengan pesan siap kirim berisi HUBUNGKAN <kode>; kirim pesan itu ke nomor bot FQris. Pesan yang sama bisa kamu ketik sendiri bila tidak terbuka otomatis.

Bot hanya menjawab chat pribadi. Grup tidak bisa ditautkan dan diabaikan.

Perintah

/tagih <nominal> [deskripsi] membuat payment dan membalas gambar QR beserta link checkout. Contoh: /tagih 20.000 kopi. Nominal berupa bilangan bulat rupiah, boleh ditulis 20000 atau 20.000. Singkatan seperti 20rb atau 20k tidak didukung. Deskripsi boleh dikosongkan. Balasan memuat nominal akhir yang harus dibayar (sudah termasuk kode unik) dan batas waktu bayar.

/status <id atau reference> mengecek status satu payment. Contoh: /status pay_01JA2Z3K8M. Kamu juga bisa memakai reference_id yang kamu pasang saat membuat payment.

/hariini meminta ringkasan hari ini: jumlah dan total payment lunas, payment yang masih menunggu bayar, dan rekonsiliasi yang masih terbuka.

/perangkat menampilkan status tiap perangkat Listener: online, degraded, atau offline, beserta waktu heartbeat terakhirnya.

/link <slug> mengirim payment link beserta gambar QR-nya. Contoh: /link kopi-susu.

/proyek menampilkan daftar project-mu bernomor, dan /proyek 2 memilih project nomor 2 sebagai default.

/mode test atau /mode live memilih mode default. /bantuan menampilkan daftar perintah; perintah yang tidak dikenal juga dijawab dengan daftar itu.

Aturan

Setiap perintah berjalan di satu project dan satu mode default. Bila kamu hanya punya satu project, bot langsung memakainya; bila lebih, bot meminta kamu memilih dengan /proyek. Mode bawaannya live, dan /mode mengubahnya.

Label [MODE TEST]
Setiap balasan dalam mode test diawali [MODE TEST] supaya payment uji tidak tertukar dengan payment live. Cek label itu sebelum membagikan QR ke pembeli.

Hak akses mengikuti role-mu di dasbor: /tagih butuh izin membuat payment, /perangkat butuh izin melihat perangkat. Bila merchant mewajibkan verifikasi dua langkah (2FA), aktifkan 2FA di dasbor dulu. Bot tidak melewati aturan akses dasbor.

Bot membatasi 20 perintah per menit per chat. Lewat batas itu, bot membalas "Terlalu banyak perintah" dan kamu bisa mencoba lagi sebentar lagi. Bila satu chat tertaut ke lebih dari satu akun FQris, bot meminta kamu memutus salah satunya di halaman Notifikasi.

Catatan WhatsApp

Gambar QR di WhatsApp
Gambar QR untuk /tagih dan /link butuh paket Fonnte yang mendukung lampiran. Tanpa itu, bot otomatis mengirim teks berisi link checkout. Pembayaran tetap bisa dilakukan dari link itu.
Apakah halaman ini membantu?