Đại lý chỉ giám sát — hệ thống tự chạy

Vào trang Đăng ký → tạo tài khoản (email + mật khẩu) → tự push qua /welcome wizard.

Wizard hướng dẫn 4 bước nhỏ:

• TK nhận tiền: chọn NH + nhập STK của đại lý. Đây là nơi Khách hàng chuyển vào, SePay sẽ đọc webhook.
• Telegram của đại lý: nhận cảnh báo ngoại lệ + báo cáo tháng.
• Nhập danh sách Khách hàng: Excel hoặc thêm tay.

Vào Hệ thống → Nhập dữ liệu. Upload file Excel hiện tại bạn đang dùng quản lý chu kỳ thẻ.

Hệ thống tự đọc các cột tiếng Việt phổ biến:

• Tên, Số thẻ, Thẻ (NH), Tiền quẹt (hạn mức), Phí %, SĐT/Zalo, Telegram…
• Smart-detect đơn vị triệu/nghìn/đồng theo công thức (Tiền quẹt × Phí% = Tiền phí).
• Thẻ có số sai (Luhn fail) → vẫn import, đánh dấu "cần xác minh" để bạn sửa sau.

Có nút "Hoàn tác" trong 24h — sai gì xóa sạch về 0 trong 1 chạm.

Đây là khúc quan trọng nhất. Bot KHÔNG được Telegram cho phép nhắn Khách hàng trước — Khách hàng phải tự bấm /start 1 lần để link tài khoản.

Vào Quản lý → Onboard Telegram. Hệ thống sinh sẵn link bot riêng cho mỗi Khách hàng + tin nhắn mời.

• Chế độ "Queue": 1 Khách hàng/lần → click "Copy + Mở Zalo" → paste vào Zalo của khách → gửi → tick "Đã gửi → tiếp".
• 100 Khách hàng = ~10 phút, không phải cả buổi sáng.
• Khách hàng bấm link bot → /start → tự động link, lần sau bot nhắn được ngay.

💡 Tip: dùng Zalo này khoảng 2 tuần để Khách hàng chuyển dần. Sau đó Telegram chủ đạo, Zalo chỉ là kênh dự phòng.

Mỗi ngày 9h sáng cron quét tất cả thẻ. Thẻ nào còn 3/2/1 ngày đến hạn (theo bảng BankCycle) → bot tự gửi tin nhắn kèm mã QR cho Khách hàng.

QR khóa cứng:

• Amount = đúng số tiền cần trả.
• Memo = mã CYC-XXXX duy nhất cho lần thanh toán này.
• STK đích = tài khoản đại lý.
• App NH của Khách hàng pre-fill toàn bộ, Khách hàng chỉ xác nhận và OK.

Khách hàng chuyển khoản → SePay webhook nhận → khớp memo → bot gửi tin xác nhận với giọng "người":"Đã nhận đủ 69.780.000đ — Cảm ơn bạn 💚"

✓ Trong tháng đầu chạy thật, ~80% chu kỳ hoàn tất tự động không cần Đại lý can thiệp.

Khi có lệch lạc (Khách hàng chuyển thiếu/dư, Khách hàng không phản hồi, SePay không khớp), hệ thống tạo "hồ sơ ngoại lệ" → bạn vào Quản lý → Hồ sơ ngoại lệ xử lý.

Bot ứng xử theo tình huống:

• Thiếu rõ ràng: bot tự nhắn Khách hàng "còn thiếu X, chuyển bù nhé".
• Dư rõ ràng: bot xác nhận + note "trừ vào kỳ sau".
• Phức tạp/nghi vấn: bot im lặng, alert dashboard cho Đại lý gọi trực tiếp.

Mỗi hồ sơ có nút "✓ Duyệt" (ghi đè COMPLETED) hoặc "Hủy" + link gọi/Zalo Khách hàng ngay.

Trang Tổng quan hiện 3 KPI sống còn:

• Tổng quy mô tham chiếu = tổng mức tham chiếu thẻ ACTIVE.
• Vòng quay vốn = doanh số tháng / vốn (lý tưởng 10-15×).
• ROI vốn/tháng = lợi nhuận ròng / vốn (lý tưởng 4-7%).

Trang Báo cáo: biểu đồ doanh số theo ngày, top khách, phân tích theo kênh POS, xuất Excel.

Trang Hóa đơn: hiển thị live rate đang áp (Founding 10 0,107% hay bậc thang), phí ước tính tháng này.

Sổ thẻ: số thẻ mã hóa AES-256-GCM, không lưu CVV (chuẩn PCI). Mỗi lần xem PAN bị audit log đầy đủ.

Khách hàng không tham gia hệ thống: chỉ trò chuyện với bot @cardmanageruk_bot — không có tài khoản web, không lộ dữ liệu sang bên thứ ba.

Hệ thống không cầm tiền: dòng tiền đi thẳng từ Khách hàng vào TK đại lý. Phí phần mềm CardManager xuất hóa đơn riêng, chuyển khoản thường. Vì vậy CardManager là công cụ quản lý, không phải trung gian thanh toán → không cần giấy phép NHNN.