📘 คู่มือการใช้งาน: Phajay Payment Integration (All-in-One)
Phajay Payment Integration คือปลั๊กอิน WordPress ที่ช่วยเชื่อมต่อเว็บไซต์ของคุณกับระบบชำระเงิน Phajay อย่างครบวงจร รองรับทั้งการสร้าง Payment Link, ตัดบัตรเครดิต (Credit Card) และ สแกน QR Code (ทุกธนาคารในลาว) ภายในปุ่มเดียว

✨ คุณสมบัติเด่น (Features)
3-in-1 Payment: รองรับ 3 รูปแบบการชำระเงินในจุดเดียว (Link / QR / Credit Card)

Multi-Bank QR: รองรับการสร้าง QR Code จากธนาคารชั้นนำ (BCEL OnePay, JDB, LDB, Indochina Bank)

User Friendly: หน้าตาปุ่มกดและการเลือกธนาคารออกแบบมาให้ใช้งานง่าย (Radio Buttons & Dropdown)

Customizable: ปรับแต่งสีปุ่ม, ข้อความ, และความโค้งมนได้จากหลังบ้าน

Dynamic Amount: รองรับการรับค่า "ยอดเงิน" แบบอัตโนมัติผ่าน URL หรือ Code (เหมาะสำหรับระบบตะกร้าสินค้า)

📥 1. การติดตั้ง (Installation)
ดาวน์โหลดไฟล์ .zip ของปลั๊กอิน

เข้าสู่ระบบหลังบ้าน WordPress (wp-admin)

ไปที่เมนู Plugins (ปลั๊กอิน) > Add New (เพิ่มปลั๊กอินใหม่)

กดปุ่ม Upload Plugin (อัปโหลดปลั๊กอิน) ด้านบน

เลือกไฟล์ .zip แล้วกด Install Now (ติดตั้ง)

กด Activate (เปิดใช้งาน)

⚙️ 2. การตั้งค่า (Configuration)
ก่อนใช้งาน ต้องเชื่อมต่อกับบัญชี Phajay ของคุณก่อน:

ไปที่เมนู Settings (ตั้งค่า) > Phajay Payment

Secret Key: นำรหัส Secret Key ที่ได้จาก Phajay Portal มาใส่

ตัวเลือกการชำระเงิน: ติ๊กเลือกช่องทางที่คุณต้องการเปิดให้ลูกค้าเห็น:

✅ Payment Link: สำหรับพาไปหน้าชำระเงินรวมของ Phajay

✅ Scan QR: สำหรับแสดง QR Code ให้สแกนทันทีบนหน้าเว็บ

✅ Credit Card: สำหรับพาไปหน้าตัดบัตรเครดิต

ดีไซน์ปุ่ม: กำหนดสีพื้นหลัง, สีตัวอักษร, ข้อความบนปุ่ม, และความโค้งมน (Border Radius) ตามต้องการ

กด Save Changes

💻 3. การใช้งาน (Usage)
นำ Shortcode ไปวางในหน้า Page, Post หรือ Widget ที่ต้องการแสดงปุ่มชำระเงิน

🟢 แบบพื้นฐาน (Basic)
ใช้ยอดเงินและรายละเอียดตามที่กำหนดใน Shortcode:

Plaintext

[phajay_pay_button amount="100000" description="ค่าบริการออกแบบ"]
amount: จำนวนเงินที่ต้องชำระ (LAK)

description: รายละเอียดสินค้า/บริการ

label: ข้อความบนปุ่ม (หากไม่ใส่ จะดึงจากค่าที่ตั้งไว้ใน Settings)

🚀 4. การใช้งานขั้นสูง (Advanced / Dynamic)
หากต้องการให้ยอดเงิน "เปลี่ยนไปตามจริง" (เช่น ตามออเดอร์ลูกค้า) ไม่ต้องแก้ Shortcode ทุกครั้ง ให้ใช้วิธีดังนี้:

วิธีที่ A: ส่งค่าผ่าน URL (แนะนำสำหรับส่งลิงก์ให้ลูกค้า)
สร้างหน้าเพจเปล่าๆ 1 หน้า (เช่นหน้า /pay) แล้ววาง Shortcode: [phajay_pay_button]

จากนั้นส่งลิงก์ให้ลูกค้าพร้อมแนบตัวแปร ?pay_amount=ยอดเงิน ต่อท้าย:

ตัวอย่าง: https://yourwebsite.com/pay?pay_amount=250000

ผลลัพธ์: ระบบจะดึงยอด 250,000 มาแสดงและสร้างรายการชำระเงินให้อัตโนมัติ

วิธีที่ B: ใช้คำสั่ง PHP (สำหรับนักพัฒนาธีม)
หากคุณเขียนโค้ดในไฟล์ Template ของธีม หรือดึงราคาจากฐานข้อมูล:

PHP

<?php
  // ตัวอย่าง: ดึงราคาจากตัวแปร
  $price = 550000; 
  $product = "รองเท้า Nike";

  echo do_shortcode('[phajay_pay_button amount="' . $price . '" description="' . $product . '"]');
?>
❓ คำถามที่พบบ่อย (FAQ)
Q: ทำไม QR Code ไม่ขึ้น? A: กรุณาตรวจสอบ Secret Key ว่าถูกต้องหรือไม่ และเซิร์ฟเวอร์ของคุณต้องรองรับการเชื่อมต่อกับภายนอก (Allow allow_url_fopen หรือ cURL)

Q: จ่ายเงินเสร็จแล้ว ให้เด้งไปหน้าไหน? A: คุณต้องไปตั้งค่า Success URL และ Cancel URL ที่หน้าเว็บ Phajay Portal (เมนู Settings > Callback URL) โดยตรง ปลั๊กอินจะส่งลูกค้าไปตามหน้าที่ตั้งค่าไว้นั้นหลังจากชำระเงินเสร็จ

Q: ต้องการเปลี่ยนชื่อธนาคารใน Dropdown? A: รายชื่อธนาคารเป็นค่ามาตรฐานของระบบ (BCEL, JDB, LDB, IB) หากต้องการแก้ไขต้องทำในโค้ดปลั๊กอินไฟล์หลัก