Hướng dẫn tích hợp cổng thanh toán VietQR Pro tự động miễn phí cho WooCommerce qua SePayHướng dẫn tích hợp cổng thanh toán VietQR Pro tự động miễn phí cho WooCommerce qua SePay

Trong bối cảnh thương mại điện tử tại Việt Nam bùng nổ, hành vi thanh toán bằng hình thức quét mã VietQR qua ứng dụng ngân hàng di động (Mobile Banking) đã trở thành thói quen chiếm trên 80% giao dịch trực tuyến. Tuy nhiên, nếu doanh nghiệp hoặc chủ cửa hàng online sử dụng phương thức chuyển khoản truyền thống, nhân viên phải đối soát sao kê ngân hàng bằng tay, xác nhận đơn hàng chậm trễ và dễ xảy ra nhầm lẫn, sót đơn.

SePay (sepay.vn) chính là giải pháp cổng thanh toán ngân hàng tự động số 1 hiện nay tại Việt Nam dành riêng cho WooCommerce và chuỗi cửa hàng bán lẻ, cho phép:

• Tự động tạo mã VietQR động theo từng đơn hàng: Tự điền chính xác số tiền, số tài khoản và cú pháp mã đơn hàng.
• Webhook bắn trạng thái giao dịch tức thì (Instant Webhook): Tiền vừa vào tài khoản ngân hàng (Techcombank, Vietcombank, MB Bank, ACB, VPBank, TPBank,…), hệ thống tự động đổi trạng thái đơn hàng WooCommerce sang Đang xử lý (Processing) hoặc Hoàn thành (Completed) trong vòng 1-3 giây.
• Gói trải nghiệm miễn phí (Free Tier): Hoàn toàn miễn phí khởi đầu khi đăng ký tài khoản SePay tại đây dành cho doanh nghiệp nhỏ và startup kiểm thử hệ thống.
• Hệ sinh thái thông báo đa kênh & Loa thanh toán: Tích hợp nhận thông báo biến động số dư qua Telegram, Lark, Mobile App hoặc Loa thanh toán SePay thông minh báo tiền về tức thì bằng giọng nói tiếng Việt tại quầy thu ngân.
• Bảo mật tài khoản tuyệt đối: Kết nối thông qua Open Banking API hoặc thông báo biến động số dư chính chủ, không giữ tiền của người bán, tiền chuyển thẳng vào tài khoản ngân hàng của bạn 100%.

I. Toàn cảnh giải pháp SePay VietQR cho thương mại điện tử

SePay cung cấp nền tảng kết nối thanh toán chuyển khoản ngân hàng tự động hóa hoàn toàn từ cổng thanh toán trực tuyến trên website đến hệ thống quản lý tại điểm bán (POS).

II. Quy trình 4 bước tích hợp SePay VietQR vào website WooCommerce

Bước 1: Đăng ký tài khoản và kết nối Ngân hàng trên SePay

Bạn truy cập cổng đăng ký chính thức tại: my.sepay.vn/register để tạo tài khoản doanh nghiệp (hỗ trợ gói dùng thử hoàn toàn miễn phí). Sau khi đăng nhập, thực hiện liên kết tài khoản ngân hàng nhận tiền:

• Chọn ngân hàng của bạn (Vietcombank, MB, Techcombank, ACB, BIDV, OCB,…).
• Nhập số tài khoản và tên chủ tài khoản thụ hưởng.
• Cài đặt phương thức đọc thông báo biến động số dư (qua ứng dụng SePay Hub hoặc Open Banking API an toàn).

Bước 2: Cài đặt Plugin SePay cho WordPress WooCommerce

Bạn đăng nhập vào trang quản trị WordPress của website:

1. Vào mục Gói mở rộng (Plugins) → Cài mới (Add New).
2. Tìm kiếm từ khóa: SePay hoặc tải trực tiếp plugin “SePay – Cổng thanh toán chuyển khoản ngân hàng tự động cho WooCommerce” từ kho plugin WordPress.org.
3. Nhấn Cài đặt và Kích hoạt (Activate) plugin.

Bước 3: Lấy API Key & Cấu hình Webhook

Trong giao diện quản trị SePay (sepay.vn):

