Troubleshooting: Ongkir Tidak Muncul di Checkout (IndoOngkir Suite)
Checklist mengatasi masalah ongkos kirim IndoOngkir yang tidak muncul di halaman checkout WooCommerce.
Masalah yang paling sering bikin pusing saat setup IndoOngkir adalah ongkir tidak muncul di Checkout padahal modul sudah diaktifkan. Biasanya penyebabnya “hal kecil” yang terlewat: lisensi belum valid, metode belum ditambahkan ke Shipping Zone, alamat belum lengkap, berat produk 0, cache masih menyimpan data lama, atau bentrok dengan plugin ongkir lain.
Tutorial ini berisi checklist yang rapi untuk mendiagnosis dan memperbaiki masalahnya. Ikuti urutannya dari atas ke bawah supaya tidak muter-muter.
Prasyarat
- Akses WordPress Admin dan bisa uji checkout sebagai pengunjung (incognito)
Cara membuka pengaturan terkait
| Area | Lokasi |
|---|---|
| Lisensi & modul | WooCommerce → Pengaturan → IndoOngkir → General |
| Modul IndoOngkir | WooCommerce → Pengaturan → IndoOngkir → IndoOngkir |
| Shipping Zones | WooCommerce → Pengaturan → Pengiriman |
Checklist diagnosis
Periksa hal berikut secara berurutan:
| # | Pemeriksaan | Yang benar |
|---|---|---|
| 1 | Lisensi valid | Tab General, status lisensi aktif |
| 2 | Status modul | Tab IndoOngkir, checkbox Aktifkan modul IndoOngkir dicentang |
| 3 | Shipping Origin Utama | Terisi, Requirements menampilkan centang hijau |
| 4 | Shipping Zone | Metode indo_ongkir_* ditambahkan ke zona yang mencakup lokasi pembeli |
| 5 | Method enabled | Instance ekspedisi di zona dalam keadaan aktif |
| 6 | Layanan enabled | Minimal satu layanan kurir aktif per metode |
| 7 | Alamat lengkap | Provinsi, kabupaten, kelurahan/kecamatan terisi (mode autocomplete atau berurutan) |
| 8 | Berat produk | Produk di keranjang berat > 0 |
| 9 | Cache | Hapus cache data ongkir lalu uji ulang |
| 10 | Konflik plugin | Nonaktifkan plugin ongkir lain (RajaOngkir, plugin kurir lain) untuk uji |
| 11 | Negara tujuan | Domestik pakai zona + metode domestik; internasional pakai zona + metode internasional |
Langkah-langkah perbaikan
1. Verifikasi Requirements di tab IndoOngkir
- Buka WooCommerce → Pengaturan → IndoOngkir → IndoOngkir.
- Lihat section Requirements:
- Shipping Origin: harus hijau
- Shipping Zones: “IndoOngkir sudah dipakai di WC Shipping Zones”
- Shipping Location(s): sesuai target penjualan toko
- Perbaiki item yang merah (klik Edit di Shipping Zones jika perlu).
2. Perbaiki Shipping Zone dan layanan
- Buka WooCommerce → Pengaturan → Pengiriman.
- Pastikan pembeli uji berada di wilayah zona yang benar.
- Buka konfigurasi metode IndoOngkir, aktifkan metode dan layanan.
Detail: Cara Menambahkan IndoOngkir ke WooCommerce Shipping Zones.
3. Uji checkout dengan data bersih
- Produk uji dengan berat mis. 0,5 kg.
- Alamat Indonesia lengkap (contoh: DKI Jakarta, Jakarta Selatan, kelurahan valid).
- Buka checkout incognito, isi alamat, tunggu kalkulasi ongkir.
4. Bedakan “tidak muncul” vs “pesan no shipping”
- Tidak ada baris ongkir sama sekali: biasanya karena zona tidak cocok, modul belum aktif, atau konflik plugin.
- Muncul pesan No Shipping Message: modul jalan tetapi rate kosong; cek alamat, layanan, atau rute tidak dilayani ekspedisi.
Sesuaikan No Shipping Message di Pengaturan Tampilan Cart dan Checkout.
5. Hapus cache dan debug (jika perlu)
- Tab IndoOngkir → section Advanced → Hapus Cache Data Ongkir.
- Hanya jika diminta support: aktifkan sementara JS Debug Mode dan lihat browser console.
Cara memastikan masalah selesai
- Checkout uji menampilkan minimal satu opsi ongkir untuk alamat dan produk valid
- Requirements semua hijau
- Perilaku konsisten di incognito setelah cache dibersihkan
Catatan
- Checkout Block bisa berperilaku berbeda dari Classic; uji di mode yang dipakai toko yang sudah online. Lihat Classic vs Block Cart/Checkout.
- Hosting dengan firewall ketat bisa memblokir request ke API WPBisnis; cek error log server atau log dari plugin keamanan.
- Data ongkir tidak dijamin 100% lengkap; jika alamat valid tetapi satu layanan kosong, coba ekspedisi lain atau laporkan ke support.
- JS Debug Mode: jangan aktifkan di production kecuali troubleshooting; fitur ini untuk log di console browser.