บัญชีธนาคาร

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

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

Base URL

https://api.easyslip.com/v2

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

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

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

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

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 แต่ไม่ได้ส่งมา)
BANK_ACCOUNT_NOT_FOUND	404	ไม่พบบัญชี หรือบัญชีไม่ได้เชื่อมโยงกับ Branch ของคุณ
BANK_ACCOUNT_DUPLICATE	409	Service ของคุณมีบัญชีที่ใช้งานอยู่ซึ่ง bankCode + bankNumber ซ้ำกันแล้ว

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