REST API

สร้าง PromptPay QR เป็นลิงก์รูปภาพ

เหมือน endpoint สร้าง QR แต่ตอบกลับเป็นลิงก์รูปภาพ PNG ที่นำไปใส่ในแท็ก img ได้ทันที ไม่ต้องติดตั้งไลบรารีวาด QR เอง

POST/api/promptpay-qr-url

การคิดโทเคน

ไม่หักโทเคน เป็นการสร้าง QR เท่านั้น ไม่ได้เรียกข้อมูลจากธนาคาร

พารามิเตอร์

รูปแบบข้อมูลที่ส่งเข้ามา: application/json

`Headers`

ฟิลด์	ชนิดข้อมูล	จำเป็น	คำอธิบาย
`Authorization`	`string`	จำเป็น	Bearer ตามด้วย API Secret ของร้านค้า ดูวิธีสร้างคีย์ได้ที่หน้า Authentication
`Content-Type`	`string`	จำเป็น	application/json

`Body`

ฟิลด์	ชนิดข้อมูล	จำเป็น	คำอธิบาย
`payload.accountNumber`	`string`	จำเป็น	หมายเลขพร้อมเพย์ เบอร์โทรศัพท์ 10 หลัก เลขบัตรประชาชนหรือเลขผู้เสียภาษี 13 หลัก หรือ e-Wallet 15 หลัก
`payload.amount`	`number`	ไม่บังคับ	จำนวนเงินที่ต้องการให้ QR ระบุไว้ ต้องมากกว่า 0
`payload.size`	`number`	ไม่บังคับ	ขนาดภาพ QR เป็นพิกเซล ต้องเป็นจำนวนเต็มระหว่าง 128 ถึง 1024 ถ้าไม่ส่งจะใช้ขนาดมาตรฐานของระบบ

ตัวอย่างการเรียกใช้

curl -X POST "https://slip.thesurelab.com/api/promptpay-qr-url" \
  -H "Authorization: Bearer $API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
  "payload": {
    "accountNumber": "0812345678",
    "amount": 1500,
    "size": 512
  }
}'

ตัวอย่างผลลัพธ์

{
  "code": "200001",
  "message": "Get Info Success",
  "data": {
    "qrCode": "00020101021229370016A00000067701011101130066812345678530376454061500.005802TH6304ABCD",
    "url": "https://slip.thesurelab.com/api/qr-image?data=00020101021229370016A00000067701011101130066812345678530376454061500.005802TH6304ABCD&size=512",
    "amount": 1500
  }
}

อ่านผลจากฟิลด์ code เสมอ

ผลลัพธ์ทางธุรกิจทุกกรณีตอบกลับด้วย HTTP 200 ระบบจะแยกผลด้วยฟิลด์ code เท่านั้น ดูรายการรหัสทั้งหมดได้ที่หน้า Response

ข้อควรรู้

ลิงก์ใน data.url ชี้ไปที่ตัวสร้างภาพ QR ของระบบ ใช้กับแท็ก img ได้ทันทีโดยไม่ต้องแนบ Authorization
ถ้าต้องการวาด QR เอง ให้ใช้ค่า data.qrCode แทน