ภาพรวม API v1

API v1 เป็นเวอร์ชันเสถียร (Legacy) ของ EasySlip Developer API รองรับการตรวจสอบ TrueMoney Wallet และการสร้าง QR Code ที่ไม่มีใน v2

Base URL

https://developer.easyslip.com/api/v1

ฟีเจอร์หลัก

• ตรวจสอบสลิปธนาคาร - ตรวจสอบสลิปโอนเงินธนาคารไทย
• ตรวจสอบ TrueMoney Wallet - ตรวจสอบการโอนเงิน TrueMoney Wallet
• สร้าง QR Code - สร้าง QR Code พร้อมเพย์และร้านค้า
• ตรวจจับสลิปซ้ำ - ป้องกันการใช้สลิปซ้ำ

รูปแบบ Response

ทุก Response มีโครงสร้างดังนี้:

Response สำเร็จ:

{
  "status": 200,
  "data": { ... }
}

Response Error:

{
  "status": 400,
  "message": "error_code"
}

Endpoints

Endpoint	Method	คำอธิบาย
/verify	GET	ตรวจสอบสลิปด้วย Payload
/verify	POST	ตรวจสอบสลิปด้วยรูปภาพ/URL/Base64
/verify/truewallet	POST	ตรวจสอบ TrueMoney Wallet
/me	GET	ดูข้อมูลแอปพลิเคชัน
/qr/generate	POST	สร้าง QR Code

การยืนยันตัวตน

ทุก Request ต้องมี Bearer Token:

Authorization: Bearer YOUR_API_KEY

ดู คู่มือการยืนยันตัวตน สำหรับรายละเอียด

ตัวอย่างอย่างรวดเร็ว

ตรวจสอบสลิปด้วย Payload

curl -X GET "https://developer.easyslip.com/api/v1/verify?payload=YOUR_QR_PAYLOAD" \
  -H "Authorization: Bearer YOUR_API_KEY"

ตรวจสอบสลิปด้วยรูปภาพ

curl -X POST https://developer.easyslip.com/api/v1/verify \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@/path/to/slip.jpg"

ดูข้อมูลแอปพลิเคชัน

curl -X GET https://developer.easyslip.com/api/v1/me \
  -H "Authorization: Bearer YOUR_API_KEY"

รหัส Error

Code	HTTP Status	คำอธิบาย
unauthorized	401	API Key ไม่ถูกต้องหรือไม่มี
access_denied	403	IP ไม่อยู่ใน Whitelist
application_expired	403	Subscription หมดอายุ
application_deactivated	403	แอปพลิเคชันถูกปิดใช้งาน
quota_exceeded	403	เกินโควต้า API
invalid_payload	400	QR Payload ไม่ถูกต้อง
duplicate_slip	400	สลิปถูกตรวจสอบแล้ว
slip_not_found	404	ไม่พบสลิป
server_error	500	Internal Server Error

อัพเกรดเป็น v2

สำหรับโปรเจกต์ใหม่ พิจารณาใช้ API v2 สำหรับ:

• รูปแบบ Response มาตรฐาน
• ฟีเจอร์จับคู่บัญชี
• ตรวจสอบจำนวนเงิน
• Error Handling ที่ดีขึ้น

ดู เปรียบเทียบเวอร์ชัน สำหรับรายละเอียดการย้าย

ขั้นตอนถัดไป

• ข้อมูลแอปพลิเคชัน - ดูข้อมูลแอปพลิเคชัน
• ตรวจสอบสลิปธนาคาร - ตรวจสอบสลิปธนาคาร
• ตรวจสอบ TrueMoney - ตรวจสอบ TrueMoney
• สร้าง QR Code - สร้าง QR Code