hướng dẫn sử dụng chi tiết cho plugin VN SMTP & VietQR Payment

VN SMTP & VietQR Payment là giải pháp kép tối ưu cho website bán hàng WordPress. Plugin giúp bạn cấu hình gửi email thông báo đơn hàng tin cậy 100% (không lo vào Spam) và tích hợp cổng thanh toán chuyển khoản ngân hàng qua mã QR (VietQR) chuẩn hóa, giúp khách hàng thanh toán chính xác từng đồng.

Dưới đây là hướng dẫn cài đặt và cấu hình chi tiết.

1. Cấu hình VN SMTP (Gửi Email)

Tính năng này thay thế hàm gửi mail mặc định của WordPress (vốn rất yếu và hay bị chặn) bằng giao thức SMTP an toàn.

1. Truy cập Admin → VN SMTP → Settings.
2. Mailer Type: Chọn dịch vụ bạn muốn dùng. Phổ biến nhất là Google / Gmail.
3. SMTP Host:
   • Gmail: smtp.gmail.com
   • Outlook: smtp.office365.com
   • Zoho: smtp.zoho.com
4. Encryption & Port:
   • TLS: Port 587 (Khuyên dùng).
   • SSL: Port 465.
5. Authentication (Xác thực):
   • SMTP Username: Địa chỉ email của bạn (VD: shopcuaban@gmail.com).
   • SMTP Password: Mật khẩu ứng dụng (App Password). Lưu ý: Nếu dùng Gmail, bạn KHÔNG ĐIỀN mật khẩu đăng nhập, mà phải tạo Mật khẩu ứng dụng tại đây.
6. Sender Name: Tên hiển thị khi khách nhận mail (VD: Cửa hàng Tuấn Kiệt).
7. Bấm Save Settings.

2. Cấu hình VietQR Payment (Thanh toán)

Tính năng này tích hợp vào WooCommerce, tự động tạo mã QR chứa số tiền và nội dung chuyển khoản chính xác.

1. Truy cập WooCommerce → Cài đặt → Thanh toán.
2. Bật phương thức Chuyển khoản ngân hàng (VietQR) và bấm Cài đặt (Manage).
3. Thông tin tài khoản thụ hưởng:
   • Ngân hàng: Chọn ngân hàng của bạn (MBBank, Vietcombank, Techcombank, ACB, v.v…).
   • Số tài khoản: Nhập chính xác số tài khoản.
   • Tên chủ tài khoản: Nhập tên chủ thẻ (Viết hoa không dấu).
4. Cú pháp chuyển khoản:
   • Bạn có thể tùy chỉnh nội dung, ví dụ: DH {order_id}.
   • Hệ thống sẽ tự động thay {order_id} bằng mã đơn hàng thực tế.

3. Tùy chỉnh giao diện QR Code

Để tăng độ uy tín, bạn có thể tùy biến khung mã QR hiển thị trang thanh toán (Checkout) hoặc trang Cảm ơn (Thank you page).

• Template:
  • Compact: Chỉ hiện mã QR và nút tải về.
  • Full Info: Hiện mã QR kèm thông tin chi tiết (Ngân hàng, Số TK, Tên) bên cạnh.
• Primary Color: Chọn màu chủ đạo cho khung QR (thường để trùng màu thương hiệu của bạn).
• Logo Center: Upload logo shop của bạn để chèn vào chính giữa mã QR (Tăng nhận diện thương hiệu).

4. Kiểm tra hoạt động (Testing)

A. Kiểm tra Email (Test SMTP)

Vào tab VN SMTP → Email Test. Nhập email cá nhân của bạn và bấm “Send Test”. Nếu nhận được email trong Inbox (Hộp thư đến) tức là cấu hình thành công.

B. Kiểm tra Thanh toán (Test Order)

1. Mở trình duyệt ẩn danh, đặt thử một đơn hàng trên web.
2. Chọn phương thức Chuyển khoản VietQR.
3. Tại trang Cảm ơn, mở app ngân hàng trên điện thoại của bạn và quét mã QR trên màn hình.
4. Kiểm tra xem Số tài khoản, Số tiền, và Nội dung chuyển khoản trên app có khớp với đơn hàng không.

5. Câu hỏi thường gặp (FAQ)

Q: Tại sao tôi nhập đúng mật khẩu Gmail mà báo lỗi xác thực?
A: Google không cho phép dùng mật khẩu đăng nhập thông thường cho ứng dụng bên thứ 3. Bạn bắt buộc phải bật Bảo mật 2 lớp cho Gmail, sau đó tạo Mật khẩu ứng dụng (App Password) 16 ký tự và dùng nó để điền vào plugin.

Q: Plugin có tự động xác nhận đơn hàng khi khách chuyển khoản xong không?
A: Bản Free chỉ hỗ trợ tạo mã QR chuẩn. Để tự động đổi trạng thái đơn hàng sang “Đã thanh toán” (Auto-confirm), bạn cần cài thêm Add-on VN Payment Gate và kết nối API với Casso hoặc SePay.

Q: Mã QR có bị lỗi hết hạn không?
A: Không. Đây là mã VietQR tĩnh được tạo động theo thời gian thực (Dynamic QR), nó tồn tại vĩnh viễn gắn liền với đơn hàng đó.

Bản quyền thuộc về Tuấn Kiệt Solutions. Giải pháp thanh toán & vận hành tự động.