REST API

สร้าง PromptPay QR (ข้อความ EMVCo)

สร้างข้อความ QR พร้อมเพย์ตามมาตรฐาน EMVCo เพื่อนำไปวาดเป็นภาพ QR เองในฝั่งของคุณ รองรับทั้งเบอร์โทรศัพท์ เลขบัตรประชาชน เลขผู้เสียภาษี และ e-Wallet

POST/api/promptpay-qr

การคิดโทเคน

ไม่หักโทเคน เป็นการสร้าง 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 ถ้าไม่ส่งจะได้ QR แบบให้ผู้โอนกรอกยอดเอง

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

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

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

{
  "code": "200001",
  "message": "Get Info Success",
  "data": {
    "qrCode": "00020101021229370016A00000067701011101130066812345678530376454061500.005802TH6304ABCD",
    "targetType": "phone",
    "amount": 1500
  }
}

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

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

ข้อควรรู้

targetType จะเป็น phone, citizen หรือ ewallet ตามความยาวของหมายเลขที่ส่งมา
ถ้าหมายเลขไม่เข้ารูปแบบใดเลย จะได้ HTTP 400 พร้อมข้อความ accountNumber must be a 10-digit phone, 13-digit ID, or 15-digit e-wallet id