Hướng dẫn cài đặt phương thức nhận tiền cho shop trên BotKami.
Truy cập
- Đăng nhập Dashboard tại
botkami.com/dashboard - Vào mục Thanh toán (menu trái) hoặc truy cập
/dashboard/payments
Lưu ý: Cấu hình thanh toán áp dụng cho tất cả shop của bạn.
2 phương thức thanh toán
BotKami hỗ trợ 2 phương thức nhận tiền:
| Phương thức | Xác nhận đơn | Giao hàng | Phù hợp |
|-------------|-------------|-----------|---------|
| 🏦 Thủ công (Manual) | Tự kiểm tra + xác nhận | Tự động sau khi xác nhận | Mới bắt đầu, ít đơn |
| ⚡ Tự động (SePay) | Tự động qua webhook | Tự động ngay lập tức | Nhiều đơn, 24/7 |
Phương thức 1: Thanh toán thủ công
Cách hoạt động
- Khách bấm mua → Bot gửi mã QR VietQR kèm thông tin chuyển khoản
- Khách quét QR hoặc chuyển khoản thủ công
- Bạn tự kiểm tra ngân hàng → Vào Dashboard → Xác nhận đơn hàng
- Hệ thống tự giao hàng cho khách
Cấu hình
Trong tab Thủ công, điền 3 trường:
| Trường | Mô tả | Ví dụ |
|--------|-------|-------|
| Ngân hàng | Chọn ngân hàng nhận tiền | MBBank, Vietcombank... |
| Số tài khoản | Số tài khoản ngân hàng | 1029384756 |
| Tên chủ tài khoản | Tên in trên sổ TK (viết HOA) | NGUYEN VAN A |
Khi nhập xong, hệ thống tự hiển thị mã QR xem trước bên phải.
Trải nghiệm khách hàng trên Telegram
Khi khách đặt hàng, bot gửi ảnh QR kèm thông tin:
✅ Đơn hàng đã tạo thành công!
Sản phẩm : Windows 11 Pro Key x1
Tổng tiền: 150.000đ
Mã đơn : #42
Thông tin chuyển khoản
Ngân hàng : MBBank
Số TK : 1029384756
Chủ TK : NGUYEN VAN A
Số tiền : 150.000đ
Nội dung : KM8A2B3C4D
Quét mã QR hoặc chuyển khoản theo thông tin trên.
⏳ Người bán sẽ xác nhận thủ công sau khi kiểm tra.
Xác nhận đơn hàng
- Kiểm tra tiền đã vào tài khoản ngân hàng
- Vào Dashboard → Đơn hàng → Tìm đơn theo mã
- Bấm Xác nhận → Hệ thống tự giao key/file cho khách qua bot
Phương thức 2: Thanh toán tự động (SePay)
SePay là gì?
SePay (my.sepay.vn) là dịch vụ tự động hóa ngân hàng. Khi có giao dịch vào tài khoản, SePay gọi webhook thông báo cho BotKami → hệ thống tự khớp đơn → tự giao hàng.
Cách hoạt động
Khách mua → Bot gửi QR → Khách chuyển tiền
↓
SePay nhận tiền
↓
SePay gọi webhook BotKami
↓
Server khớp mã đơn trong nội dung CK
↓
Tự xác nhận + giao hàng
↓
Bot gửi key/file cho khách ✅Cấu hình — 4 bước
#### Bước 1: Đăng ký SePay
- Truy cập my.sepay.vn và đăng ký tài khoản
- Kết nối tài khoản ngân hàng với SePay
Trong tab Tự động (SePay), điền:
| Trường | Mô tả |
|--------|-------|
| Ngân hàng | Ngân hàng đã kết nối SePay |
| Số tài khoản | Số TK đã đăng ký trên SePay |
Bấm Lưu cấu hình → Hệ thống tự tạo API Key.
#### Bước 3: Cấu hình Webhook trên SePay
Vào SePay Dashboard → Webhook, cần cấu hình 2 thứ:
1. Webhook URL:
Sao chép URL từ BotKami Dashboard và dán vào SePay:
code
https://api.botkami.com/api/webhooks/sepay2. API Key:
Sao chép API Key từ BotKami Dashboard và dán vào SePay → trường API Key. SePay sẽ gửi key này trong mỗi request webhook để xác thực.
#### Bước 4: Bật tự động duyệt
Toggle Tự động duyệt đơn hàng → ON
Khi bật, hệ thống tự xác nhận và giao hàng ngay khi nhận webhook từ SePay.
Trải nghiệm khách hàng
Tương tự thanh toán thủ công, nhưng thay vì chờ người bán:
✅ Đơn hàng đã tạo thành công!
...
Quét mã QR hoặc chuyển khoản theo thông tin trên.
Sản phẩm sẽ được gửi tự động sau khi thanh toán.Sau khi khách chuyển tiền, trong vài giây bot tự gửi:
🎉 Thanh toán thành công!
🆔 Mã đơn: #42
💰 Tổng tiền: 150.000đ
📦 Windows 11 Pro Key x1
📋 XXXX-YYYY-ZZZZ-1111
Cảm ơn bạn đã mua hàng! 🙏
API Key — Bảo mật
- API Key được tự động tạo khi bạn lưu cấu hình SePay lần đầu
- Dùng để xác thực webhook giữa SePay và BotKami
- Bạn có thể tạo lại key mới bất kỳ lúc nào (key cũ sẽ ngừng hoạt động)
- Sau khi tạo key mới, nhớ cập nhật lại trên SePay
Ngân hàng hỗ trợ
BotKami hỗ trợ 25+ ngân hàng qua chuẩn VietQR:
| Ngân hàng | | Ngân hàng |
|-----------|--|-----------|
| MBBank | | ACB |
| Vietcombank | | TPBank |
| VietinBank | | VPBank |
| Techcombank | | Agribank |
| BIDV | | Sacombank |
| HDBank | | SHB |
| OCB | | MSB |
| SeABank | | VIB |
| Eximbank | | LienVietPostBank |
So sánh 2 phương thức
| | Thủ công | SePay |
|---|---------|-------|
| Chi phí | Miễn phí | Tùy gói SePay |
| Tốc độ xác nhận | Phụ thuộc người bán | Vài giây |
| Giao hàng | Sau khi xác nhận | Tự động ngay |
| Phù hợp | Ít đơn, test thử | Bán chuyên nghiệp |
| Thiết lập | Đơn giản | Cần đăng ký SePay |