ภาพรวม API v2

API v2 เป็นเวอร์ชันล่าสุดของ EasySlip Developer API มีฟีเจอร์ที่ปรับปรุง Error Handling ที่ดีขึ้น และรูปแบบ Response ที่เป็นมาตรฐาน

Base URL

https://api-partners.easyslip.com/v2

ฟีเจอร์หลัก

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

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

Response สำเร็จ:

{
  "success": true,
  "data": { ... },
  "message": "Operation completed successfully"
}

Response Error:

{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "ข้อความอธิบาย Error"
  }
}

จับคู่บัญชี

จับคู่ผู้รับในสลิปกับบัญชีธนาคารที่คุณลงทะเบียน:

{
  "payload": "QR_PAYLOAD",
  "matchAccount": true
}

Response จะมีข้อมูลบัญชีที่จับคู่ได้:

{
  "matchedAccount": {
    "bank": {
      "nameTh": "กสิกรไทย",
      "nameEn": "KASIKORNBANK",
      "code": "004",
      "shortCode": "KBANK"
    },
    "nameTh": "บริษัท ตัวอย่าง จำกัด",
    "nameEn": "EXAMPLE CO., LTD.",
    "type": "JURISTIC",
    "bankNumber": "123-4-56789-0"
  }
}

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

ตรวจสอบว่าจำนวนเงินในสลิปตรงกับที่คาดหวัง:

{
  "payload": "QR_PAYLOAD",
  "matchAmount": 1500.50
}

Response จะมีผลการตรวจสอบ:

{
  "amountInOrder": 1500.50,
  "amountInSlip": 1500.50,
  "isAmountMatched": true
}

รองรับหลาย Branch

สร้าง API Branch หลายตัวพร้อม:

• API Key แยกต่อ Branch
• ติดตามโควต้าต่อ Branch
• IP Restrictions ที่ต่างกัน

Endpoints

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

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

API v2 ใช้ HMAC-SHA256 Signature Authentication สำหรับ endpoint ตรวจสอบสลิปและข้อมูล ให้ใช้ Branch UUID เป็น X-API-Key ทุก Request ต้องมี Header ดังนี้:

Header	คำอธิบาย
X-API-Key	Branch UUID ของคุณ (เช่น a1b2c3d4-e5f6-7890-abcd-ef1234567890)
X-Timestamp	Unix Timestamp (วินาที)
X-Nonce	UUID v4 ไม่ซ้ำต่อ Request
X-Signature	HMAC-SHA256 Signature

TIP

HMAC Authentication จำเป็นสำหรับทุก Endpoint Signature คำนวณด้วย secret key ของ Partners client

ดู คู่มือ Authentication สำหรับรายละเอียดการ Implement และตัวอย่างโค้ด

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

ดู คู่มือ Authentication สำหรับตัวอย่าง Request พร้อม HMAC Signature Headers

รหัส Error

Code	HTTP Status	คำอธิบาย
MISSING_API_KEY	401	ไม่มี X-API-Key Header
INVALID_API_KEY	401	API Key ไม่ถูกต้อง
MISSING_SIGNATURE	401	ไม่มี X-Signature Header
INVALID_SIGNATURE	401	HMAC Signature ไม่ถูกต้อง
TIMESTAMP_EXPIRED	401	X-Timestamp เก่าเกินไปหรืออนาคตเกินไป
NONCE_REUSED	401	X-Nonce ถูกใช้ไปแล้ว
BRANCH_INACTIVE	403	Branch ถูกปิดใช้งาน
SERVICE_BANNED	403	บริการถูกระงับ
USER_BANNED	403	ผู้ใช้ถูกระงับ
IP_NOT_ALLOWED	403	IP ไม่อยู่ใน Whitelist
QUOTA_EXCEEDED	403	เกินโควต้า API
VALIDATION_ERROR	400	Request ไม่ถูกต้อง
SLIP_NOT_FOUND	404	ไม่พบสลิปหรือสลิปไม่ถูกต้อง
API_SERVER_ERROR	500	Error จาก API ภายนอก

ดู รหัส Error ทั้งหมด สำหรับรายการเต็ม

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

• ตรวจสอบสลิปธนาคาร - เรียนรู้การตรวจสอบสลิป
• ข้อมูลแอปพลิเคชัน - ดูข้อมูลแอปพลิเคชัน
• รหัส Error - จัดการ Error อย่างถูกต้อง