Kekasir menyediakan integrasi QRIS dinamis menggunakan akun Doku milik outlet. Dana diterima pada akun merchant Anda. Pengaturan integrasi hanya dapat diubah owner; akun admin atau kasir tidak menggantikan akun owner untuk menghubungkan payment gateway.
Contoh penggunaan
Owner Kedai Panduan Baru menambahkan Doku dalam mode Sandbox. Contoh memakai identitas dan kunci latihan lokal. Tidak ada kredensial merchant nyata di dalam gambar panduan.
Contoh lain: outlet menghubungkan akun production yang sudah disetujui Doku, atau memeriksa kembali pasangan kunci dan URL notifikasi setelah pengaturan merchant diperbarui.
Siapkan akun merchant
Siapkan Client ID, Secret Key, Merchant ID dan private key RSA milik akun merchant sesuai lingkungan yang dipakai. Pasangan merchant public key harus sudah terdaftar di Doku. Terminal pembayaran ditentukan otomatis oleh Kekasir berdasarkan kanal kasir atau self-order dan tidak perlu diisi owner. Jangan membagikan Secret Key atau private key kepada pelanggan maupun dalam screenshot bantuan.
Buka form sebagai owner
Masuk sebagai owner ke outlet tujuan, buka Pengaturan → Pembayaran Non Tunai. Pada bagian Integrasi Pembayaran, pilih + Tambah Provider, lalu pilih Doku. LinkQu dan Midtrans yang berlabel Segera hadir belum dapat dipilih.
Mode mengikuti server agar pembuatan QR dan notifikasi pembayaran berada pada lingkungan yang sama. Jangan mencampur kredensial sandbox dengan production.
Isi kredensial
Isi Client ID, Secret Key, Merchant ID dan private key RSA berformat PEM, minimal 2048 bit. Gunakan pasangan kunci yang benar untuk akun merchant tersebut. Aktifkan integrasi, lalu pilih Simpan.
Secret Key dan private key disimpan sebagai data rahasia. Setelah tersimpan, aplikasi hanya menampilkan sebagian kecil nilainya agar owner dapat mengenali kredensial tanpa membuka seluruh rahasia.
Kredensial baru atau yang diubah akan berstatus Perlu diuji. Status ini menunjukkan konfigurasi sudah tersimpan tetapi belum dinyatakan siap menerima pembayaran.
Uji sebelum mengaktifkan
Pilih Uji QRIS. Salin URL Notifikasi Pembayaran dan daftarkan sebagai callback QRIS pada dashboard Doku. Gunakan Unduh Merchant Public Key jika Doku meminta public key merchant. Pada production, gunakan URL aplikasi produksi; URL 127.0.0.1 pada gambar adalah lingkungan latihan lokal dan tidak dapat menerima notifikasi dari internet.
Isi nominal, lalu pilih Buat QR Uji. Periksa pesan hasil, QR, nominal dan waktu kedaluwarsa.
QR sandbox tidak menerima pembayaran nyata. QR production dapat dibayar, tetapi QR uji tidak tercatat sebagai transaksi kasir. Untuk pemeriksaan koneksi saja, jangan membayar QR production tersebut.
Setelah uji berhasil, status integrasi berubah menjadi siap digunakan. Periksa juga metode QRIS Dinamis serta fitur pembayaran yang dipakai outlet. Pengaturan tampilan katalog saja tidak mengaktifkan pembayaran online.
Mengganti kredensial
Selesaikan pembayaran QRIS yang masih pending sebelum mengganti atau menghapus kredensial. Sistem menolak perubahan yang berisiko memutus QR pending. Menonaktifkan integrasi menghentikan pembuatan QR baru; notifikasi pembayaran pending tetap perlu diterima dan diproses.
Jika uji gagal, periksa mode, pasangan kunci, identitas merchant dan pendaftaran public key di Doku. Jangan berulang kali mengganti akun merchant saat pelanggan masih menunggu pembayaran.