Panduan ini membawa Anda dari pendaftaran akun Duitku sampai proyek Duitku terhubung dan teruji di Kekasir. Bahasa dan urutannya disederhanakan agar mudah diikuti oleh pemilik usaha yang baru pertama kali memakai payment gateway.
Yang perlu disiapkan
Untuk akun usaha perorangan, siapkan:
- KTP pemilik usaha.
- NPWP jika diminta pada jenis akun yang dipilih.
- Informasi rekening bank untuk pencairan.
- Logo usaha.
- Foto bagian depan tempat usaha atau area kerja.
- Website atau katalog online yang aktif dan dapat dibuka.
- Nomor telepon serta email aktif untuk verifikasi.
Pastikan website menampilkan kontak usaha, alamat, email, produk yang sesuai dengan usaha, serta harga dalam Rupiah. Duitku dapat meminta dokumen tambahan sesuai jenis produk atau hasil pemeriksaan.
Daftar akun Duitku
Buka panduan resmi akun Duitku, lalu pilih tautan pendaftaran yang tersedia. Isi data akun, buka email verifikasi, dan periksa folder Spam atau Promosi jika email belum terlihat. Setelah itu selesaikan OTP nomor telepon dan masuk ke dashboard Duitku.
Aktifkan akun merchant
Di dashboard, buka Merchant Application Form dan lengkapi seluruh data serta dokumen yang diminta. Tim Duitku akan memeriksa akun dan website yang didaftarkan. Setelah akun disetujui, ubah environment dashboard ke Production untuk membuat proyek yang menerima pembayaran nyata.
Anda dapat mengikuti bagian Aktivasi Akun pada dokumentasi Duitku sebagai referensi resmi.
Buat proyek Duitku
Buka Proyek Saya, lalu buat proyek untuk website atau outlet yang akan dihubungkan. Isi nama proyek, alamat website, logo, dan URL callback.
Saat pertama kali mencoba, gunakan mode Sandbox pada pemilih environment di kanan atas dashboard. Mode Production dipakai setelah akun dan kanal QRIS benar-benar aktif, karena transaksi di mode ini memakai uang nyata.
Gunakan proyek terpisah untuk outlet yang laporannya perlu dipisahkan. Setelah proyek dikirim, tunggu verifikasi dan aktivasi kanal QRIS oleh Duitku. Dokumentasi resminya tersedia pada bagian Integrasi Akun & Mendapatkan API Key.
Pasang URL callback proyek
Buka Proyek Saya → Edit proyek, lalu isi Url Callback Proyek dengan:
https://app.kekasir.id/api/v1/pos/webhooks/duitku
Callback ini digunakan Duitku untuk mengirim perubahan status pembayaran ke Kekasir. Pastikan tidak ada spasi tambahan dan proyek yang diedit adalah proyek outlet yang benar.
Ambil Merchant Code dan API Key
Merchant Code terlihat pada daftar Proyek Saya.
Untuk melihat API Key atau Merchant Key, buka Edit proyek, pilih tautan untuk melihat API Key, lalu masukkan kata sandi akun Duitku jika diminta.
Gunakan Merchant Code dan API Key dari environment yang sama. Proyek sandbox dan production memiliki kredensial berbeda.
Hubungkan Duitku di Kekasir
Masuk sebagai owner, buka Pengaturan → Pembayaran Non Tunai, lalu pilih + Tambah Provider → Duitku → Hubungkan. Pilih environment, isi Merchant Code dan API Key, kemudian simpan.
Uji dan aktifkan Duitku
Pilih Uji QRIS, masukkan nominal uji, lalu pilih Buat QR Uji. QR yang berhasil dibuat membuktikan kredensial dan kanal QRIS dapat digunakan. Perubahan status pembayaran tetap diterima melalui callback.
Setelah status integrasi menjadi Teruji, buka Pembayaran Non Tunai → QRIS Dinamis → Pilih Provider, lalu aktifkan Duitku. Hanya satu provider QRIS Dinamis yang aktif pada satu waktu.
Studi kasus
Owner Mie Tek-Tek mendaftar akun Duitku, melengkapi Merchant Application Form, lalu membuat proyek production. Owner memasang callback Kekasir, mengambil Merchant Code dan API Key, menyimpan integrasi, dan membuat QR uji. Setelah status menjadi Teruji, Duitku dipilih sebagai provider aktif.
Contoh lain
- Outlet kedua dapat memakai proyek Duitku terpisah supaya transaksi dan laporan lebih mudah dibedakan.
- Pemilik usaha dapat mencoba proyek sandbox lebih dahulu sebelum memakai production.
- Setelah API Key dirotasi, simpan key baru di Kekasir lalu ulangi pengujian.
Jika pengujian gagal
- Pastikan Merchant Code dan API Key berasal dari proyek yang sama.
- Pastikan environment proyek sesuai dengan pilihan di Kekasir.
- Pastikan akun, proyek, dan kanal QRIS sudah aktif.
- Pastikan URL callback sudah tersimpan dengan benar.
- Selesaikan atau tunggu pembayaran pending kedaluwarsa sebelum mengganti kredensial.