Tích hợp cổng VNPAY vào website WooCommerce của bạn

Tích hợp VNPAY WooCommerce là việc cài plugin chính thức của VNPAY lên website WordPress bán hàng, rồi điền bộ mã merchant gồm Terminal ID (TmnCode) và Secret Key (chuỗi bí mật ký dữ liệu) để khách thanh toán bằng QR, thẻ ATM nội địa hoặc thẻ quốc tế ngay tại trang đặt hàng.

Điểm khiến VNPAY khác phần lớn cổng khác là nó gom nhiều phương thức vào một chỗ: một mã QR duy nhất quét được bằng app của hàng chục ngân hàng nội địa, cộng thẻ ATM nội địa, thẻ Visa/Mastercard và ví VNPAY. Nếu shop của bạn muốn phủ rộng để không khách nào “đến bước trả tiền thì bỏ giỏ”, đây là lý do người ta chọn VNPAY. Bài này đi qua đúng quy trình thật, từ đăng ký tới lúc đơn hàng đầu tiên báo “đã thanh toán”.

VNPAY phù hợp với shop nào

VNPAY hợp với cửa hàng bán cho khách Việt là chính, nơi đa số người mua quen quét QR trên app ngân hàng hơn là nhập số thẻ. Vì cổng phủ gần như mọi ngân hàng nội địa, bạn không phải lo “khách dùng bank lạ thì không trả được”. Ngược lại, nếu website của bạn hướng tới khách quốc tế trả bằng thẻ nước ngoài là chủ yếu, hãy cân nhắc kết hợp thêm một cổng quốc tế thay vì chỉ dựa vào VNPAY.

Phí giao dịch và hạn mức

Việc đăng ký tài khoản merchant với VNPAY thường không tốn phí khởi tạo; chi phí thực sự nằm ở phí trên mỗi giao dịch thành công. Mức tham khảo phổ biến trên thị trường như sau:

Đây là con số định tính để bạn hình dung, không phải bảng giá chính thức. Phí thật phụ thuộc ngành hàng, doanh số dự kiến và chính sách từng thời điểm, nên VNPAY thường báo phí cụ thể trong hợp đồng. [CẦN ĐIỀN: phí và hạn mức chốt trong hợp đồng merchant của bạn]. Hãy hỏi rõ phí từng phương thức và hạn mức mỗi giao dịch trước khi ký, vì đây là phần ăn trực tiếp vào lợi nhuận mỗi đơn.

Đăng ký tài khoản merchant

Để chạy thật, bạn cần tài khoản merchant (đơn vị bán hàng) đã được VNPAY duyệt. Quy trình thường gồm:

1. Liên hệ VNPAY qua website chính thức, cung cấp thông tin doanh nghiệp hoặc hộ kinh doanh.
2. Nộp hồ sơ pháp lý: giấy phép kinh doanh, thông tin tài khoản ngân hàng nhận tiền về, thông tin website.
3. VNPAY thẩm định và ký hợp đồng dịch vụ.
4. Sau khi duyệt, bạn nhận email kích hoạt chứa bộ mã: Terminal ID (TmnCode), Secret Key (chuỗi bí mật) và đường dẫn thanh toán.

Trong lúc chờ duyệt tài khoản thật, bạn không cần ngồi không. VNPAY có môi trường sandbox (môi trường thử nghiệm, tiền ảo) đăng ký tại trang devreg của họ, cấp ngay bộ mã thử để bạn cắm vào website và chạy thử trọn luồng đặt hàng trước.

Lấy khóa và cắm vào WooCommerce

Sau khi có bộ mã (dù là sandbox hay thật), các bước cấu hình giống nhau, chỉ khác giá trị mã và chế độ môi trường:

