Luminus Connector
Enterprise Gateway v3.0
บัญชีเชื่อมต่อออนไลน์
0 / 0
ยังไม่ได้เพิ่มบัญชีเชื่อมต่อ
ยอดเงินเข้าวันนี้ (THB)
฿0.00
0 รายการวันนี้ (00:00 - ปัจจุบัน)
อัตราส่งสำเร็จ & ความเร็วเฉลี่ย
100%
ความเร็วเฉลี่ย — ms (Keep-Alive)
คิวรอส่งซ้ำ (Outbox Queue)
0
ส่งซ้ำอัตโนมัติแบบ Exponential Backoff

ปริมาณรายการเงินเข้าย้อนหลัง 12 ชั่วโมง

คำนวณจากธุรกรรมจริงที่ตรวจพบในระบบ (ไม่รวมรายการทดสอบ Sandbox)

UTC+07:00

ความพร้อมของระบบเกตเวย์

สถานะโครงสร้างพื้นฐานและการผูก Webhook ปลายทาง

Primary Webhook Callback
ยังไม่ได้กำหนด URL ปลายทาง
รอตั้งค่า
Cloud LINE Chromium Engine
กำลังตรวจสอบ Runtime...
READY
Persistent Storage & Session Vault
เข้ารหัสเซสชันด้วย AES-256-GCM ถาวร
ACTIVE

สถานะบัญชีธนาคารที่เชื่อมต่อ

แสดงเฉพาะบัญชีที่คุณเพิ่มไว้ในระบบจริง ไม่มีบัญชีจำลอง

รายการเงินเข้าล่าสุด (Live Stream)

อัปเดตทันทีผ่าน WebSocket เมื่อมีข้อความแจ้งเตือนเงินเข้าจากธนาคาร

เวลาที่ตรวจพบ ธนาคาร / บัญชี จำนวนเงิน ข้อมูลผู้โอน สถานะส่ง Webhook รายละเอียด
ยังไม่มีรายการเงินเข้าในระบบ
วัน-เวลา (ไทย) ธนาคาร / บัญชี ยอดเงินเข้า ผู้โอนต้นทาง บัญชีรับเงิน ผลส่งต่อ Webhook จัดการ
ยังไม่มีประวัติรายการเงินเข้า
แสดง 0 รายการ

ขั้นตอนการเชื่อมต่อกับระบบของคุณ (3 ขั้นตอนง่ายๆ)

คัดลอก Gateway URL (ขั้นที่ 1) และ API Key (ขั้นที่ 2) ไปใช้ยืนยันตัวตนในระบบของคุณ จากนั้นวางลิงก์รับแจ้งเตือนของคุณในขั้นที่ 3

PERSISTENT KEY
ขั้นตอนที่ 1 • ข้อมูลอ้างอิงเกตเวย์

Gateway Endpoint URL

URL หลักของเกตเวย์นี้สำหรับเรียก REST API, ดึงรายการย้อนหลัง หรือเช็กสถานะ

ขั้นตอนที่ 2 • คีย์ความลับถาวร

Provider API Key (HMAC Secret)

ใช้ส่ง Bearer Token และตรวจลายเซ็น HMAC-SHA256 ฝั่งเซิร์ฟเวอร์ของคุณ

ขั้นตอนที่ 3 • ลิงก์รับ Webhook ของคุณ

Primary Webhook Callback URL

เช่น https://api.yourdomain.com/webhooks/bank-connector

ปลายทาง Webhook เพิ่มเติม (Multi-Endpoint Routing)

รองรับการกระจายข้อมูลเงินเข้าไปยังหลายเซิร์ฟเวอร์พร้อมกัน โดยแยก Secret และกรองธนาคารได้อิสระ

ชื่อปลายทาง Target Webhook URL ธนาคารที่รับ Secret ผลส่งล่าสุด จัดการ
ยังไม่มี Endpoint เพิ่มเติม

เงื่อนไขเวลาสลิป & การแจ้งเตือน Telegram

กำหนดขอบเขตอายุสลิปอัตโนมัติ แจ้งเตือนยอดใหญ่ และแจ้งเตือนเมื่อเซสชัน LINE หลุด

ความปลอดภัยการเข้าหน้าเว็บคอนโซล

ตั้งรหัสผ่านผู้ดูแลเพื่อป้องกันบุคคลภายนอกเปิดดู QR Code หรือแก้ไขค่า Webhook

