Panduan Integrasi

Menampilkan Kurs Live di Website Anda

Hotel, travel agent, dan partner sering ingin menampilkan kurs gerai Anda sendiri di website mereka. Dengan endpoint GET /v1/rates, Anda atau webmaster Anda bisa menarik kurs terbaru lalu menampilkannya sebagai tabel atau ticker.

Praktik terbaik: tarik data dari server backend Anda (bukan browser) setiap 1–5 menit, simpan sementara (cache), lalu sajikan ke pengunjung. Dengan begitu API key tetap aman di server dan beban request tetap rendah.

• Buat API key khusus integrasi dari dashboard (dapat dirotasi kapan saja).
• Simpan API key di environment variable backend — jangan di kode frontend.
• Tarik kurs berkala, lalu render sesuai desain website Anda.
• Tampilkan waktu pembaruan kurs agar pengunjung tahu kebaruannya.

Menyinkronkan Laporan ke Sistem Akuntansi

Endpoint GET /v1/transactions mengembalikan seluruh transaksi per rentang tanggal lengkap dengan kurs, mata uang, kasir, dan gerai. Formatnya siap dipetakan ke jurnal sistem akuntansi Anda.

Karena ledger Valasin berbasis double-entry, mapping ke sistem akuntansi menjadi sederhana: setiap transaksi sudah menghasilkan pasangan debet-kredit yang seimbang — tidak perlu penyesuaian manual di akhir bulan.

• Tarik transaksi setiap akhir hari (scheduler cron pada pukul 00:05 cukup).
• Petakan akun: kas IDR, posisi valas per mata uang, dan pendapatan spread.
• Simpan id transaksi sebagai referansi unik untuk audit silang.

Menghubungkan Printer Thermal Bluetooth

Smart POS mendukung printer thermal Bluetooth 58mm dan 80mm yang umum di pasaran. Proses penyambungan sekali saja per perangkat:

• Nyalakan printer dan pastikan Bluetooth perangkat POS aktif.
• Buka menu Pengaturan Perangkat di Smart POS, pilih Printer, lalu pilih printer Anda dari daftar.
• Cetak halaman uji untuk memastikan hasil cetak rapi.
• Selesai — struk otomatis tercetak pada setiap transaksi.

Menampilkan Kurs di TV atau Layar Gerai

Papan kurs digital di gerai membuat pelanggan berhenti menebak-nebak. Banyak pemilik money changer memakai TV Android atau mini PC yang menampilkan halaman papan kurs yang menarik data dari API yang sama — tanpa perlu dioperasikan kasir.

• Siapkan TV/layar dengan browser (TV Android, Chromecast, atau mini PC).
• Bangun halaman sederhana yang membaca kurs dari backend Anda (yang menarik GET /v1/rates secara berkala).
• Sajikan kurs jual-beli per mata uang dengan waktu pembaruan yang terlihat.
• Atur auto-refresh tiap 1–5 menit — hemat kuota, tapi tetap terasa live.

Butuh Integrasi Lain?

Tim kami berpengalaman menghubungkan Valasin dengan berbagai sistem: PMS hotel, situs travel, hingga ERP internal. Untuk kebutuhan khusus, jadwalkan sesi bersama tim teknis kami — integrasi Enterprise termasuk pendampingan hingga production.

Hubungi kami lewat WhatsApp atau email dengan gambaran sistem Anda, dan kami bantu merancang alur integrasinya.