1. Tải plugin VNPAY cho WooCommerce từ tài liệu chính thức của VNPAY, rồi vào Plugins → Add New → Upload để cài và kích hoạt. (Bạn cũng có thể chép thư mục plugin vào /wp-content/plugins/ rồi kích hoạt.)
2. Vào WooCommerce → Settings → Payments, tìm VNPAY và bấm Manage / Quản lý.
3. Điền Terminal ID (TmnCode) và Secret Key (HashSecret) đúng như email kích hoạt gửi về. Dán nguyên văn, tránh dính dấu cách thừa ở đầu hoặc cuối.
4. Điền Pay URL (đường dẫn khởi tạo giao dịch) theo tài liệu: dùng địa chỉ sandbox khi test, đổi sang địa chỉ production khi chạy thật.
5. Đặt Title (tên hiển thị cho khách, ví dụ “Thanh toán qua VNPAY”), mô tả ngắn và ngôn ngữ giao diện cổng.
6. Lưu, rồi bật phương thức VNPAY ở trạng thái hiển thị tại trang thanh toán.

Một lưu ý quan trọng từ chính tài liệu VNPAY: đừng tự tay đổi trạng thái đơn hàng thành “đã thanh toán”. Cổng sẽ tự gọi về website (qua IPN) để cập nhật đúng trạng thái thành công hay thất bại. Bạn sửa tay là dễ lệch giữa tiền thật và đơn ghi nhận.

Chạy thử trước khi go-live

Với bộ mã sandbox, hãy đặt một đơn thử và đi hết luồng: từ giỏ hàng, qua trang VNPAY, quét/nhập thẻ test, đến khi quay về website và đơn tự chuyển sang “đã thanh toán”. Khi luồng sandbox chạy mượt, bạn chỉ việc thay TmnCode, Secret Key và Pay URL bằng bộ thật, rồi đặt thêm một đơn giá trị nhỏ bằng thẻ thật để xác nhận tiền về tài khoản. Tiền về đúng mới gọi là xong.

Vài điều dễ vấp

• Đơn vị tiền tệ: WooCommerce phải để VND. Nếu website đang để USD hay sai định dạng số, số tiền gửi sang VNPAY sẽ lệch. Bạn có thể xem hướng dẫn đặt tiền tệ VND chuẩn cho WooCommerce để tránh lỗi này.
• Website chưa có HTTPS: cổng thanh toán cần kết nối an toàn; thiếu chứng chỉ SSL dễ bị chặn hoặc cảnh báo.
• Sai Secret Key: lỗi “sai chữ ký” (checksum) gần như luôn do dán nhầm khóa hoặc dính ký tự thừa. Kiểm tra lại từng ký tự.

Câu hỏi thường gặp

Tích hợp VNPAY có cần biết lập trình không?

Với plugin chính thức thì không cần code. Việc của bạn là dán đúng bộ mã và cấu hình môi trường. Phần “khó” thật ra nằm ở thủ tục đăng ký merchant và test cẩn thận, không phải ở khâu kỹ thuật cắm plugin.

Khách quét QR bằng app ngân hàng nào cũng được chứ?

QR của VNPAY thuộc chuẩn dùng chung nên hầu hết app Mobile Banking nội địa quét được. Đây chính là điểm mạnh phủ rộng của cổng so với cổng chỉ hỗ trợ vài ngân hàng.

Bao lâu thì tài khoản được duyệt?

Thời gian duyệt tùy hồ sơ và thời điểm, nên không có con số cố định. Trong lúc chờ, cứ dùng sandbox dựng sẵn luồng để khi có mã thật là bật bán ngay.

Nếu bạn muốn có người dựng và kiểm thử trọn luồng thanh toán thay vì tự mò, dịch vụ làm website WooCommerce của Web22 nhận phần này. Khi shop đã chạy ổn, bước tiếp theo thường là kéo khách: tham khảo cách Web22 làm SEO cho web bán hàng. Còn nếu bạn đang phân vân giữa nhiều cổng, hãy đọc bài đối chiếu các cổng thanh toán cho WooCommerce trước khi quyết.