GET /banks

ดูรายชื่อธนาคารที่รองรับทั้งหมด ใช้สำหรับเลือก bankCode ที่ถูกต้องเมื่อสร้างบัญชีธนาคาร

รายชื่อเป็นแบบคงที่ (17 ธนาคาร) และเรียงตาม code ทั้งนี้ TrueWallet จัดการแยกต่างหากและไม่รวมอยู่ในรายชื่อนี้

Endpoint

GET /banks

URL เต็ม: https://api.easyslip.com/v2/banks

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

จำเป็น ดูคู่มือการยืนยันตัวตน

Authorization: Bearer YOUR_API_KEY

Request

ไม่ต้องมี Request Body หรือ Query Parameter

Type Definitions

// Response Types
interface BanksResponse {
  success: true;
  data: Bank[];
}

interface Bank {
  code: string;              // รหัสธนาคาร — ใช้เป็น `bankCode` เมื่อสร้างบัญชี
  nameTh: string;            // ชื่อธนาคาร (ไทย)
  nameEn: string;            // ชื่อธนาคาร (อังกฤษ)
  shortCode: string;         // ตัวย่อ
  swiftCode: string;         // รหัส SWIFT/BIC
  extraVerify: ExtraVerifyOption[] | null;   // ตัวเลือกการตรวจสอบที่รองรับ หรือ null
}

interface ExtraVerifyOption {
  value: string;             // ส่งเป็น `extraVerify` เมื่อสร้าง/แก้ไขบัญชี
  label: string;             // คำอธิบายที่อ่านเข้าใจได้
}

// Error Response
interface ErrorResponse {
  success: false;
  error: {
    code: string;
    message: string;
  };
}

ตัวอย่าง

cURL

curl -X GET https://api.easyslip.com/v2/banks \
  -H "Authorization: Bearer YOUR_API_KEY"

JavaScript

const response = await fetch('https://api.easyslip.com/v2/banks', {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});

const result = await response.json();
console.log(result.data);

PHP

$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => 'https://api.easyslip.com/v2/banks',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_API_KEY'
    ]
]);

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
print_r($result['data']);

Python

import requests
import os

response = requests.get(
    'https://api.easyslip.com/v2/banks',
    headers={'Authorization': f'Bearer {os.environ["EASYSLIP_API_KEY"]}'}
)

result = response.json()
print(result['data'])

Response

สำเร็จ (200)

{
  "success": true,
  "data": [
    {
      "code": "002",
      "nameTh": "ธนาคารกรุงเทพ",
      "nameEn": "Bangkok Bank",
      "shortCode": "BBL",
      "swiftCode": "BKKBTHBK",
      "extraVerify": [
        { "value": "NAME", "label": "ตรวจจาก ชื่อบัญชี อย่างเดียว (ไม่แนะนำ)" },
        { "value": "NUMBER", "label": "ตรวจจาก เลขบัญชี อย่างเดียว" },
        { "value": "NAME_NUMBER", "label": "ตรวจจาก เลขบัญชีและชื่อบัญชีธนาคาร" }
      ]
    },
    {
      "code": "004",
      "nameTh": "ธนาคารกสิกรไทย",
      "nameEn": "Kasikornbank",
      "shortCode": "KBANK",
      "swiftCode": "KASITHBK",
      "extraVerify": [
        { "value": "NAME", "label": "ตรวจจาก ชื่อบัญชี อย่างเดียว (ไม่แนะนำ)" },
        { "value": "NUMBER", "label": "ตรวจจาก เลขบัญชี อย่างเดียว" },
        { "value": "NAME_NUMBER", "label": "ตรวจจาก เลขบัญชีและชื่อบัญชีธนาคาร" }
      ]
    },
    {
      "code": "014",
      "nameTh": "ธนาคารไทยพาณิชย์",
      "nameEn": "Siam Commercial Bank",
      "shortCode": "SCB",
      "swiftCode": "SICOTHBK",
      "extraVerify": [
        { "value": "NAME", "label": "ตรวจจาก ชื่อบัญชี อย่างเดียว (ไม่แนะนำ)" },
        { "value": "NUMBER", "label": "ตรวจจาก เลขบัญชี อย่างเดียว" },
        { "value": "NAME_NUMBER", "label": "ตรวจจาก เลขบัญชีและชื่อบัญชีธนาคาร" }
      ]
    }
  ]
}

ฟิลด์ใน Response

ฟิลด์	ชนิด	คำอธิบาย
code	string	รหัสธนาคาร — ใช้เป็น bankCode เมื่อสร้างบัญชี
nameTh	string	ชื่อธนาคาร (ไทย)
nameEn	string	ชื่อธนาคาร (อังกฤษ)
shortCode	string	ตัวย่อ
swiftCode	string	รหัส SWIFT/BIC
extraVerify	ExtraVerifyOption[] | null	ตัวเลือกการตรวจสอบที่ธนาคารนี้รองรับ หรือ null หากไม่มี
extraVerify[].value	string	ค่าที่ส่งเป็น extraVerify เมื่อสร้าง/แก้ไขบัญชี
extraVerify[].label	string	คำอธิบายตัวเลือกที่อ่านเข้าใจได้

Error Responses

ไม่ได้รับอนุญาต (401)

{
  "success": false,
  "error": {
    "code": "MISSING_API_KEY",
    "message": "Authorization header is required"
  }
}

หมายเหตุ

• Endpoint นี้ไม่นับใช้โควต้า
• ค่า code คือค่าที่ส่งเป็น bankCode ไปยัง POST /bank-accounts
• extraVerify คือรายการตัวเลือกการตรวจสอบที่ธนาคารรองรับ ธนาคารบางแห่งไม่มีตัวเลือก (คืนค่า extraVerify: null) เมื่อสร้างหรือแก้ไขบัญชี ให้อ่านรายการนี้แล้วส่งค่า value ตัวใดตัวหนึ่งเป็น extraVerify ของบัญชี
• ดูตารางอ้างอิงรหัสธนาคารทั้งหมดได้ที่ รหัสธนาคาร