บัญชีธนาคาร

จัดการบัญชีธนาคารที่เชื่อมต่อกับสาขาของคุณ บัญชีธนาคารกำหนดว่าผู้รับเงินรายใดจะถูกตรวจสอบโดย slip verification API

ดูบัญชีธนาคารที่เชื่อมต่อ

GET /b2b/branches/:branchId/bank-accounts

Full URL: https://api.easyslip.com/b2b/branches/:branchId/bank-accounts

Permission: bank-account:read

ตัวอย่าง

cURL

curl -X GET https://api.easyslip.com/b2b/branches/cm1a2b3c4d5e6f7g8h9i0/bank-accounts \
  -H "X-API-Key: ${API_KEY}" \
  -H "X-Timestamp: ${TIMESTAMP}" \
  -H "X-Nonce: ${NONCE}" \
  -H "X-Signature: ${SIGNATURE}"

JavaScript

const headers = signRequest({
    method: 'GET',
    path: '/b2b/branches/cm1a2b3c4d5e6f7g8h9i0/bank-accounts',
    body: null,
    apiKey: 'your_api_key',
    secretKey: 'your_secret_key',
})

const response = await fetch(
    'https://api.easyslip.com/b2b/branches/cm1a2b3c4d5e6f7g8h9i0/bank-accounts',
    { headers }
)
const result = await response.json()

Success Response (200)

{
    "success": true,
    "data": [
        {
            "id": "cm9z8y7x6w5v4u3t2s1r0",
            "bankCode": "004",
            "bankNumber": "123-4-56789-0",
            "nameTh": "บริษัท อีซี่สลิป จำกัด",
            "nameEn": "EasySlip Co., Ltd.",
            "type": "SAVING",
            "extraVerify": false,
            "createdAt": "2024-03-01T09:00:00+07:00"
        },
        {
            "id": "cm8a7b6c5d4e3f2g1h0i9",
            "bankCode": "014",
            "bankNumber": "987-6-54321-0",
            "nameTh": "บริษัท อีซี่สลิป จำกัด",
            "nameEn": "EasySlip Co., Ltd.",
            "type": "CURRENT",
            "extraVerify": true,
            "createdAt": "2024-05-15T14:30:00+07:00"
        }
    ]
}

ฟิลด์ใน Response

ฟิลด์	ชนิด	คำอธิบาย
id	string	ID บัญชีธนาคาร
bankCode	string	รหัสธนาคาร (ดู รหัสธนาคาร)
bankNumber	string	เลขที่บัญชี
nameTh	string	ชื่อเจ้าของบัญชีภาษาไทย
nameEn	string	ชื่อเจ้าของบัญชีภาษาอังกฤษ
type	string	ประเภทบัญชี (SAVING, CURRENT)
extraVerify	boolean	เปิดใช้การตรวจสอบเพิ่มเติมหรือไม่
createdAt	string	เวลาที่สร้าง (ISO 8601)

---

เชื่อมต่อบัญชีธนาคารกับสาขา

เชื่อมต่อบัญชีธนาคารที่มีอยู่แล้วหนึ่งรายการหรือมากกว่ากับสาขา

POST /b2b/branches/:branchId/bank-accounts

Full URL: https://api.easyslip.com/b2b/branches/:branchId/bank-accounts

Permission: bank-account:write

Request Body

ฟิลด์	ชนิด	จำเป็น	คำอธิบาย
bankAccountIds	string[]	ใช่	Array ของ ID บัญชีธนาคารที่ต้องการเชื่อมต่อ

ตัวอย่าง

cURL

curl -X POST https://api.easyslip.com/b2b/branches/cm1a2b3c4d5e6f7g8h9i0/bank-accounts \
  -H "Content-Type: application/json" \
  -H "X-API-Key: ${API_KEY}" \
  -H "X-Timestamp: ${TIMESTAMP}" \
  -H "X-Nonce: ${NONCE}" \
  -H "X-Signature: ${SIGNATURE}" \
  -d '{
    "bankAccountIds": ["cm8a7b6c5d4e3f2g1h0i9", "cm7b6c5d4e3f2g1h0i9j8"]
  }'

JavaScript

const body = {
    bankAccountIds: ['cm8a7b6c5d4e3f2g1h0i9', 'cm7b6c5d4e3f2g1h0i9j8'],
}

const headers = signRequest({
    method: 'POST',
    path: '/b2b/branches/cm1a2b3c4d5e6f7g8h9i0/bank-accounts',
    body,
    apiKey: 'your_api_key',
    secretKey: 'your_secret_key',
})

const response = await fetch(
    'https://api.easyslip.com/b2b/branches/cm1a2b3c4d5e6f7g8h9i0/bank-accounts',
    {
        method: 'POST',
        headers,
        body: JSON.stringify(body),
    }
)
const result = await response.json()

Success Response (200)

