แนะนำ

🤖 ใช้ AI ช่วยเขียนโค้ดอยู่ใช่ไหม?

ดาวน์โหลด llms-full-th.md — เอกสารอ้างอิงไฟล์เดียว (~55 KB Markdown) ครอบคลุมทุก endpoint, webhook, error และ integration pattern. paste เข้า ChatGPT, Claude, Cursor หรือ Copilot พร้อมโจทย์ของคุณ เพื่อให้ AI สร้างโค้ด integration ที่ถูกต้องและพร้อม production

ภาษาอังกฤษ: llms-full.md (English)

ขั้นตอนการใช้งานระบบชำระเงิน

✅ แนะนำ : ใช้ สร้างคำสั่งชำระเงิน — FLEX (หน้าชำระเงิน) สำหรับการรับฝากทั้งหมด — เรียก API ครั้งเดียว ได้ payment_url กลับมา FLEX จะใช้ทุกช่องทางการชำระเงินที่เรามีโดยอัตโนมัติ ลูกค้าจะได้รับคำสั่งโอนเป็น QR Code หรือเลขบัญชีธนาคาร บนหน้าชำระเงินของเรา ซึ่ง handle flow ของลูกค้า ให้ทั้งหมด (แนะนำวิธีใช้งาน, โอนเงิน, แจ้งสลิป) ส่วน endpoint สร้างคำสั่งชำระเงินอื่น ๆ จะถูกยกเลิก (deprecate) ในเร็ว ๆ นี้

ระบบ Payment Gateway รองรับการรับฝากผ่าน Thai QR Payment และการโอนตรงเข้าบัญชีธนาคาร โดยระบบจะสร้างคำสั่งโอน (QR Code หรือบัญชีปลายทาง) ที่มียอดเงินเฉพาะ โดยอาจมีการปรับทศนิยมเล็กน้อย เช่น หากร้านค้าต้องการเรียกเก็บ 100 บาท ยอดโอนอาจเป็น 99.98 หรือ 100.03 บาท และมีกำหนดเวลาสำหรับการทำรายการ

ร้านค้าต้องแจ้งลูกค้าอย่างชัดเจนให้ทำการชำระเงินภายในเวลาที่กำหนด และต้องชำระเพียงครั้งเดียวเท่านั้น (หากใช้ FLEX หน้าชำระเงินของเราจะแจ้งข้อมูลทั้งหมดนี้ให้ลูกค้าโดยอัตโนมัติ)

คำอธิบายกรณีโอนซ้ำ โอนนอกเวลาที่กำหนด หรือโอนจำนวนเงินไม่ตรงกับ QR CODE

โดยปกติ ลูกค้าจะต้องทำการโอนภายในเวลาที่กำหนดและอนุญาตให้โอนเพียงครั้งเดียว ห้ามโอนซ้ำโดยใช้ QR Code เดิม เนื่องจากระบบของเราจะสุ่มตัวเลขทศนิยมและล็อคจำนวนเงินให้กับลูกค้าแต่ละคนภายในช่วงเวลาที่กำหนด

หากลูกค้าโอนเงินนอกเวลาที่กำหนด หรือโอนจำนวนเงินที่แตกต่างจากที่ล็อคไว้ จำนวนเงินนั้นอาจถูกเครดิตไปยังบัญชีของลูกค้ารายอื่นที่อยู่ในช่วงเวลาที่ใช้งานอยู่ ในกรณีนี้ เราไม่สามารถหักเงินคืนจากบัญชีของลูกค้ารายอื่นได้

API

API ถูกออกแบบตามมาตรฐาน REST โดย API มี URL ที่สอดคล้องกับทรัพยากร รับ request body ในรูปแบบ JSON ตอบกลับด้วย JSON และใช้ HTTP response code มาตรฐาน โดยใช้อัลกอริทึม HMAC-SHA256 สำหรับการสร้าง Signature

โครงสร้าง API Request

ทุก API request ต้องมีฟิลด์บังคับดังต่อไปนี้:

merchant_id

รหัสร้านค้าที่ได้รับจากแพลตฟอร์ม

token

Token สำหรับยืนยันตัวตนที่ได้รับจากแพลตฟอร์ม

time

Unix timestamp ของเวลาที่ส่ง request ใช้เพื่อป้องกันการโจมตีแบบ replay attack และรับรองความใหม่ของ request

ตัวอย่าง Request:

{
  "merchant_id": "YOUR_MERCHANT_ID",
  "token": "YOUR_AUTH_TOKEN",
  "time": 1656272222
}

หมายเหตุเพิ่มเติม:

ฟิลด์ merchant_id, token และ time ต้องอยู่ใน request body ฟิลด์ time ต้องเป็น Unix timestamp ที่ถูกต้อง token ต้องเป็น authentication token ที่ถูกต้อง merchant_id ต้องเป็นรหัสร้านค้าที่ถูกต้อง หากขาดฟิลด์บังคับใดฟิลด์หนึ่ง ระบบจะตอบกลับด้วย error