ยังไม่ตั้งรหัส

รหัสผ่านถูกเข้ารหัสด้วย scrypt และบันทึกในฐานข้อมูลถาวร ไม่สูญหายหลังอัปเดตระบบ

ข้อมูลเชื่อมต่อด่วนของเกตเวย์นี้ (พร้อมคัดลอกใช้งาน)

ใช้ค่า 2 ช่องแรกในระบบปลายทางของคุณ แล้วนำลิงก์รับ Webhook ของคุณมากรอกในหน้าตั้งค่า

รอตั้งค่า Callback
3. Webhook Callback ปลายทางที่ตั้งค่าไว้
ยังไม่ได้ตั้งค่า Webhook Callback URL

เลือกรูปแบบการเชื่อมต่อที่เหมาะกับระบบของคุณ (รองรับ 2 วิธี)

ระบบนี้ทำหน้าที่เป็นตัวกลางอ่านแจ้งเตือนธนาคารจาก LINE OA แล้วส่งต่อข้อมูลเป็น JSON มาตรฐานไปยังระบบใดก็ได้

ทางเลือก • REST API POLLING PULL

แบบที่ 2: ดึงข้อมูลผ่าน REST API เอง (Pull)

หากระบบของคุณอยู่หลัง Firewall หรือไม่สะดวกเปิด Endpoint รับ Webhook สามารถให้ระบบของคุณเรียก GET /api/v1/transactions พร้อม Header Authorization: Bearer <API_KEY> เพื่อดึงรายการได้ทุกเวลา

  • ไม่ต้องเปิด Public Webhook Endpoint ให้ภายนอกเข้าถึง
  • กรองตามธนาคาร, ช่วงเวลา, สถานะ และยอดเงินขั้นต่ำได้
  • ใช้ร่วมกับ Webhook เพื่อทำ Reconcile ย้อนหลังได้เช่นกัน

สิ่งที่ผู้ต้องการเชื่อมต้องสร้างฝั่งระบบของคุณ (4 ขั้นตอนครบจบ)

หากเลือกเชื่อมต่อแบบ Webhook Push ให้เตรียม 4 ส่วนนี้บน Backend ของคุณ (มีโค้ดตัวอย่างพร้อมก๊อปวางในแท็บที่ 3)

STEP 1

สร้าง Endpoint POST 1 เส้น

สร้าง API URL บนเซิร์ฟเวอร์ของคุณ เช่น POST https://api.yourdomain.com/webhooks/bank-connector เพื่อรับ Content-Type: application/json

จากนั้นนำ URL นี้ไปใส่ในเมนู ตั้งค่า → Primary Webhook Callback URL
STEP 2

ตรวจสอบลายเซ็น HMAC-SHA256

ตรวจ Header X-Connector-Timestamp และ X-Connector-Signature ด้วยสูตร HMAC_SHA256(API_KEY, timestamp + "." + rawBody)

ใช้เปรียบเทียบแบบ timingSafeEqual เพื่อยืนยันว่าข้อมูลมาจากเกตเวย์จริง
STEP 3

แยกตาม event & กันซ้ำด้วย fingerprint

• DEPOSIT_DETECTED = เงินเข้า: อ่านยอดจาก deposit.amount และเก็บ fingerprint เป็น Unique Key ห้ามเติมซ้ำ
• BALANCE_SYNC = เงินออก/ถอน: อัปเดต availableBalance เท่านั้น ห้ามบวกเครดิต
• PING / HEARTBEAT = เช็กการเชื่อมต่อ ให้ตอบ 200 OK

STEP 4

ตอบกลับ HTTP 200 OK (JSON)

ตอบกลับภายใน 10 วินาที เช่น {"success": true, "status": "COMPLETED"} หรือ "PENDING_REVIEW" / "IGNORED"

ถ้าเซิร์ฟเวอร์ตอบ 5xx / Timeout เกตเวย์จะส่งซ้ำอัตโนมัติ (Outbox Retry)

