POST /verify/bank/batch
ส่งสลิปธนาคารหลายใบในคำขอเดียว (สูงสุด 100) ได้ batchId กับ jobId สลิปละหนึ่งค่า และแต่ละสลิปมี Webhook Callback ของตัวเอง
Endpoint
POST /verify/bank/batchURL เต็ม: https://api.easyslip.com/v2/verify/bank/batch
การยืนยันตัวตน
ต้องยืนยันตัวตน ดู คู่มือการยืนยันตัวตน
Authorization: Bearer YOUR_API_KEYRequest
ส่ง Body เป็น JSON ที่มี callbackUrl (ไม่บังคับ) และ array slips แต่ละรายการใน slips เป็น QR payload อย่างเดียว ในรูปออบเจกต์ { "payload": "...", ... } พร้อมพารามิเตอร์จับคู่ที่ไม่บังคับ (กฎเดียวกับ POST /verify/bank/async)
| ฟิลด์ | ประเภท | คำอธิบาย |
|---|---|---|
slips | array | จำเป็น ออบเจกต์ payload 1-100 รายการ แต่ละรายการตรวจแยกกัน |
callbackUrl | string | https เท่านั้น ใช้กับ Webhook ของทุกสลิป ถ้าไม่ระบุจะใช้ Default Webhook URL ของ branch |
ข้อจำกัดและการตรวจสอบของ Batch
- แต่ละสลิปเป็น QR
payloadอย่างเดียว ไม่รองรับรูป, Base64 และ URL (แบบซิงโครนัสPOST /verify/bankยังรับครบทุกแบบ) - สูงสุด 100 สลิปต่อ batch ถ้าเกินจะได้
400VALIDATION_ERROR - ระบบเช็กข้อมูลแต่ละสลิปแยกกัน ถ้ามีสลิปใดที่ payload ว่างหรือขาดหาย ทั้ง batch จะถูกปฏิเสธด้วย
400และไม่มีสลิปไหนเข้าคิว
Type Definitions
// Request
interface AsyncVerifyBankBatchRequest {
callbackUrl?: string; // https เท่านั้น; fallback ไปที่ default ของ branch; ใช้กับทุกสลิป
slips: AsyncBatchSlip[]; // 1-100 รายการ
}
interface AsyncBatchSlip {
payload: string; // จำเป็น - QR payload (1-128 ตัวอักษร)
// พารามิเตอร์เสริม (เหมือนแบบ sync)
remark?: string; // 1-255 ตัวอักษร
matchAccount?: boolean;
matchAmount?: number;
checkDuplicate?: boolean;
}
// Response (202 Accepted)
interface AsyncBatchResponse {
success: true;
data: {
batchId: string; // UUID ของ batch
jobs: {
jobId: string; // UUID ต่อสลิป
index: number; // ตำแหน่งใน array `slips` ที่ส่งมา (เริ่มจาก 0)
}[];
};
}ตัวอย่าง
curl -X POST https://api.easyslip.com/v2/verify/bank/batch \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"callbackUrl": "https://your-app.example.com/webhooks/easyslip",
"slips": [
{ "payload": "00000000000000000000000000000000000000", "remark": "Order #1001" },
{ "payload": "11111111111111111111111111111111111111", "remark": "Order #1002" },
{ "payload": "22222222222222222222222222222222222222", "remark": "Order #1003" }
]
}'Response
Accepted (202)
ทุกสลิปเข้าคิวแล้ว ใช้ index (ลำดับใน array ที่คุณส่งมา) จับคู่ jobId แต่ละค่ากับสลิป ผลจะมาเป็น 1 Webhook ต่อ 1 สลิป
{
"success": true,
"data": {
"batchId": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
"jobs": [
{ "jobId": "3f2b1c8a-9d4e-4f10-b7a2-6c5d4e3f2a1b", "index": 0 },
{ "jobId": "7c6d5e4f-3a2b-4c1d-9e8f-0a1b2c3d4e5f", "index": 1 },
{ "jobId": "b9a8c7d6-5e4f-4a3b-2c1d-9e8f7a6b5c4d", "index": 2 }
]
}
}Error Responses
Validation Error (400)
ได้ Error นี้เมื่อ batch ว่าง เกิน 100 สลิป หรือมีสลิปใดไม่ถูกต้อง กรณีนี้ไม่มีสลิปไหนเข้าคิว
{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "slips: slips must not exceed 100 items"
}
}Invalid Callback URL (400)
{
"success": false,
"error": {
"code": "INVALID_CALLBACK_URL",
"message": "callbackUrl must use the https protocol"
}
}หมายเหตุ
- 1 batch = N Webhook (1 ต่อสลิป) ไม่ใช่ callback รวมอันเดียว จับคู่ด้วย
jobId(และbatchId) ใน Body ของ Webhook - หัก Quota ต่อสลิปที่ตรวจสำเร็จ สลิปที่ล้มเหลวหรือซ้ำไม่หัก
- สลิปเดียวที่ไม่ถูกต้องทำให้ทั้ง batch ถูกปฏิเสธ จึงควรเช็กข้อมูลฝั่ง client ก่อนส่ง batch ใหญ่ ๆ
- ดึงสถานะสลิปแต่ละรายการด้วย
GET /verify/bank/jobs/:jobId
ก่อนระบบรับงาน อาจได้ 429 RATE_LIMIT_EXCEEDED ให้รอตาม Retry-After คำขอที่ถูกปฏิเสธตรงนี้จะไม่มี Webhook ผลลัพธ์