Hubungkan mesin kasir dengan program loyalitas Anda
BonusQR bisa berjalan sendiri dengan pemindai di ponsel. Jika Anda ingin mesin kasir ikut menangani loyalitas, penyedia POS Anda bisa menghubungkannya lewat REST API kami yang terdokumentasi – kasir memindai kode pelanggan, menerapkan diskon, dan menukarkan hadiah dalam satu langkah.
- REST API terdokumentasi
- Diskon dan hadiah di kasir
- Opsional – BonusQR tetap berjalan tanpanya

Kartu loyalitas dipindai – diskon 10% diterapkan
Apa itu integrasi POS untuk program loyalitas?
Integrasi POS untuk program loyalitas membuat mesin kasir Anda terhubung dengan program loyalitas. Alih-alih memindai di aplikasi terpisah, staf memindai kode QR loyalitas pelanggan di kasir, lalu mesin kasir menerapkan keuntungan dari program.
BonusQR menyediakan REST API untuk ini. Mesin kasir mengirim kode yang dipindai dan, jika perlu, jumlah tagihan. BonusQR membalas dengan tindakan yang harus dilakukan – menerapkan diskon persentase atau nominal, menukarkan kupon atau hadiah poin – beserta pesan siap pakai untuk staf.
Integrasi ini opsional dan dibuat sebagai proyek khusus bersama penyedia POS Anda. Kunci API diterbitkan oleh BonusQR, dan biaya integrasi dihitung terpisah.
Apa yang didapat mesin kasir dari satu kali pindai
Cuplikan dokumentasi API interaktif yang dipakai penyedia POS Anda untuk menghubungkan mesin kasir.
- 1
Mengenali pelanggan
Mesin kasir memindai kode QR loyalitas dan mendapatkan nama pelanggan, nomor kunjungan, dan saldo-saldonya.
- 2
Menerapkan diskon
Diskon persentase atau nominal dikirim balik sebagai tindakan yang diterapkan mesin kasir pada tagihan.
- 3
Menukarkan hadiah
Kupon, hadiah poin, dan pembayaran dengan saldo cashback ditukarkan langsung di kasir.
- 4
Pesan untuk staf
Setiap balasan berisi pesan siap pakai untuk staf dalam bahasa usaha Anda.
/api/pos/configPengaturan program loyalitas untuk kasir/api/pos/scanPindai kode di kasir{ "code": "12345", "bill_amount": 12.50 }Responses{
"status": "completed",
"kind": "customer",
"customer": { 1
"name": "Siti Rahmawati",
"visit_number": 12,
"loyalty": { "credit": 13.55 }
},
"actions": [{ 2
"type": "apply_percent_discount",
"percent": 10,
"reason": "Member klub loyalitas"
}],
"messages": [{ 4
"level": "warning",
"title": "Diskon 10%",
"lines": ["Potong dari tagihan."]
}],
"rewards_earned": []
}/api/pos/scan/{scan_id}Kirim jumlah tagihan atau jumlah item/api/pos/scan/{scan_id}/cancelBatalkan pemindaian yang tertundaPenyedia POS Anda mendapat dokumentasi API interaktif dan kasir demo untuk mencoba integrasinya.
Cara kerja integrasi
Beginilah satu transaksi berjalan dengan mesin kasir yang terhubung.
- PelangganKasirMenunjukkan kode QR loyalitas
- KasirBonusQRMengirim kode yang dipindai
POST /api/pos/scan - BonusQRKasirMenanyakan jumlah tagihan jika perlu
input_required - KasirBonusQRMenjawab dengan jumlah yang dibayar pelanggan
POST /api/pos/scan/{scan_id} - BonusQRKasirMengirim diskon, hadiah, dan pesan untuk staf
completed - KasirMenerapkan diskon dan menyelesaikan penjualan
- BonusQRPelangganMelihat stempel, poin, dan hadiah di aplikasi
Integrasi dirancang agar program loyalitas tidak pernah menahan pembayaran: jika BonusQR tidak menjawab, penjualan tetap berjalan.
Tanpa integrasi, staf cukup memindai dengan ponsel atau tablet – BonusQR tetap berjalan sepenuhnya sendiri.
Bisa dipakai dengan semua program loyalitas
API memahami semua program dalam penawaran Anda. Misalnya:
Hadiah yang didapat di kasir muncul di aplikasi pelanggan untuk kunjungan berikutnya.
Kartu Stempel – kasir mengirim jumlah item
Diskon Tetap – potongan persentase dari tagihan
Cashback – saldo membayar tagihan sebagai diskon nominal
Kupon hadiah – ditukarkan saat pembayaran
Poin – hadiah dari katalog ditukarkan di kasir
Hadiah Berdasarkan Belanja – tagihan dihitung menuju kupon berikutnya
REST APIDibuat untuk proses pembayaran sungguhan
Mesin kasir memindai saat pembayaran. Jika BonusQR membutuhkan data tambahan – jumlah tagihan atau jumlah item – sistem akan memintanya dan mesin kasir menjawab. Pemindaian yang tertunda bisa dibatalkan, dan penjualan tidak pernah terhambat.
- Status jelas: selesai, perlu input, gagal
- Pemindaian tertunda bisa dibatalkan
- Nominal dalam mata uang usaha Anda
- Hingga 60 permintaan per menit per kunci
Integrasi POS vs. pemindai BonusQR
Keduanya bisa dipakai. Pilih yang paling cocok untuk meja kasir Anda.
Integrasi POS
- Penyiapan
- Proyek khusus bersama penyedia POS Anda
- Tempat staf memindai
- Di mesin kasir
- Diskon
- Diterapkan otomatis oleh mesin kasir
- Harga
- Dihitung terpisah
Pemindai BonusQR
- Penyiapan
- Siap dalam hitungan menit
- Tempat staf memindai
- Di ponsel, tablet, atau pemindai meja
- Diskon
- Ditampilkan ke staf, yang lalu menerapkannya
- Harga
- Termasuk di semua paket
Pertanyaan seputar integrasi POS
Yang paling sering ditanyakan pemilik usaha dan penyedia POS.
Apakah saya perlu integrasi POS untuk memakai BonusQR?
Tidak. BonusQR berjalan sepenuhnya sendiri – staf memindai kode pelanggan dengan ponsel, tablet, atau pemindai meja. Integrasi bersifat opsional.
Sistem POS apa saja yang bisa dihubungkan?
Sistem apa pun yang penyedianya bisa memanggil REST API. BonusQR tidak punya plugin siap pakai untuk merek mesin kasir tertentu; penyedia Anda menghubungkannya menggunakan dokumentasi kami.
Berapa biaya integrasinya?
Karena merupakan proyek khusus, biayanya dihitung terpisah. Hubungi kami dan kami akan menyiapkan penawaran bersama penyedia POS Anda.
Bagaimana kami mendapatkan kunci API?
BonusQR menerbitkannya atas permintaan. Satu kunci bisa dibatasi untuk satu outlet usaha Anda.
Apa yang diterima mesin kasir setelah pemindaian?
Nama pelanggan, nomor kunjungan, dan saldo-saldonya, tindakan yang harus diterapkan – diskon persentase atau nominal, kupon, atau hadiah poin – hadiah yang didapat, serta pesan siap pakai untuk staf.
Bagaimana jika mesin kasir membutuhkan informasi tambahan?
BonusQR akan memintanya – misalnya jumlah tagihan atau jumlah item – dan mesin kasir menjawab. Pemindaian yang tertunda juga bisa dibatalkan.
Apakah ada dokumentasinya?
Ada. Tersedia dokumentasi API interaktif, beserta kasir demo yang bisa dipakai penyedia Anda untuk pengujian.
Bagaimana dengan toko online?
Untuk WooCommerce dan Shopify tersedia integrasi siap pakai di paket Basic.
Ingin program loyalitas langsung di kasir Anda?
Beri tahu kami POS yang Anda gunakan, dan kami akan menyiapkan penawaran integrasinya.