Cara Menyelesaikan Ralat 'Signature Mismatch' URL Callback Billplz di WooCommerce

Memahami Isu: Cara Menyelesaikan Ralat Signature Mismatch URL Callback Billplz di WooCommerce

Ralat Billplz X-Signature Mismatch atau situasi di mana pelanggan telah ditolak wang akaun bank FPX tetapi status pesanan dalam WooCommerce kekal sebagai Pending Payment berlaku apabila tandatangan keselamatan (cryptographic hash signature) yang dihantar oleh webhook Billplz tidak sepadan dengan kunci rahsia yang disimpan dalam pemalam WooCommerce.

Langkah 1: Diagnosis Ralat melalui cPanel & Terminal

Semak log ralat gerbang pembayaran WooCommerce di wp-admin -> WooCommerce -> Status -> Log:

• Cari fail log terkini billplz-....
• Periksa entri ralat: Callback signature mismatch atau Invalid X-Signature.

Langkah 2: Laksanakan Pembetulan yang Tepat

1. Selaraskan Kunci X-Signature:

1. Log masuk ke papan pemuka rasmi Billplz Dashboard (Production / Sandbox).
2. Pergi ke Settings -> Keys & Integration.
3. Salin X Signature Key yang tepat.
4. Buka wp-admin -> WooCommerce -> Tetapan -> Pembayaran (Payments) -> Billplz.
5. Tampalkan kunci tersebut ke dalam medan X Signature Key dan simpan.

2. Pastikan Caching Dikecualikan untuk URL Callback: Pastikan perkhidmatan caching pelayan (LiteSpeed Cache / Cloudflare Page Rules) tidak menyimpan cache bagi URL callback webhook:

# Kecualikan URL webhook Billplz daripada caching
<IfModule mod_rewrite.c>
RewriteCond %{QUERY_STRING} billplz [NC]
RewriteRule .* - [E=Cache-Control:no-cache]
</IfModule>

Langkah 3: Sahkan Penyelesaian

Lakukan transaksi ujian pembayaran FPX sebenar (cth. pesanan RM1.00) dan pastikan webhook mengemas kini status pesanan kepada Processing atau Completed secara automatik dalam masa beberapa saat selepas pembayaran.

---

Perlukan Bantuan Pakar di Malaysia?

Penat membetulkan ralat WordPress sendiri sedangkan perniagaan anda menanggung kerugian setiap saat? Jaga menyediakan perkhidmatan penyelenggaraan WordPress bertaraf enterprise di Malaysia.

• RM5,000 untuk Semakan Pemilikan & Akses penuh (kami perbetulkan arkitektur dan kawalan sistem anda).
• RM450/bulan untuk Pelan Penjagaan (Care Plan) terurus sepenuhnya.
• Bermula RM13,000/bulan untuk Penambahbaikan Sistem Bulanan. Tiada caj kadar per jam, hanya bukti portfolio yang telah disahkan (Daralwahi, Agros Empire, UrusHQ, nCrypt, Trexon Energy, TechFix Malaysia). Ketahui pelan Penyelenggaraan Laman Web kami hari ini.