Skip to content

Async Verify - Bank ​

ตรวจสอบสลิปโอนเงินธนาคารไทยแบบ อะซิงโครนัส (asynchronous) ไม่ต้องรอผลใน HTTP Response คุณส่งสลิปเข้าคิวทีละรายการหรือหลายรายการ แล้วรับผลทาง Webhook Callback (หรือใช้ Polling เป็นทางสำรอง)

ระบบนี้ทำงาน คู่ขนาน กับ POST /verify/bank แบบซิงโครนัส ซึ่งยังทำงานเหมือนเดิม เลือกใช้แบบ async เมื่อต้องการ:

  • ตรวจสอบ จำนวนมาก (bulk) (ส่งได้สูงสุด 100 สลิปในครั้งเดียว)
  • ใช้คิวแยกจังหวะการรับคำขอออกจากการตรวจ (แต่ async ไม่ได้ข้าม rate limit: ตอนส่งอาจได้ 429 RATE_LIMIT_EXCEEDED และงานที่รับแล้วอาจต้องรอ capacity ของ worker)
  • ตรวจสลิปที่ข้อมูลมาช้า (เช่น ธนาคารกรุงเทพ) Job จะ retry อยู่เบื้องหลังตามจำนวนรอบที่ระบุด้านล่าง

Base URL ​

https://api.easyslip.com/v2

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

ต้องยืนยันตัวตนด้วย API Key ของ Branch เดียวกัน กับที่ใช้ตรวจสอบสลิปแบบซิงโครนัส ดู คู่มือการยืนยันตัวตน

http
Authorization: Bearer YOUR_API_KEY

Endpoints ​

EndpointMethodคำอธิบาย
/verify/bank/asyncPOSTส่ง 1 สลิปเข้าคิว → 202 พร้อม jobId
/verify/bank/batchPOSTส่ง หลาย สลิป (สูงสุด 100) → 202 พร้อม batchId + jobs
/verify/bank/jobs/:jobIdGETดึงสถานะ/ผลลัพธ์ของ Job (ทางสำรองหากพลาด Webhook)

สลิปแต่ละรายการที่เข้าคิวจะได้ Webhook Callback 1 ครั้ง สลิปใน Batch ก็เช่นกัน (1 callback ต่อ 1 สลิป ไม่ใช่ 1 ต่อ batch)

หลักการทำงาน ​

  1. ส่งเข้าคิว ด้วย POST /verify/bank/async (หรือหลายรายการด้วย /batch) ได้ jobId กลับมาทันที (202 Accepted) ตอนนี้สลิปยังไม่ถูกตรวจสอบ
  2. ถ้าทุกธนาคารตอบ not_found หรือ BBL ยัง pending ระบบจะ retry สูงสุด 4 ครั้ง เว้นช่วง 30/60/120/240 วินาที (ตรวจรวม 5 ครั้ง) เวลารอตามตารางนี้รวม 7 นาที 30 วินาที ยังไม่นับเวลาประมวลผลและรอคิว ถ้าพบสลิปเมื่อไรก็จบทันที
  3. EasySlip เข้าคิวส่ง Webhook ผลเป็น success, not_found หรือ failed กรณีสำเร็จ data จะเหมือนแบบ sync กรณี failed จะได้ data: null กับ error.code/message ที่ปลอดภัย ถ้าล้มเหลวเพราะ billing จะส่งผลล้มเหลวหลังใช้ retry ของ billing ครบแล้ว
  4. ถ้าพลาด Webhook ให้เรียก GET /verify/bank/jobs/:jobId ดึงข้อมูล Job มาเอง (เก็บไว้ ~7 วัน)

การระบุ Callback URL ​

แต่ละคำขอระบุ callbackUrl เองได้ ถ้าไม่ระบุ ระบบจะใช้ Default Webhook URL ที่ตั้งไว้ของ Branch

กฎพฤติกรรม
ระบุ callbackUrlระบบ POST Webhook ผลลัพธ์ไปที่ URL นั้น (ใช้แทน default ของ branch)
ไม่ระบุ callbackUrlใช้ Default Webhook URL ที่ตั้งค่าไว้ของ Branch
ไม่ได้ตั้งทั้งคู่400 VALIDATION_ERROR
ไม่ใช่ https400 INVALID_CALLBACK_URL
ชี้ไปยัง address ภายใน/private400 INVALID_CALLBACK_URL

HTTPS เท่านั้น

callbackUrl ต้องเป็น URL https:// สาธารณะ ระบบปฏิเสธ URL ที่ไม่ใช่ HTTPS และ URL ที่ชี้ไป private/internal IP range เพื่อความปลอดภัย

Default Webhook URL และ Secret ที่ใช้เซ็นลายเซ็นตั้งได้ในการตั้งค่า Webhook ของ Branch วิธีตรวจลายเซ็นอยู่ที่หน้า Webhook Callback

Quota และรายการซ้ำ ​

การตรวจสอบแบบ async คิดค่าใช้จ่ายเหมือนแบบ sync:

  • Quota: หัก quota เฉพาะการตรวจสอบที่สำเร็จ รายการที่ล้มเหลวหรือซ้ำไม่หัก
  • รายการซ้ำ: ส่ง checkDuplicate: true เพื่อให้ได้ isDuplicate ของสลิปที่ Branch เดิม เคยตรวจแล้ว ไม่ว่าทาง sync หรือ async ค่าเริ่มต้นคือ false ซึ่งจะไม่ส่งฟิลด์นี้กลับมา รายการซ้ำใน Branch เดิมไม่หัก quota ซ้ำ

รหัส Error ​

รหัสHTTP Statusคำอธิบาย
VALIDATION_ERROR400Body ไม่ถูกต้อง, สลิปว่าง, Batch เกิน 100 สลิป หรือไม่มี callbackUrl และไม่มี default ของ branch
INVALID_CALLBACK_URL400callbackUrl ไม่ใช่ https หรือชี้ไปยัง address ภายใน/private
JOB_NOT_FOUND404ไม่พบ Job / Job หมดอายุ หรือ Job ไม่ได้เป็นของ Branch คุณ

Error การยืนยันตัวตนมาตรฐาน (MISSING_API_KEY, INVALID_API_KEY, SERVICE_EXPIRED, QUOTA_EXCEEDED ฯลฯ) ก็เกิดที่นี่ได้เช่นกัน ดู อ้างอิงรหัส Error

Bank Slip Verification API for Thai Banking