Skip to content

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

EasySlip มี API 2 เวอร์ชัน หน้านี้เทียบให้ดูว่าต่างกันตรงไหนและควรใช้เวอร์ชันไหน

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

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

API v2 (แนะนำ) ​

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

ข้อดี ​

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

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

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

    • ตรวจว่ายอดเงินที่คาดไว้ตรงกับยอดในสลิป
    • กันกรณีลูกค้าจ่ายขาดหรือจ่ายเกิน
  4. รองรับหลาย Branch

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

    • Error Response มีโครงสร้างชัดเจน
    • Error Code เจาะจงพอให้ Debug ได้ง่าย

Endpoints ​

EndpointMethodคำอธิบาย
/verify/bankPOSTตรวจสอบสลิปธนาคาร
/infoGETดูข้อมูลแอปพลิเคชัน
/healthGETตรวจสอบสถานะ
/banksGETรายชื่อธนาคารที่รองรับ
/bank-accountsGET/POST/PATCHจัดการบัญชีธนาคาร

ตัวอย่าง Request ​

bash
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 ​

json
{
  "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://api.easyslip.com/v1

ข้อดี ​

  1. รองรับ TrueMoney Wallet

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

    • สร้าง PromptPay QR Code
    • รองรับ K-Shop, Mae Manee, Tungngern
  3. เสถียร

    • ใช้งานจริงมานานและผ่านการทดสอบแล้ว
    • เอกสารครบ

Endpoints ​

EndpointMethodคำอธิบาย
/verifyGETตรวจสอบด้วย Payload
/verifyPOSTตรวจสอบด้วยรูปภาพ/URL/Base64
/verify/truewalletPOSTตรวจสอบ TrueMoney
/meGETดูข้อมูลแอปพลิเคชัน
/qr/generatePOSTสร้าง QR Code

ตัวอย่าง Request ​

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

ตัวอย่าง Response ​

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

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

ใช้ API v2 เมื่อ: ​

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

ใช้ API v1 เมื่อ: ​

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

สรุป ​

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

Bank Slip Verification API for Thai Banking