ขั้นตอนตั้งค่าบนเว็บคอนโซลนี้ (4 ขั้นตอน)

  1. เพิ่มบัญชีธนาคาร & สแกน QR LINE: ไปที่เมนู จัดการบัญชีเชื่อมต่อ กด + เพิ่มบัญชีเชื่อมต่อ เลือกธนาคารที่ต้องการ แล้วสแกน QR Code ด้วยแอป LINE บนมือถือ (หาก LINE ขอ PIN ให้กรอกรหัส PIN 4–6 หลักที่ขึ้นบนหน้าจอ)
  2. ระบุตัวกรองเลขบัญชี (ถ้ามีหลายบัญชีในแชทเดียว): กรอกเลขบัญชีหรือเลขท้าย 4 หลักในช่อง บัญชีรับเงินที่ต้องการกรอง เพื่อให้เกตเวย์ส่งต่อเฉพาะรายการที่ตรงกับบัญชีนั้น
  3. ผูก Webhook URL ของระบบคุณ: เปิดเมนู ตั้งค่า นำ Gateway URL และ Provider API Key ไปตั้งค่าในระบบของคุณ จากนั้นนำ Webhook URL ของคุณมากรอกในช่อง Primary Webhook Callback URL แล้วกด บันทึก และ ทดสอบยิง Ping
  4. ตรวจสอบหรือกระจายหลายระบบ: หากต้องการส่งแจ้งเตือนไปหลายเซิร์ฟเวอร์พร้อมกัน (เช่น ระบบหลัก + ระบบบัญชี) สามารถเพิ่มปลายทางแยกได้ในหัวข้อ Multi-Endpoint Routing และทดสอบยิงได้ในแท็บ Sandbox

ข้อกำหนดเฉพาะของ 4 ธนาคารที่รองรับ

SCB
SCB Connect (ธนาคารไทยพาณิชย์)

เพิ่มเพื่อน Official Account SCB Connect และผูกแจ้งเตือนเงินเข้า/ออกให้เรียบร้อย เกตเวย์จะแยกธนาคารต้นทาง + เลขท้ายบัญชี + ชื่อผู้โอนให้อัตโนมัติ

KTB
Krungthai Connext (ธนาคารกรุงไทย)

เพิ่มเพื่อน Krungthai Connext ข้อความแจ้งเตือนแบบใหม่ส่งมาครบทั้ง senderBank + เลขท้าย senderAccount และชื่อ senderName (จากบรรทัดผู้โอน) พร้อมแปลง พ.ศ. 2 หลักให้อัตโนมัติ

GSB
GSB NOW (ธนาคารออมสิน)

รองรับทั้งข้อความปกติและ Flex Card รูปภาพหัวการ์ด รองรับเลขบัญชีออมสิน 12 หลัก และแปลงรหัสธนาคาร 4 ตัวอักษร (เช่น BBLA → BBL, GSBA → GSB) อัตโนมัติ

KKP
KKP LINE CONNECT (ธนาคารเกียรตินาคินภัทร)

ข้อความ KKP Better ไม่มีเลขบัญชีผู้โอน (senderAccount: null) ระบบปลายทางควรจับคู่จาก senderName (ชื่อ-นามสกุลผู้โอน) แบบตรงตัวหลัง Normalize

ตัวเลือกเสริม: ติดตั้งส่วนขยาย Chrome Remote LINE Controller (3 ขั้นตอน)

  1. ดาวน์โหลดชุดส่วนขยาย: เปิดหน้าจอควบคุมบัญชีใดก็ได้ แล้วกดปุ่ม Chrome Extension จากนั้นกดดาวน์โหลดไฟล์ luminus-remote-line-controller.zip และแตกไฟล์ไว้ในเครื่อง
  2. โหลดเข้า Google Chrome (1 ครั้ง): เปิดหน้า chrome://extensions เปิดสวิตช์ Developer mode มุมขวาบน แล้วกด Load unpacked เลือกโฟลเดอร์ที่แตกไฟล์ไว้
  3. เชื่อมต่อด้วย Pairing Token: กด สร้างรหัส Pairing JSON จากหน้าจอควบคุม แล้วคลิกไอคอนส่วนขยายบน Chrome วาง JSON และกดเปิดหน้าต่างควบคุมได้ทันที (หรือเชื่อมต่อด้วย Gateway URL + API Key)

ข้อมูลที่เกตเวย์ส่งจริงแยกตาม 4 ธนาคารที่รองรับ (SCB / KTB / GSB / KKP)

ทุกธนาคารจะส่งฟิลด์หลักเหมือนกัน (event, eventId, fingerprint, bank, receiver.*, deposit.amount, deposit.transactedAt, rawMessage) แต่รายละเอียดผู้โอนต้นทางต่างกันตามข้อมูลที่ LINE ของแต่ละธนาคารส่งมา