{
    "success": true,
    "data": {
        "linked": 2,
        "bankAccounts": [
            {
                "id": "cm8a7b6c5d4e3f2g1h0i9",
                "bankCode": "014",
                "bankNumber": "987-6-54321-0",
                "nameTh": "บริษัท อีซี่สลิป จำกัด",
                "nameEn": "EasySlip Co., Ltd."
            },
            {
                "id": "cm7b6c5d4e3f2g1h0i9j8",
                "bankCode": "025",
                "bankNumber": "456-7-89012-3",
                "nameTh": "บริษัท อีซี่สลิป จำกัด",
                "nameEn": "EasySlip Co., Ltd."
            }
        ]
    }
}

---

ยกเลิกการเชื่อมต่อบัญชีธนาคาร

DELETE /b2b/branches/:branchId/bank-accounts/:bankAccountId

Full URL: https://api.easyslip.com/b2b/branches/:branchId/bank-accounts/:bankAccountId

Permission: bank-account:write

ตัวอย่าง

cURL

curl -X DELETE https://api.easyslip.com/b2b/branches/cm1a2b3c4d5e6f7g8h9i0/bank-accounts/cm8a7b6c5d4e3f2g1h0i9 \
  -H "X-API-Key: ${API_KEY}" \
  -H "X-Timestamp: ${TIMESTAMP}" \
  -H "X-Nonce: ${NONCE}" \
  -H "X-Signature: ${SIGNATURE}"

JavaScript

const headers = signRequest({
    method: 'DELETE',
    path: '/b2b/branches/cm1a2b3c4d5e6f7g8h9i0/bank-accounts/cm8a7b6c5d4e3f2g1h0i9',
    body: null,
    apiKey: 'your_api_key',
    secretKey: 'your_secret_key',
})

const response = await fetch(
    'https://api.easyslip.com/b2b/branches/cm1a2b3c4d5e6f7g8h9i0/bank-accounts/cm8a7b6c5d4e3f2g1h0i9',
    { method: 'DELETE', headers }
)
const result = await response.json()

Success Response (200)

{
    "success": true,
    "data": {
        "unlinked": true,
        "bankAccountId": "cm8a7b6c5d4e3f2g1h0i9",
        "branchId": "cm1a2b3c4d5e6f7g8h9i0"
    }
}

---

สร้างบัญชีธนาคารใหม่

สร้างบัญชีธนาคารใหม่ที่สามารถเชื่อมต่อกับสาขาได้

POST /b2b/bank-accounts

Full URL: https://api.easyslip.com/b2b/bank-accounts

Permission: bank-account:write

Request Body

ฟิลด์	ชนิด	จำเป็น	คำอธิบาย
bankCode	string	ใช่	รหัสธนาคาร (ดู รหัสธนาคาร)
bankNumber	string	ใช่	เลขที่บัญชี
nameTh	string	ใช่	ชื่อเจ้าของบัญชีภาษาไทย
nameEn	string	ใช่	ชื่อเจ้าของบัญชีภาษาอังกฤษ
type	string	ใช่	ประเภทบัญชี: SAVING หรือ CURRENT
extraVerify	boolean	ไม่	เปิดใช้การตรวจสอบเพิ่มเติม (ค่าเริ่มต้น: false)

ตัวอย่าง

cURL

curl -X POST https://api.easyslip.com/b2b/bank-accounts \
  -H "Content-Type: application/json" \
  -H "X-API-Key: ${API_KEY}" \
  -H "X-Timestamp: ${TIMESTAMP}" \
  -H "X-Nonce: ${NONCE}" \
  -H "X-Signature: ${SIGNATURE}" \
  -d '{
    "bankCode": "002",
    "bankNumber": "111-2-33444-5",
    "nameTh": "บริษัท ตัวอย่าง จำกัด",
    "nameEn": "Example Co., Ltd.",
    "type": "SAVING",
    "extraVerify": false
  }'

JavaScript

const body = {
    bankCode: '002',
    bankNumber: '111-2-33444-5',
    nameTh: 'บริษัท ตัวอย่าง จำกัด',
    nameEn: 'Example Co., Ltd.',
    type: 'SAVING',
    extraVerify: false,
}

const headers = signRequest({
    method: 'POST',
    path: '/b2b/bank-accounts',
    body,
    apiKey: 'your_api_key',
    secretKey: 'your_secret_key',
})

const response = await fetch('https://api.easyslip.com/b2b/bank-accounts', {
    method: 'POST',
    headers,
    body: JSON.stringify(body),
})
const result = await response.json()

Success Response (201)

{
    "success": true,
    "data": {
        "id": "cm6d5e4f3g2h1i0j9k8l7",
        "bankCode": "002",
        "bankNumber": "111-2-33444-5",
        "nameTh": "บริษัท ตัวอย่าง จำกัด",
        "nameEn": "Example Co., Ltd.",
        "type": "SAVING",
        "extraVerify": false,
        "createdAt": "2025-01-10T12:00:00+07:00"
    }
}

Error Responses

ไม่พบบัญชีธนาคาร (404)

{
    "success": false,
    "error": {
        "code": "BANK_ACCOUNT_NOT_FOUND",
        "message": "Bank account not found"
    }
}

บัญชีธนาคารซ้ำ (409)

{
    "success": false,
    "error": {
        "code": "DUPLICATE_BANK_ACCOUNT",
        "message": "A bank account with this number already exists"
    }
}