Ada dua jalur utama memasang cek ongkir otomatis di toko online, yaitu pakai plugin ongkir siap pakai, atau bangun sendiri lewat custom API. Jawaban mana yang lebih tepat tergantung platform toko kamu dan seberapa besar kontrol yang kamu butuhkan atas hasil hitungan ongkirnya.
Plugin Ongkir vs Custom API, Apa Bedanya?
Plugin ongkir, kadang disebut juga cek ongkir plugin adalah ekstensi siap pakai yang tinggal diinstal di platform toko. Biasanya plugin ini sudah membungkus koneksi ke satu atau beberapa penyedia data ongkir, jadi kamu tidak perlu menulis kode sama sekali. Custom API kebalikannya, yaitu kamu memanggil endpoint cek ongkir langsung dari sistem tokomu, lalu menampilkan hasilnya sesuai desain dan logika bisnis yang kamu tentukan sendiri.
Bedanya bukan soal mana yang lebih canggih, tapi soal siapa yang mengontrol logika dan siapa yang menanggung maintenance. Plugin cocok kalau kamu ingin cepat jalan tanpa tim developer. Custom API cocok kalau kamu butuh kontrol lebih jauh, misalnya menambah markup, memilih kurir tertentu, atau memasang di platform yang ekosistem pluginnya belum sesubur WooCommerce.
Plugin Ongkir untuk WooCommerce
WooCommerce punya ekosistem plugin ongkir paling ramai dibanding platform e-commerce lain yang populer di Indonesia. Sebagian plugin dibangun di atas layanan pihak ketiga seperti plugin rajaongkir woocommerce yang sudah dikenal luas pemilik toko, sebagian lain menyediakan koneksi ke beberapa penyedia sekaligus. Cara pasangnya umumnya sama, hanya perlu instal plugin dari direktori WordPress atau beli versi berbayarnya, masukkan API key dari penyedia data ongkir, lalu atur kurir mana saja yang ditampilkan di halaman checkout.
Yang perlu kamu cek sebelum memilih plugin cek ongkir adalah apakah kuota dan batas request penyedia data di baliknya sesuai volume transaksi tokomu, apakah kurir yang kamu butuhkan tersedia, dan apakah plugin itu masih dirawat aktif oleh developernya, karena plugin WordPress yang mangkrak jadi risiko keamanan tersendiri. Untuk toko baru dengan volume kecil, plugin ongkir gratis biasanya cukup. Begitu volume naik, batas kuota gratis itu yang paling sering jadi alasan pindah ke paket berbayar atau ke custom API.
Bagaimana dengan Shopify?
Ekosistem plugin ongkir sesubur WooCommerce ini tidak otomatis tersedia di Shopify. Shopify punya App Store sendiri, tapi jumlah app cek ongkir lokal Indonesia di sana jauh lebih sedikit dibanding plugin WooCommerce, dan sebagian besar app shipping di App Store Shopify dibangun untuk kurir internasional, bukan kurir domestik Indonesia.
Karena itu custom API jadi opsi yang lebih relevan buat merchant Shopify yang butuh ongkir kurir lokal. Secara resmi, dokumentasi Carrier Service API dari Shopify menjelaskan bahwa toko bisa menghubungkan layanan penghitung ongkir eksternal ke halaman checkout lewat app dan callback URL. Jalur ini yang dipakai kalau kamu ingin menampilkan hasil hitungan dari API ongkir custom di checkout Shopify, bukan lewat plugin siap pakai seperti di WooCommerce.
Custom API Cek Ongkir, Kapan Ini Opsi yang Lebih Tepat?
Custom API cek ongkir paling masuk akal ketika kamu sudah punya, atau bisa menyewa, tim developer, dan butuh kontrol yang tidak disediakan plugin siap pakai. Sebagai gambaran, endpoint GET /expedition/shipping-cost dari api.co.id menghitung ongkir dari kode desa asal ke kode desa tujuan berdasarkan berat paket, dipanggil dengan header x-api-co-id berisi API key kamu. Endpoint ini yang jadi inti dari layanan api ongkir custom yang bisa kamu bangun sendiri di atas sistem toko.
Satu hal yang sering luput, endpoint ini menerima kode desa 10 digit, bukan alamat bebas teks. Artinya sebelum memanggil endpoint cek ongkir, sistem tokomu perlu mengubah alamat pembeli jadi kode desa itu dulu, biasanya lewat API wilayah Indonesia terpisah. Ini langkah tambahan yang tidak perlu kamu pikirkan kalau pakai plugin siap pakai, karena plugin biasanya sudah membungkus proses itu di baliknya.
Lihat detail lengkap cara memanggil endpoint ini, termasuk parameter dan alur requestnya, di panduan integrasi API cek ongkir ke website. Halaman produk API Cek Ongkos Kirim api.co.id jadi contoh implementasi resmi kalau kamu sudah memutuskan jalur custom API.
Plugin vs Custom API di 4 Sumbu yang Jarang Dibahas
Empat sumbu ini yang paling menentukan keputusan, tapi jarang dibahas tuntas di artikel pembanding plugin ongkir kebanyakan.
Rate Limit dan Kuota
Plugin cek ongkir mewarisi batas kuota dari penyedia data di baliknya, jadi batasnya tergantung paket yang kamu pilih di penyedia tersebut. Untuk custom API api.co.id sendiri, tier gratisnya dibatasi 50 request per bulan, dan endpoint akan menolak request dengan error 429 kalau batas rate limit terlampaui. Dev docs resmi tidak mencantumkan angka rate limit per menit atau per detik untuk endpoint ini, jadi kalau kamu butuh angka pastinya untuk estimasi kapasitas produksi, cek langsung ke dashboard akun kamu atau tanyakan ke tim api.co.id melalui tombol WhatsApp yang ada di website.
Cakupan Kurir
Cakupan kurir plugin tergantung penyedia data di baliknya, jadi bisa berbeda-beda antar plugin. Sebagai pembanding, API Cek Ongkos Kirim api.co.id mendukung 14 layanan pengiriman dari 8 brand kurir berbeda, mulai dari layanan reguler JNE dan SiCepat sampai layanan kargo dari kurir terkait. Untuk daftar lengkap kurir yang didukung, baca cara cek ongkir semua ekspedisi dalam satu API.
Kontrol Markup Ongkir
Ini sumbu yang paling sering diabaikan padahal dampaknya langsung ke margin. Custom API memberi kamu kontrol penuh menentukan markup ongkir di sisi sistemmu sebelum angka itu ditampilkan ke pembeli, karena kamu yang mengolah hasil API sebelum dirender di halaman toko. Plugin siap pakai umumnya lebih terbatas: markup diatur lewat setting bawaan plugin, dan seberapa fleksibel setting itu tergantung plugin masing-masing, bukan sesuatu yang bisa digeneralisasi untuk semua plugin.
Maintenance Jangka Panjang
Plugin siap pakai maintenance-nya ada di tangan vendor plugin. Kamu tinggal update versi plugin kalau ada rilis baru, dan risikonya adalah plugin ditinggalkan developernya atau tidak kompatibel lagi dengan versi WordPress atau WooCommerce terbaru. Custom API sebaliknya: kamu, atau tim developer kamu, yang bertanggung jawab menjaga integrasi tetap jalan, termasuk memantau perubahan versi API dan menangani error handling sendiri. Ini bukan soal mana yang lebih ringan, tapi soal di mana kamu mau menaruh beban itu: di vendor plugin, atau di tim internal.
| Sumbu | Plugin Siap Pakai | Custom API |
|---|---|---|
| Rate limit / kuota | Ikut paket penyedia data di balik plugin | Kamu pilih tier sendiri, tier gratis api.co.id 50 request/bulan |
| Cakupan kurir | Tergantung penyedia data plugin | Bisa kamu sesuaikan lewat parameter request |
| Kontrol markup | Terbatas pada setting bawaan plugin | Penuh, diatur di sisi sistem sebelum ditampilkan |
| Maintenance | Tanggung jawab vendor plugin | Tanggung jawab tim developer kamu |
Penempatan Widget Cek Ongkir, di Halaman Produk atau di Checkout?
Pertanyaan ini nyaris tidak dibahas di artikel plugin ongkir kebanyakan, padahal penempatannya memengaruhi pengalaman belanja secara langsung.
Menampilkan estimasi ongkir di halaman produk membantu calon pembeli mengambil keputusan beli lebih awal, sebelum masuk ke checkout. Cocok untuk toko dengan produk berat atau besar, di mana ongkir bisa jadi faktor penentu jadi tidaknya transaksi. Konsekuensinya, angka yang tampil di halaman produk biasanya masih estimasi karena alamat lengkap pembeli belum diketahui.
Menampilkan ongkir di checkout memberi angka yang lebih final, karena alamat pembeli sudah lengkap terisi di titik itu. Trade off-nya, pembeli baru tahu ongkir persis di langkah terakhir, yang buat sebagian toko jadi salah satu penyebab keranjang ditinggalkan. Karena alasan ini, sebagian toko memasang keduanya: estimasi kasar di halaman produk untuk membantu keputusan awal, dan angka final di checkout sebelum pembayaran.
Keputusan plugin atau custom API akhirnya kembali ke tiga hal: platform toko kamu (WooCommerce yang ekosistem pluginnya subur, atau Shopify yang lebih terbatas), seberapa besar kontrol yang kamu butuhkan atas markup dan cakupan kurir, dan kapasitas tim developer yang kamu punya untuk menanggung maintenance jangka panjang. Kalau kamu sudah menentukan custom API sebagai jalur yang lebih cocok, terutama karena butuh kontrol markup, cakupan multi kurir, atau integrasi di luar WooCommerce seperti Shopify, lihat cara kerja API Cek Ongkos Kirim api.co.id dan bandingkan opsi penyedia lain di alternatif RajaOngkir untuk toko online.
