เปรียบเทียบเวอร์ชัน
EasySlip มี API 2 เวอร์ชัน หน้านี้เทียบให้ดูว่าต่างกันตรงไหนและควรใช้เวอร์ชันไหน
เปรียบเทียบอย่างรวดเร็ว
| ฟีเจอร์ | API v1 | API v2 |
|---|---|---|
| สถานะ | เสถียร | ล่าสุด |
| Base URL | /v1 | /v2 |
| ตรวจสอบสลิปธนาคาร | ใช่ | ใช่ |
| TrueMoney Wallet | ใช่ | ใช่ |
| สร้าง QR Code | ใช่ | ไม่ |
| จับคู่บัญชี | ไม่ | ใช่ |
| ตรวจสอบจำนวนเงิน | ไม่ | ใช่ |
| หลาย Branch | ไม่ | ใช่ |
| รูปแบบ Response | Legacy | มาตรฐาน |
API v2 (แนะนำ)
Base URL: https://api.easyslip.com/v2
ข้อดี
รูปแบบ Response มาตรฐาน
- โครงสร้าง
success,data,errorที่สม่ำเสมอ - Error Code ที่ชัดเจนพร้อมข้อความอธิบาย
- โครงสร้าง
จับคู่บัญชี
- จับคู่บัญชีผู้รับกับบัญชีธนาคารที่ลงทะเบียน
- จับคู่ชื่อแบบใกล้เคียง (similarity threshold 85%)
- รองรับ PromptPay และบัญชีร้านค้า
ตรวจสอบจำนวนเงิน
- ตรวจว่ายอดเงินที่คาดไว้ตรงกับยอดในสลิป
- กันกรณีลูกค้าจ่ายขาดหรือจ่ายเกิน
รองรับหลาย Branch
- สร้าง API Key หลายตัวต่อแอปพลิเคชัน
- ติดตามโควต้าต่อ Branch
- IP Restrictions ที่ต่างกันต่อ Branch
จัดการ Error ได้ดีขึ้น
- Error Response มีโครงสร้างชัดเจน
- Error Code เจาะจงพอให้ Debug ได้ง่าย
Endpoints
| Endpoint | Method | คำอธิบาย |
|---|---|---|
/verify/bank | POST | ตรวจสอบสลิปธนาคาร |
/info | GET | ดูข้อมูลแอปพลิเคชัน |
/health | GET | ตรวจสอบสถานะ |
/banks | GET | รายชื่อธนาคารที่รองรับ |
/bank-accounts | GET/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
ข้อดี
รองรับ TrueMoney Wallet
- ตรวจสอบการโอน TrueMoney Wallet
- อ่าน QR Code และ OCR
สร้าง QR Code
- สร้าง PromptPay QR Code
- รองรับ K-Shop, Mae Manee, Tungngern
เสถียร
- ใช้งานจริงมานานและผ่านการทดสอบแล้ว
- เอกสารครบ
Endpoints
| Endpoint | Method | คำอธิบาย |
|---|---|---|
/verify | GET | ตรวจสอบด้วย Payload |
/verify | POST | ตรวจสอบด้วยรูปภาพ/URL/Base64 |
/verify/truewallet | POST | ตรวจสอบ TrueMoney |
/me | GET | ดูข้อมูลแอปพลิเคชัน |
/qr/generate | POST | สร้าง 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 ยังไม่มี