เปรียบเทียบเวอร์ชัน

EasySlip มี API 2 เวอร์ชัน คู่มือนี้จะช่วยให้คุณเลือกเวอร์ชันที่เหมาะสมกับความต้องการ

เปรียบเทียบอย่างรวดเร็ว

ฟีเจอร์	API v1	API v2
สถานะ	เสถียร	ล่าสุด
Base URL	/api/v1	/api/v2
ตรวจสอบสลิปธนาคาร	ใช่	ใช่
TrueMoney Wallet	ใช่	ไม่
สร้าง QR Code	ใช่	ไม่
จับคู่บัญชี	ไม่	ใช่
ตรวจสอบจำนวนเงิน	ไม่	ใช่
หลาย Branch	ไม่	ใช่
รูปแบบ Response	Legacy	มาตรฐาน

API v2 (แนะนำ)

Base URL: https://api.easyslip.com/v2

ข้อดี

1. รูปแบบ Response มาตรฐาน

   • โครงสร้าง success, data, error ที่สม่ำเสมอ
   • Error Code ที่ชัดเจนพร้อมข้อความอธิบาย

2. จับคู่บัญชี

   • จับคู่บัญชีผู้รับกับบัญชีธนาคารที่ลงทะเบียน
   • การจับคู่ชื่ออัจฉริยะ (85% similarity threshold)
   • รองรับ PromptPay และบัญชีร้านค้า

3. ตรวจสอบจำนวนเงิน

   • ตรวจสอบว่าจำนวนเงินที่คาดหวังตรงกับสลิป
   • ป้องกันการจ่ายน้อยหรือมากเกินไป

4. รองรับหลาย Branch

   • สร้าง API Key หลายตัวต่อแอปพลิเคชัน
   • ติดตามโควต้าต่อ Branch
   • IP Restrictions ที่ต่างกันต่อ Branch

5. Error Handling ที่ดีขึ้น

   • Error Response ที่มีโครงสร้าง
   • Error Code เฉพาะเจาะจงสำหรับการ Debug

Endpoints

Endpoint	Method	คำอธิบาย
/verify/bank	POST	ตรวจสอบสลิปธนาคาร
/info	GET	ดูข้อมูลแอปพลิเคชัน
/health	GET	ตรวจสอบสถานะ

ตัวอย่าง Request

curl -X POST https://api.easyslip.com/v2/verify/bank \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "payload": "QR_PAYLOAD",
    "matchAccount": true,
    "matchAmount": 1000,
    "checkDuplicate": true
  }'

ตัวอย่าง Response

{
  "success": true,
  "data": {
    "isDuplicate": false,
    "matchedAccount": {
      "bank": {
        "nameTh": "กสิกรไทย",
        "code": "004"
      },
      "nameTh": "บริษัท ตัวอย่าง จำกัด"
    },
    "amountInOrder": 1000,
    "amountInSlip": 1000,
    "isAmountMatched": true,
    "rawSlip": { ... }
  },
  "message": "Bank slip verified successfully"
}

API v1 (Legacy)

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

ข้อดี

1. รองรับ TrueMoney Wallet

   • ตรวจสอบการโอน TrueMoney Wallet
   • อ่าน QR Code และ OCR

2. สร้าง QR Code

   • สร้าง PromptPay QR Code
   • รองรับ K-Shop, Mae Manee, Tungngern

3. เสถียรและผ่านการทดสอบ

   • ใช้งานจริงมานาน
   • มีเอกสารครบถ้วน

Endpoints

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

ตัวอย่าง Request

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

ตัวอย่าง Response

{
  "status": 200,
  "data": {
    "payload": "00000000...",
    "transRef": "68370160657749I376388B35",
    "date": "2024-01-15T14:30:00+07:00",
    "amount": {
      "amount": 1000
    },
    "sender": { ... },
    "receiver": { ... }
  }
}

เมื่อไหร่ควรใช้เวอร์ชันไหน

ใช้ API v2 เมื่อ:

• เริ่มโปรเจกต์ใหม่
• ต้องการฟีเจอร์จับคู่บัญชี
• ต้องการตรวจสอบจำนวนเงิน
• ต้องการ Error Handling มาตรฐาน
• ต้องการติดตามโควต้าหลาย Branch

ใช้ API v1 เมื่อ:

• ต้องการตรวจสอบ TrueMoney Wallet
• ต้องการสร้าง QR Code
• ดูแลโปรเจกต์เดิมที่ใช้ v1
• ยังไม่พร้อมย้ายไป v2

สรุป

สำหรับการเชื่อมต่อใหม่ เราแนะนำ API v2 เพราะมีฟีเจอร์ที่ดีกว่า Error Handling ที่ดีกว่า และรูปแบบ Response ที่เป็นมาตรฐาน API v1 ยังคงพร้อมใช้งานสำหรับฟีเจอร์ TrueMoney และ QR Code ที่ยังไม่มีใน v2