Duitku

Panduan lengkap menghubungkan Duitku Payment Gateway dengan Alusio: dari registrasi merchant, konfigurasi Callback URL, sampai memilih metode pembayaran yang ditawarkan di checkout.

Duitku adalah payment gateway lokal Indonesia yang mendukung Virtual Account semua bank besar, eWallet (OVO, DANA, ShopeePay, LinkAja, dll), QRIS, kartu kredit, sampai gerai retail (Indomaret, Alfamart). Setelah dihubungkan, Alusio akan memproses pembayaran customer secara otomatis lewat halaman Duitku, lalu menerima notifikasi (webhook) saat status pembayaran berubah.

Duitku bisa diaktifkan bersamaan dengan gateway lain (Midtrans, Xendit, Stripe, PayPal). Customer akan melihat semua opsi yang aktif di halaman checkout.

Prasyarat

Akun merchant Duitku — daftar di duitku.com.
Akses ke Dashboard Duitku (Sandbox untuk uji coba, Produksi/Passport untuk live).
Toko Alusio sudah aktif. Custom domain tidak diperlukan — Duitku bekerja di [slug].alusio.com maupun custom domain.

Langkah 1 — Daftar & Verifikasi Akun Duitku

Buka duitku.com dan klik Daftar / Register.
Lengkapi data merchant: nama bisnis, NPWP/KTP, rekening pencairan (settlement).
Tunggu verifikasi tim Duitku (umumnya 1–3 hari kerja untuk akun Produksi). Untuk testing, Anda bisa langsung pakai Sandbox tanpa menunggu verifikasi.

Langkah 2 — Buat Proyek & Salin Kredensial

Login ke Dashboard Duitku (Sandbox: sandbox.duitku.com, Produksi: passport.duitku.com).
Masuk ke menu Proyek (atau Toko / Merchant) dan buat proyek baru jika belum ada.
Pilih proyek tersebut, lalu buka tab Informasi Merchant atau Pengaturan.
Catat dua nilai berikut — keduanya akan dipasang di Alusio:
- Merchant Code — kode unik proyek, biasanya diawali huruf D (contoh: DXXXX).
- API Key — string panjang yang berfungsi sebagai password. Jangan dibagikan ke publik.

Catatan: Sandbox dan Produksi punya Merchant Code & API Key yang berbeda. Pastikan Anda menyalin dari environment yang sesuai dengan mode yang akan dipakai.

Langkah 3 — Atur Callback URL di Dashboard Duitku

Callback URL adalah alamat yang akan dipanggil Duitku saat status pembayaran berubah (paid, expired, dll). Tanpa URL ini, order Anda tidak akan otomatis update ke status Paid.

Masih di halaman proyek, cari kolom Callback URL.
Isi dengan URL berikut:
```
https://alus.io/api/webhooks/duitku
```
Untuk Return URL (halaman tujuan setelah customer selesai bayar), biarkan kosong — Alusio sudah menanganinya secara otomatis di sisi checkout.
Simpan perubahan.

Langkah 4 — Pasang Kredensial di Alusio

Buka dashboard Alusio, masuk ke Settings → Payments.
Pilih tab Duitku.
Isi form:
- Merchant Code — dari Langkah 2.
- API Key — dari Langkah 2.
- Mode Produksi — biarkan off jika masih pakai Sandbox; aktifkan saat siap menerima pembayaran sungguhan.
Klik Simpan Pengaturan Duitku.

Langkah 5 — Pilih Metode Pembayaran yang Ditawarkan

Di bawah form kredensial ada seksi Metode yang Ditawarkan di Checkout. Centang metode yang ingin ditampilkan ke customer Anda — misalnya hanya BCA VA, QRIS, dan OVO. Pilihan tersedia mencakup:

Virtual Account — BCA, BNI, BRI, Mandiri, Permata, CIMB, Maybank, dll.
eWallet — OVO, DANA, ShopeePay, LinkAja, Jenius Pay.
QRIS — terhubung ke semua wallet/bank yang mendukung QRIS.
Kartu Kredit — Visa, Mastercard, JCB.
Retail — Indomaret, Alfamart (bayar tunai di kasir).
Paylater — Kredivo, Akulaku, Atome (tergantung ketersediaan di akun Anda).

Jika tidak ada yang dicentang, Duitku akan otomatis menampilkan semua metode yang aktif di akun merchant Anda.

Langkah 6 — Uji Transaksi Sandbox

Pastikan Mode Produksi masih off dan kredensial yang dipasang adalah dari Sandbox.
Buka site Anda, tambahkan produk ke cart, lalu lanjut ke checkout.
Pilih salah satu metode Duitku — misal BCA Virtual Account.
Di halaman Duitku Sandbox, ikuti instruksi simulasi pembayaran (Duitku menyediakan tombol Simulate Paid untuk VA).
Kembali ke Alusio, buka Orders — status order harus berubah menjadi Paid dalam beberapa detik (lewat webhook).

Langkah 7 — Naik ke Mode Produksi

Login ke Duitku Passport (Produksi) dan ulangi Langkah 2 untuk menyalin Merchant Code dan API Key Produksi.
Pastikan Callback URL produksi sudah diisi seperti Langkah 3.
Di Alusio, ganti Merchant Code & API Key dengan kredensial Produksi, lalu aktifkan toggle Mode Produksi.
Simpan dan lakukan satu transaksi kecil untuk verifikasi.

Troubleshooting

Gejala	Penyebab & Solusi
Order tetap Pending meski sudah dibayar	Callback URL salah atau belum diisi di Dashboard Duitku. Pastikan persis `https://alus.io/api/webhooks/duitku` dan tidak ada slash di akhir.
Error "Invalid Signature" saat checkout	API Key tidak cocok dengan environment. Kredensial Sandbox tidak bisa dipakai saat Mode Produksi aktif (dan sebaliknya).
Metode pembayaran tidak muncul di checkout	Cek seksi Metode yang Ditawarkan — pastikan metode tersebut dicentang. Atau, metode tersebut belum diaktifkan di akun Duitku Anda (hubungi support Duitku).
Pembayaran sukses tapi customer tidak diredirect kembali	Normal — Duitku tidak otomatis redirect dari beberapa metode (VA, retail). Customer akan melihat instruksi di Duitku, lalu mengecek status di halaman Order Confirmation Alusio.

Catatan Keamanan

API Key bersifat rahasia. Jangan share screenshot dashboard yang menampilkan key utuh.
Jika API Key bocor, segera regenerate di Dashboard Duitku dan update di Alusio.
Webhook Duitku diverifikasi via signature MD5 — Alusio otomatis menolak request palsu, jadi tidak ada yang perlu Anda lakukan di sisi keamanan webhook.