รายชื่อธนาคาร

ใช้งานได้

GET/api/v1/bank-codes

รหัสธนาคารที่ใช้ร่วมกันทั้งระบบ (เฉพาะที่เปิดใช้ เรียงตามลำดับแสดงผล) — ใช้ทำ dropdown เลือกธนาคารตอนสมัครสมาชิกและถอนเงิน

Headers

ฟิลด์	ชนิด	จำเป็น	คำอธิบาย
Authorization	string	—	ไม่ใช้ — endpoint นี้เป็น public ไม่ต้องแนบ token สมาชิก
X-Api-Key	string	ใช่	API key ของ agent (ak_…) จากหน้า bo
X-Timestamp	string	ใช่	เวลา sign เป็น unix milliseconds (คลาดเคลื่อนได้ ±300 วินาที)
X-Nonce	string	ใช่	ค่าไม่ซ้ำต่อ request (UUIDv4) กัน replay
X-Signature	string	ใช่	hex(HMAC-SHA256(secret, canonical)) — ดูหน้า Authentication
X-Player-IP	string	—	IP จริงของผู้เล่น (IPv4/IPv6) — แนะนำให้ส่ง (ใช้ใน login history)
X-Player-UA	string	—	User-Agent ของผู้เล่น (optional — ลง login history)
X-Request-Id	string	—	correlation id ของฝั่งคุณ — ระบบ echo กลับใน request_uuid (แนะนำให้ส่ง)
x-lang	string	—	th (default) หรือ en — ภาษาของ message

Response

ฟิลด์ใน data

ฟิลด์	ชนิด	จำเป็น	คำอธิบาย
[]	object[]	—	data เป็น array ของธนาคาร — ฟิลด์ของแต่ละรายการตามด้านล่าง
└ code	string	—	รหัสธนาคารมาตรฐาน เช่น KBANK, SCB, BBL — ส่งค่านี้กลับตอนสมัคร/ถอน
└ name_th	string	—	ชื่อธนาคารภาษาไทย
└ name_en	string	—	ชื่อธนาคารภาษาอังกฤษ
└ logo_url	string \| null	—	URL โลโก้ธนาคาร — ถ้า null ให้แสดง badge สีจาก display_color แทน
└ display_color	string \| null	—	สีประจำธนาคาร (hex) เช่น "#138F2D" สำหรับ badge สำรอง
└ display_order	number	—	ลำดับแสดงผล (รายการเรียงมาให้แล้ว)

ตัวอย่าง response

{
  "success": true,
  "code": 0,
  "message": "สำเร็จ",
  "data": [
    {
      "code": "KBANK",
      "name_th": "ธนาคารกสิกรไทย",
      "name_en": "Kasikornbank",
      "logo_url": "https://cdn.bestsystem.example/banks/kbank.png",
      "display_color": "#138F2D",
      "display_order": 1
    },
    {
      "code": "SCB",
      "name_th": "ธนาคารไทยพาณิชย์",
      "name_en": "Siam Commercial Bank",
      "logo_url": "https://cdn.bestsystem.example/banks/scb.png",
      "display_color": "#4E2E7F",
      "display_order": 2
    },
    {
      "code": "BBL",
      "name_th": "ธนาคารกรุงเทพ",
      "name_en": "Bangkok Bank",
      "logo_url": null,
      "display_color": "#1E4598",
      "display_order": 3
    }
  ],
  "request_uuid": "6e2a9c4f-8b13-4d07-a5e9-3f7c1d0b8a46"
}