Error 403 Forbidden pada WooCommerce API terjadi ketika server menolak akses ke endpoint REST API karena masalah izin (permissions), konfigurasi file .htaccess, aturan keamanan firewall, atau konflik plugin pihak ketiga seperti n8n atau otomatisasi eksternal lainnya. Masalah ini memutus komunikasi antara aplikasi luar dan toko online WordPress Anda.
Untuk mengatasi kendala ini secara struktural, ikuti langkah-langkah teknis penanganan di bawah ini berdasarkan sumber-sumber otentik penanganan error web dan integrasi sistem otomatisasi.
Matriks Pemeriksaan & Penanganan WooCommerce API 403
| Penyebab Utama | Gejala / Indikasi | Langkah Perbaikan Utama |
|---|---|---|
| File .htaccess Korup | API mengembalikan status 403 pada semua endpoint | Generate ulang file .htaccess melalui Pengaturan Permalinks di Dashboard WordPress. |
| Blokir Keamanan / Firewall | Akses dari aplikasi eksternal (n8n, Postman) ditolak server | Periksa log Wordfence, iThemes Security, atau modul mod_security di cPanel hosting. |
| Izin Kunci API (Consumer Key/Secret) | Kesalahan otentikasi saat memanggil WooCommerce REST API | Buat ulang (regenerate) API Keys di WooCommerce > Pengaturan > Lanjutan > REST API dengan hak akses Read/Write. |
| Konfigurasi SSL / Permalinks | Permintaan HTTPS gagal atau rute URL API tidak terbaca | Pastikan URL situs menggunakan HTTPS yang valid dan ubah permalink ke opsi 'Post name'. |
Langkah Teknis Mengatasi Error 403
1. Periksa dan Perbarui File .htaccess
File .htaccess yang rusak sering kali memicu error 403 pada direktori wp-json. Masuk ke dashboard WordPress, navigasikan ke menu Pengaturan > Permalinks, lalu klik tombol Simpan Perubahan (tanpa mengubah apa pun) untuk memaksa WordPress menulis ulang aturan akses direktori.
2. Evaluasi Hak Akses Kunci API (REST API Keys)
Pastikan aplikasi pihak ketiga (seperti n8n atau aplikasi seluler) menggunakan kunci konsumen (Consumer Key) dan rahasia konsumen (Consumer Secret) yang benar dengan level izin Read/Write. Jika perlu, hapus kunci lama dan buat kredensial baru melalui panel WooCommerce.
3. Periksa Log Keamanan dan Firewall Hosting
Banyak layanan hosting menerapkan aturan mod_security yang keliru mendeteksi payload POST/PUT dari WooCommerce REST API sebagai aktivitas berbahaya. Periksa panel cPanel hosting Anda pada menu ModSecurity atau lihat log error server untuk menonaktifkan aturan yang salah memblokir (false positive).
4. Nonaktifkan Plugin Keamanan Sementara
Plugin firewall seperti Wordfence, Sucuri, atau BulletProof Security terkadang memblokir akses HTTP Basic Authentication yang digunakan oleh WooCommerce API. Nonaktifkan plugin keamanan tersebut sementara waktu untuk menguji apakah akses API kembali normal.