Cài đặt
Cấu hình ngân hàng, Telegram bot, logic đối soát.
Ngân hàng
Telegram bot
Đối soát
Bank webhook

Tài khoản ngân hàng nhận

Thêm tài khoản để sinh VietQR tự động.
Ngân hàngSố TKChủ tài khoảnBINTrạng thái
Đang tải…

Telegram bot

Cho phép khách đặt hàng qua Telegram: /shop, /buy <SKU>, /status. Sau khi lưu token, bấm "Kiểm tra" và "Set webhook" để gắn bot vào hệ thống này.

Gắn webhook cho bot

Khi server của bạn public (VD qua ngrok/Cloudflare Tunnel), dán URL gốc vào đây. Telegram sẽ gửi tin nhắn đến /api/webhooks/telegram/<workspaceId>.

Logic đối soát

Nếu tiền thực nhận lệch ≤ giá trị này so với đơn, hệ thống vẫn coi là khớp.

Bank webhook endpoint

Dịch vụ biến động số dư (VD: Sacombank-webhook, Casso, vietcombank-webhook) sẽ POST JSON tới URL dưới. Token bảo mật đọc từ biến môi trường BANK_WEBHOOK_TOKEN.

Body JSON (mẫu)

{
  "bank_account_id": 1,
  "bank_tx_id": "FT2504240001",
  "amount": 95000,
  "content": "KHACH CK DON HANG ODR-260425-KSEEDZ",
  "direction": "credit"
}

Hoặc có thể gửi nguyên email biến động số dư qua trường email_raw — hệ thống sẽ tự parse số tiền, nội dung, mã giao dịch.