Woongkir Tidak Muncul di Checkout WooCommerce? Ini Cara Mengatasinya
WooCommerce merupakan salah satu platform yang banyak digunakan untuk membangun toko online berbasis WordPress. Untuk mempermudah proses pengiriman, pemilik toko dapat menggunakan plugin ongkos kirim seperti Wooongkir atau Woongkir, yang membantu menampilkan pilihan kurir dan biaya pengiriman berdasarkan alamat tujuan serta berat produk.
Namun, terkadang ongkos kirim tidak muncul ketika pelanggan membuka halaman checkout. Kondisi ini dapat membuat pelanggan kesulitan menyelesaikan transaksi karena tidak dapat mengetahui biaya pengiriman atau memilih layanan kurir yang tersedia.
Masalah Woongkir tidak muncul di checkout WooCommerce dapat disebabkan oleh berbagai hal, mulai dari pengaturan zona pengiriman yang belum tepat, alamat pelanggan yang tidak lengkap, berat produk yang belum diisi, hingga masalah koneksi API dan konflik plugin.
Untuk mengatasinya, pemilik toko perlu memeriksa konfigurasi WooCommerce dan plugin pengiriman secara bertahap. Artikel ini membahas penyebab umum serta langkah-langkah praktis untuk mengatasi Woongkir yang tidak menampilkan ongkos kirim agar proses checkout dapat berjalan dengan baik.
Apa Itu Woongkir di WooCommerce?
Woongkir merupakan plugin atau integrasi ongkos kirim yang digunakan pada toko online berbasis WooCommerce untuk membantu menghitung biaya pengiriman berdasarkan informasi pesanan dan tujuan pengiriman. Implementasi serta fitur yang tersedia bergantung pada versi plugin dan layanan yang digunakan.
Secara umum, integrasi ongkos kirim dapat membantu toko online menampilkan pilihan ekspedisi, jenis layanan pengiriman, dan tarif yang sesuai dengan alamat tujuan pelanggan.
Sebagai contoh, ketika pelanggan membeli produk dari toko online di Yogyakarta dan memasukkan alamat pengiriman di Jakarta, sistem akan menggunakan informasi pengiriman yang tersedia untuk menghitung tarif berdasarkan kurir dan layanan yang didukung.
Agar perhitungan berjalan dengan benar, beberapa informasi harus dikonfigurasi dengan tepat, seperti:
- Alamat asal pengiriman toko.
- Alamat tujuan pelanggan.
- Berat dan, jika diperlukan, dimensi produk.
- Kurir serta layanan pengiriman yang diaktifkan.
- Zona pengiriman WooCommerce.
- Pengaturan API atau koneksi layanan tarif, jika digunakan oleh plugin.
Jika salah satu komponen tersebut bermasalah, ongkos kirim mungkin tidak muncul atau gagal dihitung ketika pelanggan melakukan checkout.
Penyebab Woongkir Tidak Muncul di Checkout WooCommerce
Sebelum memperbaiki masalah, penting untuk mengetahui penyebab Woongkir tidak menampilkan ongkos kirim di halaman checkout WooCommerce. Berikut beberapa penyebab yang paling umum terjadi.
- Zona Pengiriman Tidak Sesuai
Alamat pelanggan tidak termasuk dalam zona pengiriman yang telah diatur di WooCommerce sehingga pilihan ongkos kirim tidak muncul.
- Alamat Pelanggan Belum Lengkap
Informasi alamat, seperti provinsi, kota, atau kecamatan, belum diisi atau dipilih dengan benar sehingga tarif pengiriman tidak dapat dihitung.
- Berat Produk Belum Diatur
Berat produk belum diisi atau tidak sesuai dengan ketentuan plugin sehingga proses perhitungan ongkos kirim dapat mengalami kendala.
- Kurir Belum Diaktifkan
Pilihan kurir atau layanan pengiriman belum diaktifkan atau dikonfigurasi dengan benar di pengaturan Woongkir.
- API Bermasalah
Koneksi API terganggu, kredensial tidak valid, atau layanan API sedang mengalami gangguan sehingga tarif pengiriman gagal ditampilkan.
- Konflik Plugin atau Tema
Plugin lain atau tema WordPress mengganggu proses perhitungan ongkos kirim atau tampilan halaman checkout.
- Cache Belum Diperbarui
Cache yang masih menyimpan data lama dapat membuat perubahan pengaturan pengiriman belum terlihat di halaman checkout.
- Masalah JavaScript atau AJAX
Terjadi kesalahan saat halaman checkout memperbarui informasi pengiriman sehingga tarif ongkos kirim tidak muncul secara otomatis.
- Pengaturan Lokasi Toko Keliru
Alamat asal pengiriman atau pengaturan lokasi toko tidak sesuai sehingga perhitungan tarif pengiriman mengalami kendala.
- Versi Plugin Tidak Kompatibel
Versi Woongkir tidak cocok dengan WooCommerce, WordPress, PHP, atau plugin lain yang digunakan sehingga fitur pengiriman tidak berjalan dengan baik.
Perlu diingat bahwa penyebabnya dapat berbeda tergantung versi Woongkir yang digunakan. Sebaiknya, periksa pengaturan WooCommerce dan Woongkir terlebih dahulu sebelum melanjutkan ke pemeriksaan API, cache, atau konflik plugin.
Cara Mengatasi Woongkir Tidak Muncul di Checkout WooCommerce
Berikut langkah-langkah yang dapat dilakukan untuk menemukan penyebab dan memperbaiki masalah ongkos kirim yang tidak muncul di halaman checkout.
1. Periksa Pengaturan Plugin Woongkir
Langkah pertama adalah memastikan plugin Woongkir telah aktif dan pengaturannya sudah benar. Plugin yang belum dikonfigurasi dengan lengkap mungkin tidak dapat menampilkan tarif pengiriman.
Lakukan pemeriksaan berikut:
- Masuk ke dashboard WordPress.
- Buka menu Plugins → Installed Plugins.
- Pastikan plugin Woongkir dalam kondisi aktif.
- Buka menu pengaturan Woongkir yang tersedia di dashboard.
- Periksa apakah layanan pengiriman yang dibutuhkan sudah diaktifkan.
- Pastikan lokasi asal pengiriman toko telah diisi dengan benar.
- Simpan perubahan jika ada pengaturan yang diperbaiki.
Jika plugin menyediakan pengaturan API, lisensi, atau koneksi ke layanan tarif, periksa juga statusnya. Nama menu dan langkah konfigurasi dapat berbeda menurut versi plugin yang digunakan.
Catatan: Jangan langsung menghapus dan memasang ulang plugin sebelum memeriksa konfigurasi. Tindakan tersebut berpotensi menghilangkan pengaturan yang sudah dibuat.
2. Periksa Zona Pengiriman WooCommerce
Zona pengiriman (shipping zone) menentukan wilayah tujuan yang dilayani oleh suatu metode pengiriman. Jika alamat pelanggan tidak cocok dengan zona yang tersedia, metode pengiriman bisa tidak muncul.
Untuk memeriksanya, ikuti langkah berikut:
- Buka dashboard WordPress.
- Pilih WooCommerce → Settings → Shipping → Shipping zones.
- Periksa zona pengiriman yang sudah dibuat.
- Pastikan wilayah pelanggan termasuk dalam zona yang sesuai.
- Buka zona tersebut dan periksa apakah metode pengiriman yang dibutuhkan sudah ditambahkan serta aktif.
- Simpan perubahan, kemudian uji kembali halaman checkout.
Misalnya, toko online melayani pengiriman ke seluruh Indonesia, tetapi zona pengiriman hanya mencakup wilayah tertentu. Pelanggan dari luar wilayah tersebut mungkin tidak mendapatkan pilihan pengiriman.
Perhatikan juga urutan zona. WooCommerce mencocokkan alamat pelanggan dengan zona yang sesuai berdasarkan urutan konfigurasi. Zona yang lebih spesifik sebaiknya ditempatkan sebelum zona yang lebih luas jika keduanya berpotensi tumpang tindih.
3. Pastikan Alamat Pelanggan Sudah Lengkap
Plugin ongkos kirim umumnya memerlukan informasi tujuan untuk menentukan tarif pengiriman. Jika alamat pelanggan belum lengkap, sistem mungkin belum dapat menghitung biaya pengiriman.
Periksa apakah informasi berikut sudah diisi dengan benar:
- Negara dan provinsi.
- Kota atau kabupaten.
- Kecamatan atau wilayah tujuan, jika diperlukan oleh plugin.
- Kode pos, jika diwajibkan.
- Alamat pengiriman yang sesuai.
Pada toko online di Indonesia, pemilihan wilayah tujuan terkadang menggunakan daftar bertingkat, mulai dari provinsi hingga kecamatan. Jika pelanggan hanya mengisi nama kota melalui kolom teks biasa, plugin mungkin tidak mendapatkan kode wilayah yang dibutuhkan.
Untuk menguji masalah ini, masukkan alamat lengkap melalui halaman checkout, lalu tunggu hingga proses pembaruan tarif selesai. Jika tersedia pilihan wilayah berbentuk dropdown, gunakan pilihan yang disediakan sistem, bukan sekadar mengetik nama wilayah secara manual.
Jika ongkos kirim muncul setelah alamat dilengkapi, kemungkinan masalahnya berasal dari informasi tujuan yang belum memenuhi kebutuhan perhitungan tarif.
4. Periksa Berat dan Dimensi Produk
Informasi produk juga dapat memengaruhi perhitungan ongkos kirim. Beberapa layanan pengiriman atau konfigurasi plugin memerlukan berat produk, sedangkan layanan tertentu juga membutuhkan dimensi paket.
Untuk memeriksanya:
- Buka Products → All Products.
- Pilih produk yang bermasalah.
- Masuk ke bagian Product data → Shipping.
- Periksa kolom berat dan dimensi.
- Isi informasi sesuai kondisi produk yang sebenarnya.
- Simpan perubahan dan lakukan pengujian checkout kembali.
Jika menggunakan produk variabel, periksa juga pengaturan pengiriman pada setiap variasi apabila plugin mengandalkan data tersebut.
Sebagai contoh, pelanggan membeli dua produk dengan berat masing-masing 500 gram. Sistem perlu memperoleh informasi berat yang sesuai untuk menghitung pengiriman berdasarkan aturan layanan yang digunakan.
Namun, berat kosong tidak selalu menjadi penyebab utama. Kebutuhan data berat dan dimensi bergantung pada plugin, kurir, serta metode perhitungan tarif. WooCommerce sendiri tidak menghitung tarif real-time berdasarkan berat hanya dengan fitur pengiriman bawaan; perhitungan tersebut memerlukan konfigurasi metode atau ekstensi yang mendukungnya.
5. Pastikan Kurir dan Layanan Pengiriman Sudah Diaktifkan
Ongkos kirim bisa tidak muncul jika ekspedisi atau layanan pengiriman belum diaktifkan pada konfigurasi plugin.
Periksa pengaturan kurir pada Woongkir, kemudian pastikan layanan yang ingin digunakan tersedia dan telah dipilih. Jika plugin menyediakan beberapa jenis layanan, pastikan tidak ada aturan yang secara tidak sengaja menonaktifkan seluruh pilihan.
Misalnya, toko ingin menawarkan layanan reguler dan ekspres, tetapi hanya mengaktifkan kurir tanpa memilih layanan yang didukung. Akibatnya, tarif yang diharapkan mungkin tidak tampil.
Jika tersedia, lakukan pengujian dengan satu kurir dan satu alamat tujuan terlebih dahulu. Setelah tarif berhasil muncul, aktifkan layanan lain secara bertahap. Cara ini membantu mengetahui apakah masalah berasal dari konfigurasi kurir tertentu atau dari sistem pengiriman secara keseluruhan.
6. Periksa Koneksi API dan Layanan Tarif
Sebagian plugin ongkos kirim menggunakan API untuk memperoleh data tarif dari penyedia layanan. Jika koneksi tersebut gagal, pilihan kurir atau tarif dapat tidak muncul di checkout.
Beberapa hal yang perlu diperiksa meliputi:
- API key atau kredensial masih valid.
- Lisensi plugin masih aktif apabila diwajibkan.
- Layanan API dapat diakses oleh server website.
- Kuota atau batas permintaan API belum terlampaui.
- Tidak ada kesalahan autentikasi atau konfigurasi endpoint.
- Layanan penyedia tarif tidak sedang mengalami gangguan.
Jika plugin menyediakan log atau fitur pengujian koneksi, gunakan fitur tersebut untuk melihat pesan kesalahan. Jika muncul kode atau pesan error, catat informasinya sebelum mengubah konfigurasi.
Jangan membagikan API key, kata sandi, atau kredensial sensitif ketika meminta bantuan teknis. Jika masalah berasal dari layanan eksternal, hubungi pengembang plugin atau penyedia API dengan menyertakan pesan error yang relevan.
7. Bersihkan Cache Website dan Browser
Cache membantu mempercepat website, tetapi terkadang dapat menghambat pembaruan informasi dinamis jika halaman checkout atau keranjang ikut di-cache secara tidak tepat.
Untuk mengatasinya, lakukan langkah berikut:
- Bersihkan cache dari plugin optimasi atau caching yang digunakan.
- Bersihkan cache browser, atau coba buka website melalui jendela privat.
- Jika menggunakan CDN atau cache dari penyedia hosting, periksa pengaturannya.
- Pastikan halaman Cart, Checkout, dan My Account tidak menggunakan cache halaman penuh yang mengganggu sesi pengguna.
- Uji kembali proses checkout dengan produk dan alamat tujuan yang sama.
Jika menggunakan WP Rocket atau plugin optimasi lainnya, periksa aturan pengecualian cache untuk halaman yang memerlukan pembaruan berdasarkan sesi pelanggan.
WooCommerce secara khusus merekomendasikan pemeriksaan cache ketika tarif pengiriman tidak diperbarui sesuai perubahan alamat atau isi keranjang.
8. Periksa Konflik dengan Plugin Lain
Konflik plugin dapat menyebabkan tarif pengiriman tidak tampil, terutama jika toko menggunakan beberapa plugin yang mengubah proses checkout, pengiriman, atau kalkulasi pesanan.
Contohnya adalah plugin checkout kustom, plugin pengiriman lain, plugin diskon bersyarat, atau plugin optimasi JavaScript.
Untuk mengidentifikasi konflik, lakukan pengujian secara hati-hati:
- Buat cadangan website terlebih dahulu.
- Jika memungkinkan, gunakan website staging untuk pengujian.
- Nonaktifkan sementara plugin yang berkaitan dengan checkout, pengiriman, atau optimasi.
- Uji kembali apakah tarif Woongkir muncul.
- Aktifkan plugin satu per satu sambil menguji kembali checkout.
- Jika masalah muncul setelah plugin tertentu diaktifkan, periksa kompatibilitas dan pengaturannya.
Hindari menonaktifkan plugin keamanan atau komponen penting pada website produksi tanpa pertimbangan. Jika tidak memiliki staging, lakukan pengujian pada waktu yang minim transaksi atau minta bantuan pengembang.
9. Periksa Tema dan Halaman Checkout
Tema atau pembuat halaman checkout pihak ketiga dapat memengaruhi cara informasi pengiriman ditampilkan. Masalah ini dapat terjadi ketika tema atau plugin checkout tidak kompatibel dengan mekanisme pembaruan tarif yang digunakan plugin ongkos kirim.
Untuk menguji kemungkinan tersebut:
- Periksa apakah halaman checkout menggunakan fitur bawaan WooCommerce atau checkout kustom.
- Pastikan semua kolom alamat pengiriman yang diperlukan masih tersedia.
- Periksa apakah metode pengiriman disembunyikan oleh pengaturan tema atau plugin.
- Uji halaman checkout standar WooCommerce pada lingkungan staging.
- Periksa kompatibilitas tema dan plugin checkout dengan versi WooCommerce serta Woongkir yang digunakan.
Jika tarif muncul pada checkout standar tetapi tidak pada halaman checkout kustom, kemungkinan masalah berkaitan dengan implementasi checkout atau kompatibilitas plugin.
Jangan langsung mengganti tema pada website aktif. Lakukan pengujian di staging agar tampilan dan proses transaksi pelanggan tidak terganggu.
10. Periksa Error JavaScript dan AJAX
WooCommerce memperbarui beberapa informasi checkout secara dinamis ketika pelanggan mengganti alamat, jumlah produk, atau pilihan pengiriman. Jika JavaScript atau permintaan AJAX mengalami kegagalan, tarif mungkin tidak diperbarui meskipun konfigurasi pengiriman sudah benar.
Gejala yang dapat terlihat antara lain:
- Pilihan ongkos kirim terus memuat tanpa hasil.
- Tarif tidak berubah ketika alamat tujuan diganti.
- Kolom pengiriman tidak merespons.
- Checkout menampilkan pesan error setelah pelanggan mengisi alamat.
Untuk pemeriksaan awal:
- Buka halaman checkout menggunakan browser desktop.
- Klik kanan halaman, lalu pilih Inspect atau Periksa.
- Buka tab Console.
- Ulangi proses pengisian alamat dan perhatikan apakah muncul pesan error.
- Jika memahami penggunaan developer tools, periksa tab Network untuk melihat permintaan yang gagal.
Catat pesan kesalahan yang muncul beserta langkah yang menyebabkan masalah. Informasi tersebut dapat membantu pengembang menentukan apakah gangguan berasal dari JavaScript, permintaan server, atau integrasi pengiriman.
Jangan mengedit kode JavaScript secara langsung tanpa memahami penyebabnya. Memperbaiki gejala tanpa mengetahui sumber masalah justru dapat mengganggu proses checkout lainnya.
11. Periksa Log Kesalahan WooCommerce
Jika langkah sebelumnya belum berhasil, periksa log kesalahan untuk mengetahui apakah terdapat masalah pada plugin, server, atau proses penghitungan ongkos kirim.
WooCommerce menyediakan sistem pencatatan log yang dapat membantu menemukan kesalahan PHP dan masalah teknis lainnya.
Cara memeriksanya:
- Buka dashboard WordPress.
- Masuk ke WooCommerce → Status → Logs.
- Periksa daftar log yang tersedia.
- Cari log yang berkaitan dengan waktu terjadinya masalah.
- Perhatikan pesan error yang menyebut plugin pengiriman, API, koneksi server, atau proses checkout.
Nama file log bergantung pada komponen yang mencatat kesalahan. Jika Woongkir menyediakan log tersendiri, periksa juga dokumentasi atau menu pengaturan plugin tersebut.
Apabila ditemukan pesan seperti timeout, unauthorized, atau fatal error, tindak lanjuti sesuai penyebabnya. Kesalahan timeout dapat menunjukkan bahwa permintaan tidak memperoleh respons tepat waktu, sedangkan unauthorized biasanya berkaitan dengan autentikasi atau hak akses.
Jangan mengubah konfigurasi server hanya berdasarkan dugaan. Jika pesan error tidak dapat dipahami, simpan informasi yang relevan dan konsultasikan kepada pengembang plugin atau penyedia hosting.
12. Perbarui WooCommerce, WordPress, dan Plugin Woongkir
Versi perangkat lunak yang tidak kompatibel dapat menyebabkan gangguan pada fungsi pengiriman maupun halaman checkout. Karena itu, pastikan komponen toko online menggunakan versi yang kompatibel satu sama lain.
Lakukan pemeriksaan berikut:
- Periksa pembaruan WordPress dan WooCommerce.
- Periksa apakah tersedia pembaruan Woongkir.
- Baca catatan rilis untuk mengetahui perbaikan bug atau perubahan kompatibilitas.
- Pastikan versi PHP sesuai dengan persyaratan komponen yang digunakan.
- Uji pembaruan pada staging sebelum diterapkan ke website produksi.
Jangan langsung memperbarui seluruh komponen sekaligus ketika toko sedang mengalami masalah. Jika gangguan baru muncul setelah pembaruan tertentu, identifikasi perubahan tersebut terlebih dahulu agar penyebabnya lebih mudah ditemukan.
Setelah pembaruan, lakukan pengujian checkout untuk memastikan tarif pengiriman kembali muncul dan proses transaksi tetap berjalan dengan baik.
Ringkasan Cara Mengatasi Woongkir Tidak Muncul
Agar lebih mudah menentukan langkah perbaikan, berikut ringkasan masalah dan solusi yang dapat dilakukan.
| Masalah | Solusi yang disarankan |
|---|---|
| Plugin Woongkir tidak aktif | Aktifkan plugin dan periksa konfigurasinya. |
| Tarif tidak muncul untuk wilayah tertentu | Periksa zona pengiriman dan alamat tujuan. |
| Ongkir gagal dihitung | Periksa berat produk serta data pengiriman yang diperlukan. |
| Pilihan kurir tidak tersedia | Aktifkan kurir dan layanan yang didukung. |
| Tarif gagal dimuat | Periksa API, lisensi, dan koneksi layanan tarif. |
| Tarif tidak diperbarui | Bersihkan cache dan periksa pengecualian halaman checkout. |
| Checkout tidak merespons | Periksa konflik plugin, tema, JavaScript, dan AJAX. |
| Masalah tetap terjadi | Periksa log WooCommerce dan kompatibilitas versi. |
Tips agar Masalah Ongkir Tidak Terulang
Setelah masalah berhasil diperbaiki, lakukan pemeliharaan rutin untuk mengurangi kemungkinan gangguan serupa terjadi kembali.
-
Uji checkout secara berkala
Lakukan simulasi pembelian menggunakan beberapa alamat tujuan untuk memastikan tarif tampil dengan benar.
-
Periksa konfigurasi pengiriman
Pastikan zona, kurir, lokasi asal, dan layanan pengiriman tetap sesuai.
-
Perbarui sistem secara terencana
Periksa kompatibilitas plugin sebelum memperbarui WordPress atau WooCommerce.
-
Pantau log kesalahan
Periksa pesan error jika pelanggan melaporkan ongkos kirim tidak muncul.
-
Kelola cache dengan benar
Hindari menyimpan halaman checkout dalam cache yang mengganggu pembaruan tarif.
-
Simpan backup website
Cadangan membantu pemulihan apabila perubahan konfigurasi atau pembaruan menyebabkan masalah.
-
Gunakan lingkungan staging
Uji perubahan plugin, tema, dan pengaturan checkout sebelum menerapkannya ke website utama.
Kebiasaan tersebut membantu menjaga proses checkout tetap stabil sekaligus mengurangi risiko pelanggan gagal menyelesaikan transaksi.
Kesimpulan
Woongkir tidak muncul di checkout WooCommerce dapat disebabkan oleh pengaturan pengiriman yang keliru, alamat pelanggan yang belum lengkap, masalah API, cache, atau konflik plugin dan tema. Untuk mengatasinya, periksa konfigurasi plugin, zona pengiriman, data produk, serta log kesalahan secara bertahap.
Lakukan pengujian kembali setelah setiap perbaikan agar penyebab masalah dapat diketahui dengan lebih mudah. Dengan konfigurasi yang tepat dan pemeliharaan rutin, toko online dapat menampilkan ongkos kirim secara lebih konsisten dan memberikan pengalaman checkout yang lebih baik kepada pelanggan.
Untuk mempelajari lebih banyak tentang WordPress, WooCommerce, website, hosting, dan teknologi digital, kunjungi Blog Hosteko untuk menemukan berbagai artikel tutorial dan panduan informatif lainnya.
