Adobe Commerce / Magento 2

ขั้นที่ 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-magento2-1.0.0.zip จากหน้านี้ แล้วแตกไฟล์
2. คัดลอกโฟลเดอร์ app ไปรวมกับโฟลเดอร์รากของ Magento (ไฟล์จะอยู่ที่ app/code/PPay/SlipPayment/)
3. รันคำสั่งที่รากของ Magento: php bin/magento module:enable PPay_SlipPayment
4. รัน php bin/magento setup:upgrade แล้ว php bin/magento setup:di:compile (โหมด production) และ php bin/magento setup:static-content:deploy -f th_TH en_US
5. รัน php bin/magento cache:flush

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

1. เข้าหลังบ้าน Magento → Stores → Configuration → Sales → Payment Methods → PPay Slip
2. ตั้ง เปิดใช้งาน = ใช่ แล้วกรอก API Key, ร้านค้า (Shop) และ Webhook Secret (บันทึกแบบเข้ารหัส) ที่ขอบเขต Default Config (Webhook อ่านค่าจากขอบเขตนี้ ถ้าตั้งเฉพาะระดับ Store View จะตรวจลายเซ็นไม่ผ่าน)
3. ไปที่ PPay Slip เมนู "คิวงาน & Webhook" ใส่ Webhook URL เป็น https://(โดเมนร้านของคุณ)/ppay/webhook/index
4. ตรวจว่า cron ของ Magento ทำงาน (php bin/magento cron:run) เพื่อให้ระบบตรวจสถานะสำรองทุก 5 นาที
5. ลองสั่งซื้อสินค้าราคาต่ำ ๆ ด้วยตัวเอง 1 รายการเพื่อทดสอบ

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

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

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

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

• ไม่เห็นวิธีชำระเงิน: ตรวจว่าสกุลเงินของ Store View เป็น THB, เปิดใช้งานโมดูล และกรอก API Key กับ Shop ครบ
• เริ่มชำระเงินไม่ได้: ดูประวัติสถานะ (Comments) ในคำสั่งซื้อ และไฟล์ var/log/system.log มักเป็น API Key ผิด ร้านไม่มีบัญชีรับเงิน หรือเครดิตหมด
• ลูกค้าจ่ายแล้วแต่คำสั่งซื้อยังเป็น Pending: ตรวจว่า cron ทำงาน หรือเปิดหน้านั้นอีกครั้งหลังจ่าย ระบบตรวจให้ทันทีเมื่อลูกค้ากลับร้าน
• ทำแล้วไม่เห็นหน้าตั้งค่า: รัน setup:upgrade และ cache:flush อีกครั้ง

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