WHMCS (ระบบบริหารโฮสติ้ง)

ขั้นที่ 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-whmcs-1.0.0.zip จากหน้านี้ แล้วแตกไฟล์
2. อัปโหลดโฟลเดอร์ modules และ includes ไปรวมกับโฟลเดอร์รากของ WHMCS (ไฟล์จะเข้าไปที่ modules/gateways/ppayslip.php, modules/gateways/callback/ppayslip.php และ includes/hooks/ppayslip.php)
3. เข้าหลังบ้าน WHMCS → ตั้งค่า (Setup) → การชำระเงิน (Payments) → ช่องทางชำระเงิน (Payment Gateways) → แท็บ All Payment Gateways → กดที่ "PPay Slip" เพื่อเปิดใช้งาน

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

1. ในแท็บ Manage Existing Gateways หา PPay Slip แล้วกรอก API Key, ร้านค้า (Shop) และ Webhook Secret
2. ตั้ง "Convert To For Processing" เป็นบาท (THB) ถ้าลูกค้าใช้สกุลเงินอื่น หรือใช้สกุลเงินบาทเป็นหลัก
3. ไปที่ PPay Slip เมนู "คิวงาน & Webhook" ใส่ Webhook URL เป็น https://(โดเมน WHMCS ของคุณ)/modules/gateways/callback/ppayslip.php
4. ตรวจว่า cron ของ WHMCS ทำงานอยู่ (ทุก 5 นาทีเป็นอย่างน้อย) เพื่อให้ระบบตรวจสถานะสำรอง
5. สร้างใบแจ้งหนี้ทดสอบ ยอดต่ำ ๆ เลือกช่องทาง PPay Slip แล้วจ่ายด้วยตัวเอง 1 ครั้ง

การเติมเครดิต (Add Funds)

เปิดฟีเจอร์ Add Funds ของ WHMCS (ตั้งค่า → ทั่วไป → Credit) ลูกค้าจะกดเติมเครดิตแล้วเลือกช่องทาง PPay Slip ได้เหมือนใบแจ้งหนี้ทั่วไป เมื่อชำระสำเร็จ WHMCS เพิ่มเครดิตให้เอง

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

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

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

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

• ไม่เห็นช่องทางชำระเงิน: ตรวจว่าเปิดใช้งานโมดูลแล้ว และสกุลเงินใบแจ้งหนี้เป็นบาท (THB)
• ปุ่มชำระเงินขึ้นข้อความผิดพลาด: ดู Utilities → Logs → Module Log (เปิดการบันทึกก่อน) มักเป็น API Key/Shop ผิด ร้านยังไม่มีบัญชีรับเงิน หรือเครดิตหมด
• ลูกค้าจ่ายแล้วใบแจ้งหนี้ยังไม่ปิด: รอ cron ถัดไป หรือให้ลูกค้ากดรีเฟรชใบแจ้งหนี้ ระบบจะตรวจสถานะให้ทันที
• Webhook ตอบ 401: Webhook Secret ไม่ตรงหรือเวลาเซิร์ฟเวอร์ผิดเกิน 5 นาที

โมดูลนี้ผ่านการตรวจไวยากรณ์ PHP และทดสอบการเรียก API/ลายเซ็นกับเซิร์ฟเวอร์จริงแล้ว แต่ยังไม่ได้ทดสอบบนระบบ WHMCS จริง ควรลองในระบบทดสอบ (หรือด้วยใบแจ้งหนี้ยอดน้อย) ก่อนเปิดให้ลูกค้าทั้งหมด