แดชบอร์ดภาพรวมเกตเวย์
ติดตามสถานะบัญชีเชื่อมต่อ LINE ธนาคาร ความเร็วการส่งต่อ Webhook และรายการเงินเข้าแบบเรียลไทม์
ปริมาณรายการเงินเข้าย้อนหลัง 12 ชั่วโมง
คำนวณจากธุรกรรมจริงที่ตรวจพบในระบบ (ไม่รวมรายการทดสอบ Sandbox)
ความพร้อมของระบบเกตเวย์
สถานะโครงสร้างพื้นฐานและการผูก Webhook ปลายทาง
สถานะบัญชีธนาคารที่เชื่อมต่อ
แสดงเฉพาะบัญชีที่คุณเพิ่มไว้ในระบบจริง ไม่มีบัญชีจำลอง
รายการเงินเข้าล่าสุด (Live Stream)
อัปเดตทันทีผ่าน WebSocket เมื่อมีข้อความแจ้งเตือนเงินเข้าจากธนาคาร
| เวลาที่ตรวจพบ | ธนาคาร / บัญชี | จำนวนเงิน | ข้อมูลผู้โอน | สถานะส่ง Webhook | รายละเอียด |
|---|---|---|---|---|---|
| ยังไม่มีรายการเงินเข้าในระบบ | |||||
จัดการบัญชีเชื่อมต่อ
เพิ่มเฉพาะบัญชีธนาคารที่ต้องการใช้งานจริง สแกน QR Code บนหน้าเว็บ และสำรองเซสชันอัตโนมัติในฐานข้อมูล
ประวัติยอดเข้า
ตรวจสอบรายการเงินเข้าทุกธนาคาร ลายนิ้วมือ SHA-256 ความเร็วตอบกลับของปลายทาง และสั่งส่งซ้ำอย่างปลอดภัย
| วัน-เวลา (ไทย) | ธนาคาร / บัญชี | ยอดเงินเข้า | ผู้โอนต้นทาง | บัญชีรับเงิน | ผลส่งต่อ Webhook | จัดการ |
|---|---|---|---|---|---|---|
| ยังไม่มีประวัติรายการเงินเข้า | ||||||
ตั้งค่าระบบเกตเวย์
ทุกค่าที่บันทึกถูกจัดเก็บลงฐานข้อมูลถาวร คีย์และ URL จะไม่ถูกรีเซ็ตหรือสูญหายเมื่อรีสตาร์ทเซิร์ฟเวอร์
ขั้นตอนการเชื่อมต่อกับระบบของคุณ (3 ขั้นตอนง่ายๆ)
คัดลอก Gateway URL (ขั้นที่ 1) และ API Key (ขั้นที่ 2) ไปใช้ยืนยันตัวตนในระบบของคุณ จากนั้นวางลิงก์รับแจ้งเตือนของคุณในขั้นที่ 3
Gateway Endpoint URL
URL หลักของเกตเวย์นี้สำหรับเรียก REST API, ดึงรายการย้อนหลัง หรือเช็กสถานะ
Provider API Key (HMAC Secret)
ใช้ส่ง Bearer Token และตรวจลายเซ็น HMAC-SHA256 ฝั่งเซิร์ฟเวอร์ของคุณ
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
คู่มือการเชื่อมต่อระบบ & ทดสอบ API
ออกแบบเป็นกลางสำหรับเชื่อมกับทุกเว็บไซต์, E-Commerce, ERP หรือ Backend ของคุณเอง — ดูง่าย ทำตามได้ทันทีทั้ง Webhook และ REST API
เลือกรูปแบบการเชื่อมต่อที่เหมาะกับระบบของคุณ (รองรับ 2 วิธี)
ระบบนี้ทำหน้าที่เป็นตัวกลางอ่านแจ้งเตือนธนาคารจาก LINE OA แล้วส่งต่อข้อมูลเป็น JSON มาตรฐานไปยังระบบใดก็ได้
แบบที่ 1: รับแจ้งเตือนอัตโนมัติ (Webhook Push)
ทันทีที่มีเงินเข้า หรือยอดเงินคงเหลือของบัญชีเปลี่ยนแปลง เกตเวย์จะส่ง HTTP POST พร้อม JSON Payload และลายเซ็น HMAC-SHA256 ไปยัง URL ของระบบคุณทันที
- ไม่ต้องยิงถามเซิร์ฟเวอร์ซ้ำๆ (Real-time ในไม่กี่วินาที)
- รองรับการ Retry อัตโนมัติ 6 รอบหากเซิร์ฟเวอร์คุณล่มชั่วคราว
- เหมาะกับระบบเติมเงิน, E-Commerce, แจ้งเตือนสั่งซื้อ, หรือบัญชีอัตโนมัติ
แบบที่ 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)
สร้าง Endpoint POST 1 เส้น
สร้าง API URL บนเซิร์ฟเวอร์ของคุณ เช่น POST https://api.yourdomain.com/webhooks/bank-connector เพื่อรับ Content-Type: application/json
ตรวจสอบลายเซ็น HMAC-SHA256
ตรวจ Header X-Connector-Timestamp และ X-Connector-Signature ด้วยสูตร HMAC_SHA256(API_KEY, timestamp + "." + rawBody)
timingSafeEqual เพื่อยืนยันว่าข้อมูลมาจากเกตเวย์จริงแยกตาม event & กันซ้ำด้วย fingerprint
• DEPOSIT_DETECTED = เงินเข้า: อ่านยอดจาก deposit.amount และเก็บ fingerprint เป็น Unique Key ห้ามเติมซ้ำ
• BALANCE_SYNC = เงินออก/ถอน: อัปเดต availableBalance เท่านั้น ห้ามบวกเครดิต
• PING / HEARTBEAT = เช็กการเชื่อมต่อ ให้ตอบ 200 OK
ตอบกลับ HTTP 200 OK (JSON)
ตอบกลับภายใน 10 วินาที เช่น {"success": true, "status": "COMPLETED"} หรือ "PENDING_REVIEW" / "IGNORED"
5xx / Timeout เกตเวย์จะส่งซ้ำอัตโนมัติ (Outbox Retry)ขั้นตอนตั้งค่าบนเว็บคอนโซลนี้ (4 ขั้นตอน)
- เพิ่มบัญชีธนาคาร & สแกน QR LINE: ไปที่เมนู จัดการบัญชีเชื่อมต่อ กด + เพิ่มบัญชีเชื่อมต่อ เลือกธนาคารที่ต้องการ แล้วสแกน QR Code ด้วยแอป LINE บนมือถือ (หาก LINE ขอ PIN ให้กรอกรหัส PIN 4–6 หลักที่ขึ้นบนหน้าจอ)
- ระบุตัวกรองเลขบัญชี (ถ้ามีหลายบัญชีในแชทเดียว): กรอกเลขบัญชีหรือเลขท้าย 4 หลักในช่อง บัญชีรับเงินที่ต้องการกรอง เพื่อให้เกตเวย์ส่งต่อเฉพาะรายการที่ตรงกับบัญชีนั้น
-
ผูก Webhook URL ของระบบคุณ:
เปิดเมนู ตั้งค่า นำ
Gateway URLและProvider API Keyไปตั้งค่าในระบบของคุณ จากนั้นนำ Webhook URL ของคุณมากรอกในช่องPrimary Webhook Callback URLแล้วกด บันทึก และ ทดสอบยิง Ping - ตรวจสอบหรือกระจายหลายระบบ: หากต้องการส่งแจ้งเตือนไปหลายเซิร์ฟเวอร์พร้อมกัน (เช่น ระบบหลัก + ระบบบัญชี) สามารถเพิ่มปลายทางแยกได้ในหัวข้อ Multi-Endpoint Routing และทดสอบยิงได้ในแท็บ Sandbox
ข้อกำหนดเฉพาะของ 4 ธนาคารที่รองรับ
เพิ่มเพื่อน Official Account SCB Connect และผูกแจ้งเตือนเงินเข้า/ออกให้เรียบร้อย เกตเวย์จะแยกธนาคารต้นทาง + เลขท้ายบัญชี + ชื่อผู้โอนให้อัตโนมัติ
เพิ่มเพื่อน Krungthai Connext ข้อความแจ้งเตือนของกรุงไทยไม่มีชื่อผู้โอน ระบบของคุณควรจับคู่จาก senderBank + เลขท้าย senderAccount และยอดเงิน
รองรับทั้งข้อความปกติและ Flex Card รูปภาพหัวการ์ด รองรับเลขบัญชีออมสิน 12 หลัก และแปลงรหัสธนาคาร 4 ตัวอักษร (เช่น BBLA → BBL, GSBA → GSB) อัตโนมัติ
ข้อความ KKP Better ไม่มีเลขบัญชีผู้โอน (senderAccount: null) ระบบปลายทางควรจับคู่จาก senderName (ชื่อ-นามสกุลผู้โอน) แบบตรงตัวหลัง Normalize
ตัวเลือกเสริม: ติดตั้งส่วนขยาย Chrome Remote LINE Controller (3 ขั้นตอน)
-
ดาวน์โหลดชุดส่วนขยาย:
เปิดหน้าจอควบคุมบัญชีใดก็ได้ แล้วกดปุ่ม Chrome Extension จากนั้นกดดาวน์โหลดไฟล์
luminus-remote-line-controller.zipและแตกไฟล์ไว้ในเครื่อง -
โหลดเข้า Google Chrome (1 ครั้ง):
เปิดหน้า
chrome://extensionsเปิดสวิตช์ Developer mode มุมขวาบน แล้วกด Load unpacked เลือกโฟลเดอร์ที่แตกไฟล์ไว้ - เชื่อมต่อด้วย Pairing Token: กด สร้างรหัส Pairing JSON จากหน้าจอควบคุม แล้วคลิกไอคอนส่วนขยายบน Chrome วาง JSON และกดเปิดหน้าต่างควบคุมได้ทันที (หรือเชื่อมต่อด้วย Gateway URL + API Key)
ตัวอย่าง JSON Payload ที่เกตเวย์ส่งออก & JSON ที่คุณต้องตอบกลับ
กดสลับแท็บด้านล่างเพื่อดูโครงสร้าง JSON จริงของแต่ละเหตุการณ์ พร้อมปุ่มคัดลอกไปใช้อ้างอิง
คำอธิบายฟิลด์สำคัญใน 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 ไม่มีเลขบัญชีผู้โอน, KTB ไม่มีชื่อผู้โอน) |
| 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 และความเร็วตอบกลับของเซิร์ฟเวอร์ปลายทาง โดยไม่สร้างข้อมูลปลอมปะปนในหน้าประวัติยอดเข้า
ผลลัพธ์จากเซิร์ฟเวอร์ปลายทาง
แสดง HTTP Status, Latency และ JSON Response สด
// กดปุ่ม "ส่งสัญญาณทดสอบ" เพื่อดูผลลัพธ์การตอบกลับจากเซิร์ฟเวอร์ปลายทาง