• Vào mục Tích hợp (Integrations) → chọn WooCommerce.
• Hệ thống SePay sẽ cung cấp: API Key và URL nhận Webhook (dạng https://yourdomain.com/wp-json/sepay/v1/webhook).
• Quay trở lại WordPress, vào WooCommerce → Cài đặt (Settings) → tab Thanh toán (Payments) → bật cổng Chuyển khoản ngân hàng quét mã QR (SePay).
• Dán mã API Key và chọn tài khoản ngân hàng thụ hưởng.

Bước 4: Thiết lập cú pháp đơn hàng & Thời gian chờ thanh toán (Timeout)

Để hệ thống tự động khớp lệnh thanh toán chính xác:

• Tiền tố mã đơn hàng (Prefix): Đặt tiền tố ngắn gọn (ví dụ: DH hoặc FHC). Nội dung chuyển khoản sẽ có dạng DH1234.
• Thời hạn đơn hàng (Order Expiration): Khuyến nghị cài đặt 10 – 15 phút. Nếu khách hàng không chuyển khoản trong thời gian này, mã QR sẽ tự hết hạn để tránh treo tồn kho.

III. Giải pháp mở rộng: Loa thanh toán SePay cho cửa hàng Offline & Chuỗi bán lẻ

Đối với các chủ doanh nghiệp kết hợp mô hình kinh doanh Online (Website) và Bán hàng tại quầy (Offline Store, F&B, Showroom), tình trạng nhân viên bị lừa bởi “hình ảnh chuyển khoản giả mạo” hoặc mất thời gian đối chiếu sao kê tài khoản cá nhân của chủ quán diễn ra rất thường xuyên.

SePay cung cấp thiết bị Loa thanh toán SePay (kèm tính năng Đặt loa thanh toán trực tuyến):

• Phát âm thanh báo tiền về tức thì: Đọc to và rõ ràng bằng tiếng Việt số tiền nhận được ngay khi tài khoản ngân hàng báo có (ví dụ: “Đã nhận thành công một trăm năm mươi nghìn đồng”).
• Tích hợp mã QR tĩnh/động tại quầy: Khách hàng chỉ cần quét mã QR đặt trên thân loa để thanh toán siêu tốc.
• Bảo vệ chủ shop 100%: Không cần đưa quyền truy cập tài khoản ngân hàng cho nhân viên thu ngân, tránh hoàn toàn rủi ro gian lận ảnh bill giả.

IV. Kiểm tra giao dịch thực tế và xử lý các lỗi thường gặp

Sau khi thiết lập xong, bạn nên đặt 1 đơn hàng thử nghiệm (Test Order) có giá trị tượng trưng (ví dụ: 10.000 VNĐ) để kiểm tra luồng vận hành:

1. Ở trang Checkout, chọn hình thức thanh toán VietQR qua SePay.
2. Hệ thống hiển thị mã QR kèm đồng hồ đếm ngược thời gian thanh toán.
3. Mở app ngân hàng quét mã QR và tiến hành chuyển khoản.
4. Quan sát trang đơn hàng: Khi tiền vừa vào tài khoản người nhận, màn hình website sẽ tự động nhảy sang trang Cảm ơn / Đặt hàng thành công mà khách hàng không cần bấm nút nào.

Khắc phục khi đơn hàng không tự động hoàn thành:

• Lỗi do tường lửa / Cloudflare chặn Webhook: Nếu website sử dụng Cloudflare hoặc plugin bảo mật (Wordfence), hãy cấu hình Whitelist IP của SePay hoặc cho phép bypass User-Agent SePay-Webhook vào endpoint /wp-json/sepay/*.
• Sai nội dung chuyển khoản: Trường hợp khách hàng tự gõ lại nội dung chuyển khoản và gõ sai cú pháp, bạn có thể vào my.sepay.vn tra cứu lịch sử giao dịch và nhấn “Khớp thủ công” vào đúng mã đơn hàng.

---

Bài viết hướng dẫn kỹ thuật được biên soạn bởi Ban Biên tập CÔNG TY TNHH CHÂN TRỜI TƯƠNG LAI. Chúng tôi chuyên cung cấp giải pháp thiết kế website thương mại điện tử trọn gói, tích hợp cổng thanh toán tự động và hạ tầng chuyển đổi số toàn diện cho doanh nghiệp Việt Nam. Quý khách hàng quan tâm đến giải pháp thanh toán tự động có thể đăng ký tài khoản SePay miễn phí tại đây hoặc liên hệ đội ngũ kỹ thuật của Chân Trời Tương Lai để được hỗ trợ triển khai nhanh chóng nhất!