SOP-MD-05 | Thiết Lập Thanh Toán SePay
Áp dụng cho: Admin vai trò MD tại
md.khotot.vn
Phiên bản: v1.0 | Ngày tạo: 31/03/2026
Nguồn: Tổng hợp từ UAT kiểm thử thực tế
🎯 Mục đích
Hướng dẫn MD liên kết tài khoản ngân hàng với cổng thanh toán SePay để nhận thanh toán QR từ khách hàng SD.
📌 Thông tin truy cập
- URL:
https://md.khotot.vn/app/administration/payment-configs - Sidebar: HỆ THỐNG → Thiết lập thanh toán
- Cổng thanh toán: SePay (tích hợp sẵn)
- Ngân hàng hỗ trợ: ACB | MB Bank
🔄 LUỒNG: Liên Kết Tài Khoản Ngân Hàng
flowchart TD
A([▶ Bắt đầu]) --> B[Vào HỆ THỐNG → Thiết lập thanh toán]
B --> C[Trang 'Liên kết Tài khoản Ngân hàng' hiển thị\nKết nối với cổng SePay]
C --> D[BƯỚC 1: Thiết lập thông tin tài khoản]
D --> E{Chọn ngân hàng}
E -- ACB --> F1[Chọn ACB\nNgân hàng TMCP Á Châu]
E -- MB Bank --> F2[Chọn MB Bank\nNgân hàng TMCP Quân Đội]
F1 & F2 --> G[Điền Tên chủ tài khoản\nViết hoa, không dấu\nVD: NGUYEN VAN A]
G --> H[Điền Số tài khoản ngân hàng]
H --> I[Điền Số CMND/CCCD của chủ TK]
I --> J[Điền Số điện thoại đăng ký với ngân hàng]
J --> K{Kiểm tra lại thông tin}
K -- Sai --> G
K -- Đúng --> L[Nhấn 'Xác thực tài khoản liên kết']
L --> M[BƯỚC 2: Xác thực tài khoản]
M --> N[SePay gửi OTP về SĐT\nđăng ký ngân hàng]
N --> O[Nhập mã OTP]
O --> P{OTP hợp lệ?}
P -- Không --> Q[⚠️ Yêu cầu gửi lại OTP]
Q --> N
P -- Có --> R[Tài khoản ngân hàng\nliên kết thành công với SePay]
R --> S[SD thanh toán QR → Tiền về\ntài khoản ngân hàng MD]
S --> T([✅ Hoàn tất])📋 Luồng Thanh Toán End-to-End (SD → MD)
flowchart LR
A[SD đặt hàng\ntrên khotot.vn] --> B[Checkout\nchọn QR Ngân Hàng]
B --> C[Hệ thống hiển thị\nQR SePay]
C --> D[SD quét QR\nbằng app ngân hàng]
D --> E[Tiền chuyển vào\nTK ngân hàng MD]
E --> F[SePay xác nhận\nthanh toán thành công]
F --> G[Đơn hàng MD\ncập nhật 'Đã thanh toán']
G --> H[MD xử lý đơn\nvà giao hàng]📋 Thông Tin Cần Chuẩn Bị
| Thông tin | Yêu cầu | Ghi chú |
|---|---|---|
| Tên chủ TK | Viết hoa, không dấu | Đúng như tên trên thẻ ngân hàng |
| Số tài khoản | Chính xác | Kiểm tra kỹ trước khi nhập |
| Số CMND/CCCD | Của chủ TK | Đúng như đăng ký với ngân hàng |
| SĐT ngân hàng | Đang active | Dùng nhận OTP xác thực |
| Ngân hàng | ACB hoặc MB Bank | Chỉ 2 ngân hàng được hỗ trợ hiện tại |
⚠️ Lưu ý quan trọng
- Chỉ 2 ngân hàng được hỗ trợ: ACB và MB Bank — nếu MD dùng ngân hàng khác, cần liên hệ DSS để bổ sung
- Một tài khoản: Mỗi MD chỉ liên kết được 1 tài khoản ngân hàng
- Thông tin chính xác: Tên, số TK, CMND phải khớp với thông tin tại ngân hàng — nếu sai sẽ không xác thực được
- Không thay đổi thường xuyên: Sau khi liên kết thành công, hạn chế thay đổi thông tin TK để tránh gián đoạn thanh toán
🆘 Xử lý sự cố thường gặp
| Vấn đề | Nguyên nhân | Giải pháp |
|---|---|---|
| OTP không về | SĐT ngân hàng sai hoặc hết vùng phủ | Kiểm tra lại SĐT đăng ký ngân hàng |
| Xác thực thất bại | Thông tin không khớp | Liên hệ ngân hàng kiểm tra lại tên/số TK/CMND |
| Không thấy trang | URL bị bookmark sai | Dùng đúng URL: /app/administration/payment-configs |
| Ngân hàng không hỗ trợ | Chỉ hỗ trợ ACB, MB Bank | Liên hệ DSS để bổ sung ngân hàng |