4 SUPPORTED BANKS
ธนาคาร (bank) ช่องทาง LINE OA deposit.senderBank deposit.senderAccount deposit.senderName วิธีจับคู่ที่แนะนำฝั่งระบบคุณ
SCB SCB Connect ส่งจริง (KBANK, SCB...) ส่งจริง (xxx-4567) ส่งจริง (ชื่อ-นามสกุล) จับคู่ได้ทั้ง senderBank + เลขท้าย และ senderName
KTB Krungthai Connext ส่งจริง (KTB, KBANK...) ส่งจริง (XX8082 / xxx-x-x4567-x) ส่งจริง (จากบรรทัด "ผู้โอน") จับคู่ได้ทั้ง senderBank + เลขท้าย และ senderName (บางการ์ดแบบเก่าอาจไม่มีชื่อให้ใช้เลขบัญชีเป็นหลัก; แปลง พ.ศ. 2 หลักให้แล้ว)
GSB GSB NOW ส่งจริง (BBL, GSB, TTB...) ส่งจริง (0005XXXX7902) null (การ์ดรูปไม่มีชื่อ) จับคู่ด้วย senderBank + เลขท้าย senderAccount (แปลงรหัส 4 ตัว BBLA→BBL และบัญชีรับ 12 หลักให้แล้ว)
KKP KKP LINE CONNECT null null (ไม่มีเลขผู้โอน) ส่งจริง (ชื่อ-นามสกุล) ต้องจับคู่จาก deposit.senderName หลัง Normalize ชื่อ-นามสกุลเท่านั้น

ตัวอย่าง JSON Payload จริงแยกตามธนาคาร & สิ่งที่ต้องตอบกลับ

กดเลือกธนาคารหรือประเภทเหตุการณ์ด้านล่างเพื่อดู JSON Payload ที่เกตเวย์ยิงออกจริงทุกฟิลด์


          

คำอธิบายฟิลด์สำคัญใน JSON Payload

ชื่อฟิลด์ (JSON Path) ประเภท หน้าที่และวิธีนำไปใช้งาน
event string ประเภทเหตุการณ์: DEPOSIT_DETECTED, BALANCE_SYNC, PING, หรือ HEARTBEAT
eventId string รหัสอ้างอิงเหตุการณ์เฉพาะตัวจากเกตเวย์ ใช้เก็บ Trace Log
fingerprint string ลายนิ้วมือ SHA-256 64 หลัก (เฉพาะเงินเข้า) — ใช้เป็น Unique Key ใน DB เพื่อป้องกันปรับยอดซ้ำ
bank string รหัสธนาคารบัญชีรับเงิน: SCB, KTB, GSB, หรือ KKP
receiver.accountNumber / accountLast4 string เลขบัญชีรับเงินของเรา และเลขท้าย 4 หลัก (ใช้แมตช์กับบัญชีที่ตั้งรับในระบบคุณ)
deposit.amount number จำนวนเงินที่ได้รับเป็นตัวเลขทศนิยม (สกุลเงิน deposit.currency = "THB")
deposit.transactedAt ISO string วัน-เวลาที่เกิดรายการโอนจริง (UTC ISO-8601) ใช้เช็กอายุสลิปไม่ให้เกินกำหนด
deposit.senderBank / senderAccount / senderName string | null ข้อมูลบัญชีผู้โอนต้นทาง (หมายเหตุ: KKP ไม่มี senderBank/senderAccount, GSB Flex มักไม่มี senderName ส่วน KTB การ์ดใหม่มีครบทั้ง 3 ช่อง)
availableBalance number ยอดเงินคงเหลือล่าสุดของบัญชี (ส่งมาใน BALANCE_SYNC เมื่อมีเงินออก/ถอน — ใช้ปรับยอดคงเหลือเท่านั้น ห้ามเติมเครดิต)
rawMessage string ข้อความแจ้งเตือนต้นฉบับจากธนาคาร (มักมีข้อความระบุยอดคงเหลืออยู่ด้วย)

สถานะการตอบกลับจากเซิร์ฟเวอร์ของคุณ (Response Contract)

เมื่อเซิร์ฟเวอร์ของคุณรับ Webhook แล้ว ควรตอบกลับเป็น JSON ภายใน 10 วินาทีตามมาตรฐานนี้:

