Bank list

Live

GET/api/v1/bank-codes

The system-wide bank codes (active banks only, in display order) — powers the bank dropdown on register and withdraw forms.

Headers

Field	Type	Required	Description
Authorization	string	—	Not used — this endpoint is public; no member token required
X-Api-Key	string	Yes	Agent API key (ak_…) from the bo screen
X-Timestamp	string	Yes	Signing time in unix milliseconds (±300s skew allowed)
X-Nonce	string	Yes	Unique per-request value (UUIDv4) for replay protection
X-Signature	string	Yes	hex(HMAC-SHA256(secret, canonical)) — see the Authentication page
X-Player-IP	string	—	The player's real IP (IPv4/IPv6) — recommended (used in login history)
X-Player-UA	string	—	The player's User-Agent (optional — recorded in login history)
X-Request-Id	string	—	Your correlation id — echoed back as request_uuid (recommended)
x-lang	string	—	th (default) or en — the language of message

Response

Fields in data

Field	Type	Required	Description
[]	object[]	—	data is an array of banks — each item has the fields below
└ code	string	—	Standard bank code, e.g. KBANK, SCB, BBL — send this back on register/withdraw
└ name_th	string	—	Bank name in Thai
└ name_en	string	—	Bank name in English
└ logo_url	string \| null	—	Bank logo URL — when null, render a colour badge from display_color instead
└ display_color	string \| null	—	Bank brand colour in hex, e.g. "#138F2D", for the fallback badge
└ display_order	number	—	Display order (the list is already sorted)

Response example

{
  "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"
}