Luminus Connector
Enterprise Gateway v3.0
REAL-TIME TELEMETRY • ASIA/BANGKOK

แดชบอร์ดภาพรวมเกตเวย์

ติดตามสถานะบัญชีเชื่อมต่อ LINE ธนาคาร ความเร็วการส่งต่อ Webhook และรายการเงินเข้าแบบเรียลไทม์

บัญชีเชื่อมต่อออนไลน์
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 รายละเอียด
ยังไม่มีรายการเงินเข้าในระบบ
PERSISTENT CLOUD LINE WORKERS

จัดการบัญชีเชื่อมต่อ

เพิ่มเฉพาะบัญชีธนาคารที่ต้องการใช้งานจริง สแกน QR Code บนหน้าเว็บ และสำรองเซสชันอัตโนมัติในฐานข้อมูล

IDEMPOTENT DEPOSIT LEDGER

ประวัติยอดเข้า

ตรวจสอบรายการเงินเข้าทุกธนาคาร ลายนิ้วมือ SHA-256 ความเร็วตอบกลับของปลายทาง และสั่งส่งซ้ำอย่างปลอดภัย

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

ตั้งค่าระบบเกตเวย์

ทุกค่าที่บันทึกถูกจัดเก็บลงฐานข้อมูลถาวร คีย์และ URL จะไม่ถูกรีเซ็ตหรือสูญหายเมื่อรีสตาร์ทเซิร์ฟเวอร์

การเชื่อมต่อมาตรฐาน 3 ขั้นตอน (Luminus Admin 7.1 & 3rd-Party)

คัดลอก Endpoint (ขั้นที่ 1) และ API Key (ขั้นที่ 2) ไปวางที่ระบบหลังบ้านลูกค้า และนำลิงก์ Callback มาวางในขั้นที่ 3

PERSISTENT KEY
ขั้นตอนที่ 1 • นำไปวางฝั่งลูกค้า

Provider Endpoint URL

URL หลักของเกตเวย์นี้สำหรับตรวจสอบสถานะและดึงข้อมูล

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

Provider API Key (HMAC Secret)

ใช้ยืนยันตัวตน Bearer Token และตรวจลายเซ็น HMAC-SHA256

ขั้นตอนที่ 3 • ลิงก์รับยอดเงินเข้า

Primary Webhook Callback URL

เช่น https://api-tenant.luminusauto.com/api/notify/universal

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

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

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

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

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

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

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

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

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

DEVELOPER SPECIFICATION & SANDBOX

คู่มือการเชื่อมต่อ & ทดสอบ API

มาตรฐานการรับส่งข้อมูลระดับสากล การตั้งค่าห้องแชทธนาคาร และการจำลองยิงสัญญาณแยกจากประวัติยอดจริง

ขั้นตอนการผูกกับหลังบ้าน Luminus Auto (เมนู 7.1)

  1. คัดลอก Provider Endpoint & API Key: เปิดเมนู ตั้งค่า ในคอนโซลนี้ คัดลอก Provider Endpoint URL และ Provider API Key ไปวางในหน้าแอดมินเมนู 7.1 จัดการบัญชีธนาคาร (Universal Bank Connector) แล้วกดบันทึก
  2. วาง Callback URL กลับมาที่คอนโซล: คัดลอกลิงก์ Our Webhook จากหน้า 7.1 (เช่น https://api-brand.luminusauto.com/api/notify/universal) มาวางในช่อง Primary Webhook Callback URL ในหน้าตั้งค่า แล้วกดบันทึกและทดสอบ Ping
  3. เพิ่มบัญชีเชื่อมต่อและสแกน QR Code: ไปที่เมนู จัดการบัญชีเชื่อมต่อ กดปุ่ม + เพิ่มบัญชีเชื่อมต่อ เลือกธนาคารที่ต้องการใช้งาน แล้วสแกน QR Code ด้วยแอป LINE บนมือถือ (หาก LINE ขอ PIN ให้กรอกรหัส PIN 4–6 หลักที่ปรากฏบนหน้าจอ)
  4. เปิดสวิตช์รับยอดออโต้รายบัญชี: ในหน้าจัดการบัญชีฝากของแอดมิน เปิดสวิตช์ รับยอดอัตโนมัติผ่าน SCB Connect / Krungthai Connext / GSB NOW / KKP ให้ตรงกับเลขบัญชีที่เปิดรับ

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

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

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

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

เพิ่มเพื่อน Krungthai Connext ข้อความของกรุงไทยไม่มีชื่อผู้โอน ระบบจะจับคู่จากรหัสธนาคารต้นทาง + เลขท้าย 4 หลักอย่างรัดกุม

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

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

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

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

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

ทุกคำขอ Webhook ที่ส่งออกจากระบบแนบลายเซ็นดิจิทัลและ Idempotency Key เพื่อป้องกันการปลอมแปลงและการปรับยอดซ้ำ 100%

POST /your-webhook-endpoint HTTP/1.1
Content-Type: application/json
X-Connector-Timestamp: 1762520000000
X-Connector-Signature: 8f4d9c01e3a5... (HMAC-SHA256 Hex 64 chars of `${timestamp}.${rawBody}`)
X-Connector-Event: DEPOSIT_DETECTED
X-Connector-Delivery-Id: dlv_9a1b2c3d4e5f6789
Idempotency-Key: 1f8b868a88390b2fbe8e9833501a34d8efbc5bfa22f183918a0e2a2cfa029f60

          


          

            
REST API Endpoints มาตรฐาน (External Integration)

            

              

                
                  

                    Method
                    Endpoint
                    การยืนยันตัวตน
                    คำอธิบาย
                  

                
                
                  

                    GET
                    /api/v1/health
                    Public / Bearer
                    ตรวจสอบสถานะเกตเวย์และจำนวนบัญชีธนาคารที่ออนไลน์จริง
                  

                  

                    GET
                    /api/v1/transactions
                    Bearer <API_KEY>
                    ดึงประวัติรายการเงินเข้าย้อนหลัง รองรับตัวกรอง bank, status, since, limit, offset
                  

                  

                    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 สด

                

                รอการทดสอบ
              

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