HTTP Status JSON status ผลลัพธ์บนเกตเวย์
200 OK "COMPLETED" ส่งสำเร็จ + นับว่าปลายทางประมวลผล/เติมยอดเรียบร้อยแล้ว (หยุดส่งซ้ำ)
200 OK "PENDING_REVIEW" ส่งถึงปลายทางสำเร็จ + นับสถานะ "รอตรวจสอบ" บนหน้าบัญชี (หยุดส่งซ้ำ)
200 OK "IGNORED" ปลายทางรับทราบและไม่ทำรายการซ้ำ เช่น เจอ fingerprint ซ้ำ หรือเป็น BALANCE_SYNC
401 / 408 / 429 / 5xx — / Timeout เกตเวย์จะนำเข้า Outbox Queue และยิงซ้ำอัตโนมัติสูงสุด 6 รอบ (5s → 15s → 45s → 2m → 5m → 15m)
400 / 404 Bad Request บันทึกเป็น FAILED (ไม่ Retry อัตโนมัติ แต่ผู้ดูแลกดส่งซ้ำจากหน้าประวัติได้)

มาตรฐาน HTTP Headers & สูตรตรวจลายมือชื่อ (HMAC-SHA256)

ทุกคำขอ Webhook ที่ส่งออกจากเกตเวย์จะแนบ Headers เหล่านี้ เพื่อให้ฝั่งคุณตรวจสอบความถูกต้องและป้องกันการยิงซ้ำได้ 100%

POST /webhooks/bank-connector HTTP/1.1
Content-Type: application/json
X-Connector-Timestamp: 1763195400000
X-Connector-Signature: 8f4d9c01e3a5...  // HMAC_SHA256(PROVIDER_API_KEY, `${X-Connector-Timestamp}.${rawBody}`) เป็น Hex 64 หลัก
X-Connector-Event: DEPOSIT_DETECTED      // DEPOSIT_DETECTED | BALANCE_SYNC | PING | HEARTBEAT
X-Connector-Delivery-Id: dlv_9a1b2c3d4e5f6789
Idempotency-Key: 1f8b868a88390b2fbe8e9833501a34d8efbc5bfa22f183918a0e2a2cfa029f60
X-Connector-Version: 3.0.0

          

REST API Endpoints มาตรฐาน (สำหรับการดึงข้อมูลแบบ Pull & จัดการภายนอก)

เรียกใช้งานกับ Gateway Base URL โดยส่ง Header Authorization: Bearer <PROVIDER_API_KEY>

Method Endpoint การยืนยันตัวตน คำอธิบาย
GET /api/v1/health Public / Bearer ตรวจสอบสถานะเกตเวย์, จำนวนบัญชีธนาคารที่ออนไลน์จริง และตัวเลขสรุปรายวัน
GET /api/v1/accounts Bearer <API_KEY> ดึงรายชื่อบัญชีธนาคารที่เชื่อมต่อ สถานะ LINE และสถิติรับ-ส่งของแต่ละบัญชี
GET /api/v1/transactions Bearer <API_KEY> ดึงประวัติรายการเงินเข้าย้อนหลัง รองรับตัวกรอง bank, accountId, status, q, from, since, to, minAmount, highValueOnly, limit, offset
GET /api/v1/transactions/:eventId Bearer <API_KEY> ดึงรายละเอียดธุรกรรมรายการเดียว พร้อมตัวอย่าง Webhook Payload ของรายการนั้น
POST /api/v1/transactions/:eventId/replay Bearer <API_KEY> สั่งยิง Webhook ซ้ำด้วย eventId และ fingerprint เดิม (Idempotent)
POST /api/v1/pairing One-Time Code แลกรหัสจับคู่ 12 หลักเป็น Webhook URL และ Secret Key แบบใช้ครั้งเดียว

API Sandbox (โหมดจำลองแยกจากประวัติจริง)

ทดสอบการตรวจสอบลายเซ็น HMAC-SHA256 และความเร็วตอบกลับของเซิร์ฟเวอร์ปลายทาง โดยไม่สร้างข้อมูลปลอมปะปนในหน้าประวัติยอดเข้า

ISOLATED SANDBOX

ผลลัพธ์จากเซิร์ฟเวอร์ปลายทาง

แสดง HTTP Status, Latency และ JSON Response สด

รอการทดสอบ
// กดปุ่ม "ส่งสัญญาณทดสอบ" เพื่อดูผลลัพธ์การตอบกลับจากเซิร์ฟเวอร์ปลายทาง