Payment gateway
Midtrans, Xendit, iPaymu, dan Duitku: kunci, mode uji, dan URL notifikasi.
Payment gateway membuat pembeli bisa membayar dengan QRIS, virtual account, e-wallet, atau kartu, dan pesanan berubah jadi lunas otomatis.
Midtrans, Xendit, iPaymu, dan Duitku sudah tersambung. Setiap gateway muncul sebagai pilihan bayar setelah diaktifkan dan kuncinya diisi. Kalau lebih dari satu aktif, pembeli bisa memilih.
Langkah umum#
- Daftar di penyedia gateway dan ajukan akun bisnis.
- Di Dicommerce › Setelan › Pembayaran › Payment gateway, centang Aktifkan pada gateway itu.
- Pilih Lingkungan: Sandbox (uji coba) dan isi kunci sandbox.
- Salin URL notifikasi dengan tombol Salin, lalu tempel di dashboard penyedia.
- Simpan, lalu buat pesanan percobaan.
- Setelah akun disetujui, ganti ke Production (asli) dan isi kunci production.
Kunci Sandbox hanya bekerja di mode Sandbox, kunci Production hanya di mode Production. Kunci yang tertukar adalah penyebab paling umum pembayaran gagal.
Midtrans#
| Isian | Ambil dari |
|---|---|
| Client key, Server key | Dashboard Midtrans › Settings › Access Keys |
| URL notifikasi | Tempel di Settings › Payment › Notification URL |
Pembeli memilih metode bayar di jendela Midtrans yang terbuka di atas halaman checkout.
Xendit#
| Isian | Ambil dari |
|---|---|
| Secret API key | Dashboard Xendit › Settings › API Keys |
| Callback verification token | Settings › Webhooks. Token yang sama ditempel di Dicommerce. |
| URL notifikasi | Tempel di Settings › Webhooks › Invoices paid |
Mode uji atau asli di Xendit mengikuti jenis secret key: xnd_development_… untuk uji, xnd_production_… untuk asli.
iPaymu#
| Isian | Ambil dari |
|---|---|
| Virtual Account (VA), API key | Dashboard iPaymu |
| URL notifikasi | Tidak perlu ditempel. Dikirim otomatis di setiap transaksi. |
Duitku#
| Isian | Ambil dari |
|---|---|
| Merchant code, API key (merchant key) | Dashboard Duitku, di project Anda |
| URL notifikasi | Tempel di Project › Callback URL |
Untuk Xendit, iPaymu, dan Duitku, pembeli diarahkan ke halaman pembayaran penyedia, lalu kembali ke halaman pesanan. Halaman pesanan memperbarui dirinya sendiri setelah pembayaran masuk.
Keamanan kunci#
Kunci rahasia disimpan aman dan tidak ditampilkan lagi; isiannya hanya menunjukkan 4 karakter terakhir. Biarkan kosong untuk tetap memakai kunci tersimpan, atau centang Hapus untuk menghapusnya.
Pesanan tidak berubah jadi lunas#
- Cek URL notifikasi sudah ditempel di dashboard penyedia, dan sama persis.
- Cek lingkungan dan kuncinya cocok (Sandbox dengan Sandbox).
- Cek peringatan "Notifikasi pembayaran diblokir" di admin. Kalau ada, izinkan
/wp-json/dicom/v1/di plugin keamanan. - Sambil menunggu, pesanan bisa ditandai lunas manual setelah dicek di dashboard penyedia.