สรุปคำตอบ
Payment Gateway Error ใน WooCommerce คือปัญหาที่ระบบรับชำระเงินซึ่งเชื่อมร้านกับผู้ให้บริการชำระเงินทำงานผิดพลาด เช่น กดจ่ายแล้ว Error วนกลับหน้าเดิม หรือจ่ายสำเร็จแต่ Order ไม่อัปเดต สาเหตุที่พบบ่อยคือ API Key หรือ Secret Key ผิดหรือสลับระหว่างโหมด Test กับ Live, Webhook/Callback ไม่ทำงาน, SSL มีปัญหา และ Plugin ที่แก้หน้า Checkout ขัดแย้งกัน วิธีแก้คือตรวจ Key ให้ตรงโหมด Live ตรวจ Webhook URL และ SSL ปิด Plugin ทีละตัว แล้วสั่งซื้อทดสอบจริงด้วยยอดเล็กๆ ทุกช่องทาง
เมื่อลูกค้าเลือกสินค้าและกดจ่ายเงิน แต่ระบบจ่ายเงินกลับ Error หรือไม่ทำงาน นั่นคือยอดขายที่หลุดมือไปทันที ปัญหา Payment Gateway ใน WooCommerce เป็นเรื่องที่ต้องรีบแก้ บทความนี้จะอธิบายสาเหตุและวิธีตรวจสอบ
อาการของปัญหา Payment Gateway
- เลือกวิธีจ่ายเงินไม่ได้ หรือไม่มีตัวเลือกการจ่ายเงินขึ้น
- กดจ่ายเงินแล้ว Error หรือวนกลับมาหน้าเดิม
- ลูกค้าจ่ายเงินสำเร็จแต่ Order ไม่เข้าระบบ หรือสถานะไม่อัปเดต
- ระบบยังอยู่ในโหมดทดสอบ (Test/Sandbox) ทำให้จ่ายเงินจริงไม่ได้
สาเหตุที่พบบ่อย
- API Key หรือ Secret Key ผิด — เป็นสาเหตุอันดับต้น ๆ มักเกิดจากคัดลอกผิดหรือสลับ Key ของโหมด Test กับ Live ซึ่งปลั๊กอิน Omise ก็แยกช่องใส่ Key ของสองโหมดออกจากกัน (เอกสารปลั๊กอิน Omise)
- Webhook / Callback ไม่ทำงาน — ทำให้สถานะ Order ไม่อัปเดตหลังจ่ายเงิน เพราะ Gateway แจ้งผลกลับผ่าน callback (คู่มือ Payment Gateway API ของ WooCommerce) (อ่าน ปัญหา Webhook และ Callback)
- SSL มีปัญหา — Gateway ส่วนใหญ่ต้องการ HTTPS ที่สมบูรณ์ เช่น Omise ที่ระบุว่า Webhook endpoint ต้องเป็น HTTPS ที่มี SSL Certificate ถูกต้อง (เอกสาร Webhooks) และ WooCommerce ก็ระบุว่าโฮสต์ต้องรองรับ HTTPS (ข้อกำหนดเซิร์ฟเวอร์)
- Plugin ขัดแย้งกัน — โดยเฉพาะ Plugin ที่แก้หน้า Checkout และ Plugin ชำระเงินรุ่นเก่าที่ยังไม่รองรับ Checkout แบบ Block ซึ่งเป็นค่าเริ่มต้นของร้านที่เริ่มหลัง WooCommerce 8.3 (เอกสาร WooCommerce)
- ยังเปิดโหมด Test ไว้ — ลืมสลับเป็นโหมด Live
วิธีตรวจสอบและแก้ไข
- ตรวจสอบ API Key / Secret Key ให้ตรงกับโหมด Live ในหน้าตั้งค่า Gateway
- ยืนยันว่า SSL ทำงานสมบูรณ์ (เว็บขึ้น https สีเขียวทุกหน้า)
- ตรวจ Webhook URL ในระบบของผู้ให้บริการชำระเงินว่าตั้งค่าถูกต้อง (ปลั๊กอิน Omise แสดง URL ที่ต้องใช้ไว้ในหน้า Settings ของปลั๊กอิน ตามซอร์สโค้ด) และดู Log ของ Gateway ตามคู่มือ Logging ของ WooCommerce
- ปิด Plugin ที่เกี่ยวกับ Checkout ทีละตัวเพื่อหาตัวขัดแย้ง
- ดูคำเตือนที่ WooCommerce > Status
เมื่อไหร่ควรเรียกผู้เชี่ยวชาญ
เพราะทุกชั่วโมงที่จ่ายเงินไม่ได้คือยอดขายที่หาย หากแก้เองไม่ได้หรือเกี่ยวข้องกับ Webhook ที่ซับซ้อน บริการ แก้ปัญหา WooCommerce ของเราจะตรวจสอบและทดสอบให้ครบทุกขั้นตอน ดูปัญหาที่เกี่ยวข้องได้ที่ Checkout ไม่ได้ และ ปัญหา PromptPay
- ถ้าปัญหาคือช่องทางชำระเงินไม่ขึ้นในหน้า Checkout เลย ดูวิธีเช็กได้ที่ ช่องทางชำระเงินไม่ขึ้นในหน้า Checkout WooCommerce
- รูปแบบการเชื่อมต่อ gateway ทั้งแบบ redirect และแบบฝังช่องกรอกบัตรส่งผลต่อความเสี่ยงคนละแบบ ดูการเปรียบเทียบได้ที่ Magecart คืออะไร
คำถามที่พบบ่อย
ลูกค้าจ่ายเงินแล้วแต่ Order ไม่เข้า เงินหายไหม?
เงินไม่หาย เพราะอยู่ที่ผู้ให้บริการชำระเงิน แต่ Order ไม่อัปเดตเพราะ Webhook ไม่ทำงาน ควรรีบแก้และตรวจสอบรายการกับผู้ให้บริการ
ตั้งค่า Payment Gateway เองได้ไหม?
ได้หากมีคู่มือจากผู้ให้บริการและพื้นฐานการตั้งค่า แต่จุดที่พลาดบ่อยคือ API Key, Webhook และโหมด Test/Live จึงควรทดสอบให้ครบทุกครั้ง
ทำไมจ่ายเงินได้ในโหมด Test แต่ Live ไม่ได้?
มักเป็นเพราะใช้ API Key ของโหมด Test กับ Live สลับกัน หรือยังไม่ได้เปิดใช้งานบัญชี Live กับผู้ให้บริการชำระเงิน
Payment Gateway คืออะไร?
Payment Gateway คือบริการตัวกลางที่รับชำระเงินออนไลน์แทนร้าน เช่น บัตรเครดิตหรือ PromptPay แล้วแจ้งผลกลับมาที่ WooCommerce ผ่าน API และ Webhook เพื่ออัปเดตสถานะ Order
API Key โหมด Test กับ Live ต่างกันอย่างไร?
Key โหมด Test ใช้ทดลองจ่ายเงินโดยไม่มีการตัดเงินจริง ส่วน Key โหมด Live ใช้รับเงินจริงจากลูกค้า ถ้าร้านเปิดใช้งานจริงแต่ยังใส่ Key ของ Test หรือใส่สลับกัน การจ่ายเงินจะล้มเหลวหรือ Order ไม่อัปเดต
แหล่งอ้างอิง
- Omise. (ม.ป.ป.). WooCommerce (เอกสารปลั๊กอิน). สืบค้นเมื่อ 3 พฤศจิกายน 2026, จาก https://docs.omise.co/woocommerce
- Omise. (ม.ป.ป.). Webhooks. สืบค้นเมื่อ 3 พฤศจิกายน 2026, จาก https://docs.omise.co/api-webhooks
- Omise. (ม.ป.ป.). omise-page-settings.php (ซอร์สโค้ดปลั๊กอิน Omise for WooCommerce). สืบค้นเมื่อ 3 พฤศจิกายน 2026, จาก https://github.com/omise/omise-woocommerce/blob/master/includes/admin/views/omise-page-settings.php
- WooCommerce. (ม.ป.ป.). Payment Gateway API. สืบค้นเมื่อ 3 พฤศจิกายน 2026, จาก https://developer.woocommerce.com/docs/features/payments/payment-gateway-api/
- WooCommerce. (ม.ป.ป.). Server requirements. สืบค้นเมื่อ 3 พฤศจิกายน 2026, จาก https://woocommerce.com/document/server-requirements/
- WooCommerce. (ม.ป.ป.). Customizing Cart and Checkout. สืบค้นเมื่อ 3 พฤศจิกายน 2026, จาก https://woocommerce.com/document/woocommerce-store-editing/customizing-cart-and-checkout/
- WooCommerce. (ม.ป.ป.). Logging. สืบค้นเมื่อ 3 พฤศจิกายน 2026, จาก https://developer.woocommerce.com/docs/best-practices/data-management/logging/
