WooCommerce (WordPress)

ขั้นที่ 1: เตรียมข้อมูลจาก PPay Slip

1. สมัครและเข้าสู่ระบบที่ PPay Slip แล้วสร้าง ร้านค้า ที่เมนู "ร้านค้า & รับชำระเงิน" (ตั้งที่อยู่ร้านเป็นภาษาอังกฤษ เช่น my-shop) และเพิ่ม บัญชีรับเงิน อย่างน้อย 1 บัญชี (พร้อมเพย์หรือบัญชีธนาคาร พร้อมชื่อบัญชี)
2. สร้าง API Key ที่เมนู "API สำหรับนักพัฒนา" (ขึ้นต้นด้วย ppk_) และเก็บไว้ เห็นครั้งเดียวตอนสร้าง
3. (แนะนำ) ที่เมนู "คิวงาน & Webhook" คัดลอก Webhook Secret (ขึ้นต้น whsec_) เพื่อให้ระบบยืนยันคำสั่งซื้อให้ทันทีที่ลูกค้าจ่าย
4. เตรียมเครดิตหรือแพ็กเกจในบัญชี PPay Slip ไว้ เพราะสลิปที่ลูกค้าอัปโหลดแต่ละใบนับเป็นการตรวจ 1 ครั้ง (ตามราคาที่คุณซื้อ)

ขั้นที่ 2: ติดตั้งปลั๊กอิน

1. ดาวน์โหลดไฟล์ ppay-slip-woocommerce-1.0.0.zip จากหน้านี้
2. ใน WordPress ไปที่ ปลั๊กอิน → เพิ่มปลั๊กอินใหม่ → อัปโหลดปลั๊กอิน เลือกไฟล์ .zip → ติดตั้งตอนนี้ → เปิดใช้งาน
3. (ถ้าอัปโหลดไม่ได้ ให้แตกไฟล์ แล้วอัปโหลดโฟลเดอร์ ppay-slip-woocommerce ไปที่ wp-content/plugins/ ด้วย FTP)

ขั้นที่ 3: ตั้งค่า

1. ไปที่ WooCommerce → ตั้งค่า → การชำระเงิน → PPay Slip → จัดการ
2. ติ๊ก "เปิดใช้งาน" แล้วกรอก API Key, ร้านค้า (Shop) = ที่อยู่ร้านที่ตั้งไว้ (เช่น my-shop), และ Webhook Secret
3. คัดลอก "Webhook URL ของร้านนี้" (ในหน้าเดียวกัน) ไปวางที่ PPay Slip เมนู "คิวงาน & Webhook" แล้วกดบันทึก
4. กดบันทึกการตั้งค่า แล้วลองสั่งซื้อสินค้าราคาต่ำ ๆ ด้วยตัวเอง 1 รายการเพื่อทดสอบ

ลูกค้าจะเห็นอะไร

1. เลือกวิธีชำระเงิน "โอนเงิน / พร้อมเพย์ (QR)" แล้วกดสั่งซื้อ
2. ระบบพาไปหน้าชำระเงินของ PPay Slip แสดง QR พร้อมยอดที่ถูกต้อง
3. ลูกค้าสแกนจ่าย แล้วอัปโหลดสลิปในหน้านั้น ระบบตรวจกับธนาคารทันที
4. เมื่อผ่าน หน้าเว็บมีปุ่มกลับไปที่ร้านค้าให้กด และคำสั่งซื้อถูกบันทึกว่าชำระแล้ว

ใช้เติมเครดิต / กระเป๋าเงิน (Wallet) ของ WooCommerce

การเติมเงินในปลั๊กอินกระเป๋าเงิน (เช่น TeraWallet) ทำงานเป็นคำสั่งซื้อปกติของ WooCommerce เมื่อคำสั่งซื้อเติมเงินเปลี่ยนเป็น "ชำระแล้ว" ปลั๊กอินกระเป๋าเงินจะเพิ่มยอดให้ลูกค้าเอง ดังนั้นเลือกวิธีชำระเงิน PPay Slip ตอนเติมเงินได้เลย (ตรวจสอบในตั้งค่าของปลั๊กอินกระเป๋าเงินว่าไม่ได้ห้ามวิธีชำระเงินนี้)

ผมทดสอบการเรียก API และการตรวจลายเซ็นกับเซิร์ฟเวอร์จริงแล้ว แต่ยังไม่ได้ทดสอบกับ TeraWallet หรือปลั๊กอินกระเป๋าเงินตัวใดโดยเฉพาะ ให้ลองเติมจำนวนน้อยก่อนเปิดใช้จริง

บัญชี PPay Slip ตั้ง Webhook ได้ 1 URL ถ้าคุณใช้หลายเว็บหรือหลายระบบในบัญชีเดียว ระบบอื่นจะไม่ได้รับ Webhook แต่ยังยืนยันการชำระเงินได้ตามปกติด้วยการตรวจสถานะอัตโนมัติทุก 5 นาทีและตอนที่ลูกค้ากลับมาที่หน้าร้าน (ช้ากว่า Webhook เล็กน้อย) ถ้าต้องการให้ทันทีทุกเว็บ ให้แยกบัญชี PPay Slip ต่อเว็บ

แก้ปัญหาที่พบบ่อย

• ไม่เห็นวิธีชำระเงินในหน้า Checkout: ตรวจว่าสกุลเงินร้านเป็นบาท (THB), กรอก API Key และ Shop ครบ และติ๊กเปิดใช้งานแล้ว
• ลูกค้าจ่ายแล้วแต่คำสั่งซื้อยังรอ: เปิดคำสั่งซื้อ → เมนูการดำเนินการ → "ตรวจสถานะการชำระเงิน PPay Slip" ถ้ายังไม่ขึ้น ให้ตรวจว่าลูกค้าอัปโหลดสลิปและผลเป็น "ชำระสำเร็จ" ที่หน้า PPay Slip หรือไม่
• ขึ้นข้อความเริ่มชำระเงินไม่ได้: เปิด "บันทึกการทำงาน" ในตั้งค่าปลั๊กอิน แล้วดูที่ WooCommerce → สถานะ → บันทึก (ppay-slip) มักเป็น API Key ผิด ร้านยังไม่มีบัญชีรับเงิน หรือเครดิตหมด
• Webhook ตอบ 401: Webhook Secret ไม่ตรง หรือเวลาของเซิร์ฟเวอร์เว็บคลาดเคลื่อนเกิน 5 นาที