บัญชีธนาคาร

จัดการบัญชีธนาคารที่ใช้สำหรับการจับคู่ตรวจสอบสลิป

ทุก Endpoint ยืนยันตัวตนด้วย API Key ของ Branch และจำกัดขอบเขตเฉพาะ Branch ที่เรียกใช้ กล่าวคือ Branch หนึ่งจะเห็นและจัดการได้เฉพาะบัญชีของตัวเองเท่านั้น (บัญชีจะถูกเชื่อมโยงกับ Branch ที่สร้างโดยอัตโนมัติ) หากเข้าถึงบัญชีที่ไม่ได้เชื่อมโยงกับ Branch ของคุณ จะได้รับ 404

Base URL

https://api.easyslip.com/v2

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

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

Authorization: Bearer YOUR_API_KEY

ขอบเขตการเข้าถึง (Scope)

กฎ	พฤติกรรม
การมองเห็นระดับ Branch	Branch จะเห็นเฉพาะบัญชีของตัวเอง (เชื่อมโยงอัตโนมัติตอนสร้าง)
การเข้าถึงข้าม Branch	เข้าถึงบัญชีที่ไม่ได้เชื่อมโยงกับ Branch ของคุณ จะได้รับ 404
การแยกตาม Service	บัญชีจะอยู่ภายใต้ Service ของคุณเสมอ
serviceId	กำหนดจากฝั่งเซิร์ฟเวอร์ตาม API Key — ไม่สามารถกำหนดเองใน Request ได้

รูปแบบ Response

ทุก Response ใช้รูปแบบมาตรฐานของ v2

สำเร็จ:

{
  "success": true,
  "data": { }
}

ผิดพลาด:

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

Endpoints

Endpoint	Method	คำอธิบาย
/banks	GET	รายชื่อธนาคารที่รองรับ
/bank-accounts	POST	สร้างบัญชีธนาคาร
/bank-accounts	GET	รายการบัญชีธนาคารของ Branch
/bank-accounts/all	GET	รายการบัญชีทั้งหมดใน Service
/bank-accounts/:id	GET	ดูบัญชีธนาคารรายการเดียว
/bank-accounts/:id	PATCH	แก้ไขบัญชีธนาคาร
/bank-accounts/:id/link	POST	เชื่อมโยงบัญชีเข้ากับ Branch ของคุณ
/bank-accounts/:id/link	DELETE	ยกเลิกการเชื่อมโยงบัญชีออกจาก Branch ของคุณ

ไม่มี Endpoint สำหรับลบบัญชี

ระบบไม่มี Endpoint สำหรับลบบัญชีธนาคารโดยเจตนา บัญชีถูกจัดการแบบ soft-managed

การจับคู่ PromptPay

บัญชี PromptPay รองรับ matchMode: 'NAME' | 'NUMBER' | 'NAME_NUMBER' ตอนสร้างและแก้ไข โดย NAME ตรวจชื่อผู้รับ, NUMBER ตรวจเลข proxy account และ NAME_NUMBER บังคับให้ทั้งสองส่วนตรงกัน หากไม่ส่งฟิลด์นี้ ระบบจะรองรับไคลเอนต์เดิมและใช้ effective mode NUMBER สำหรับค่าเดิมที่เป็น null/ไม่มีค่า

matchMode ใช้ได้กับ PromptPay เท่านั้น และ ไม่ได้ แทนที่ extraVerify: ประเภท PromptPay proxy ในสลิปยังต้องตรงกับค่า extraVerify ของบัญชีก่อนตรวจชื่อ/เลขตามโหมด

ขั้นตอนการใช้งานทั่วไป

1. เรียก GET /banks เพื่อเลือก bankCode ที่ถูกต้อง
2. เรียก POST /bank-accounts เพื่อสร้างบัญชี — บัญชีจะถูกเชื่อมโยงกับ Branch ที่เรียกใช้โดยอัตโนมัติ และมองเห็นได้ทันที
3. ใช้ GET /bank-accounts และ GET /bank-accounts/:id เพื่อเรียกดูข้อมูลกลับมา
4. ยกเลิกการเชื่อมโยง บัญชีเพื่อเอาออกจากรายการของ Branch คุณ ภายหลังหาเจอได้อีกที่ GET /bank-accounts/all แล้วเชื่อมโยงกลับได้

รหัส Error

รหัส	HTTP Status	คำอธิบาย
VALIDATION_ERROR	400	Request Body หรือ Query Parameter ไม่ถูกต้อง
INVALID_BANK_CODE	400	bankCode ไม่อยู่ในรายชื่อธนาคารที่รองรับ
INVALID_EXTRA_VERIFY	400	extraVerify ไม่ใช่ตัวเลือกที่ถูกต้องของธนาคาร (หรือธนาคารใหม่บังคับให้ระบุตอนเปลี่ยน bankCode แต่ไม่ได้ส่งมา)
INVALID_MATCH_MODE	400	ส่ง matchMode ให้บัญชีที่ไม่ใช่ PromptPay
BANK_ACCOUNT_NOT_FOUND	404	ไม่พบบัญชี หรือบัญชีไม่ได้เชื่อมโยงกับ Branch ของคุณ
BANK_ACCOUNT_DUPLICATE	409	มีบัญชีที่ใช้งานอยู่ซึ่งมี bankCode + bankNumber ซ้ำกันใน Service ของคุณแล้ว

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