Cắm cổng Bảo Kim vào shop WooCommerce để nhận thanh toán online

Bảo Kim là một trong những cổng thanh toán nội địa ra đời sớm nhất ở Việt Nam, hoạt động theo giấy phép trung gian thanh toán của Ngân hàng Nhà nước (số 26/GP-NHNN). Nếu shop của bạn đang dùng WooCommerce và muốn khách trả tiền ngay khi đặt hàng thay vì chỉ chuyển khoản thủ công, Bảo Kim là một lựa chọn đáng cân nhắc bên cạnh VNPAY hay Ngân Lượng.

Bảo Kim hỗ trợ những hình thức thanh toán nào

Điểm mạnh của Bảo Kim là gom nhiều kênh trả tiền vào một cổng. Khi cắm vào shop, khách của bạn có thể chọn:

• QR Pay (quét mã QR) — khách mở app ngân hàng quét mã, tiền về thẳng tài khoản. Đây là kênh phổ biến nhất với người mua Việt hiện nay.
• Thẻ ATM nội địa — kết nối hơn 40 ngân hàng trong nước.
• Thẻ quốc tế Visa, Mastercard, JCB cho khách trả bằng thẻ tín dụng/ghi nợ.
• Ví Bảo Kim — khách đã có ví Bảo Kim trả trực tiếp từ số dư.

Gần đây Bảo Kim còn đẩy bộ sản phẩm BaoKim Plus gộp thêm payment link (đường dẫn thanh toán), trả góp 0% qua thẻ tín dụng và điểm thu hộ ngoài đời. Với một shop WooCommerce thuần web, phần bạn cần quan tâm vẫn là cổng thanh toán online nhúng vào trang đặt hàng.

Bước 1: Đăng ký tài khoản merchant Bảo Kim

Trước khi cắm bất cứ thứ gì vào website, bạn phải có tài khoản người bán (merchant — tài khoản doanh nghiệp/cá nhân bán hàng) ở Bảo Kim. Quy trình thường gồm:

1. Tạo tài khoản trên trang chủ Bảo Kim, kích hoạt qua email hoặc mã xác minh gửi về.
2. Khai báo website bán hàng (URL shop của bạn) và nộp hồ sơ xác thực.
3. Sau khi duyệt, Bảo Kim cấp cho bạn một Merchant ID (mã định danh người bán) cùng secret key / checksum key (khoá bí mật để ký dữ liệu). Bộ khoá này chính là thứ plugin cần để kết nối.

Vì là cổng thanh toán có giấy phép, Bảo Kim yêu cầu giấy tờ pháp lý (CCCD, đăng ký kinh doanh nếu là doanh nghiệp). Bạn nên chuẩn bị sẵn để khâu duyệt nhanh hơn. Phí giao dịch và điều kiện cụ thể thay đổi theo thời điểm và loại tài khoản, nên hãy hỏi trực tiếp bộ phận hỗ trợ Bảo Kim để có con số chính xác — đừng tin các bảng phí cũ trôi nổi trên mạng.

Bước 2: Đưa shop về tiền tệ VND

Cổng nội địa như Bảo Kim làm việc bằng đồng Việt Nam. Trước khi gắn cổng, hãy chắc chắn WooCommerce của bạn đã đặt đơn vị tiền tệ là VND. Nếu shop đang để USD hoặc định dạng số tiền lệch (dấu chấm/phẩy ngược), thanh toán dễ báo sai số. Web22 có hướng dẫn riêng về đưa WooCommerce về đồng Việt Nam đúng định dạng nếu bạn chưa làm bước này.

Bước 3: Cài và cấu hình plugin Bảo Kim

Trên kho WordPress.org có plugin Bao Kim Payment Gateway for WooCommerce. Lưu ý quan trọng: bản chính chủ trên kho khá cũ (phiên bản 1.0.5, lượng cài đặt nhỏ và lâu chưa cập nhật), nên trước khi dùng cho shop thật bạn cần kiểm tra kỹ độ tương thích với phiên bản WooCommerce/PHP hiện tại trên một bản nháp, hoặc xin bộ tài liệu tích hợp mới nhất từ chính Bảo Kim.

Sau khi cài, vào WooCommerce → Cài đặt → Thanh toán, bật cổng BaoKimVN và điền:

Điền sai một trong ba khoá này là giao dịch sẽ bị từ chối hoặc báo lỗi chữ ký. Sau khi lưu, hãy đặt một đơn thử với số tiền nhỏ để chạy hết luồng: từ trang thanh toán → sang cổng Bảo Kim → trả tiền → quay về shop và đơn chuyển trạng thái đúng.

Bảo Kim khác gì VNPAY và Ngân Lượng

Ba cổng này cùng phục vụ thị trường Việt nên dễ lẫn. Vài điểm phân biệt thực tế:

• Bảo Kim mạnh ở chỗ có ví điện tử riêng và tuổi đời lâu, gắn liền hệ sinh thái thu hộ/chi hộ. Khách từng quen ví Bảo Kim sẽ trả nhanh.
• VNPAY nổi bật ở độ phủ QR ngân hàng và nhận diện thương hiệu VNPAY-QR rộng, nhiều người mua thấy quen mặt.
• Ngân Lượng cũng là cổng kỳ cựu, hay được nhắc cùng Bảo Kim trong các hướng dẫn vì cùng nhóm cổng nội địa thế hệ đầu.

Không có cổng nào hơn hẳn cho mọi shop — chọn theo phí giao dịch áp cho ngành hàng của bạn, tốc độ đối soát và việc khách của bạn quen kênh nào. Nhiều shop cắm song song hai cổng để khách tự chọn; nếu vậy bạn nên đọc thêm bài so sánh các cổng thanh toán cho WooCommerce để cân nhắc trước khi bật nhiều cổng cùng lúc. Nếu muốn so trực tiếp Bảo Kim với cổng phổ biến nhất, bạn có thể xem qua cách tích hợp VNPAY vào WooCommerce.

Vài lưu ý để cổng chạy ổn lâu dài

Plugin thanh toán đụng tới tiền nên đừng để chạy “được rồi thôi”. Sau khi cắm xong, bạn nên:

• Bật ghi log đơn hàng để truy lại khi có giao dịch treo (khách báo đã trả mà đơn chưa cập nhật).
• Kiểm tra IPN/callback (tín hiệu Bảo Kim báo về shop khi trả tiền xong) hoạt động — đây là chỗ hay lỗi nếu shop chặn request lạ.
• Theo dõi đối soát định kỳ giữa báo cáo Bảo Kim và đơn trong WooCommerce, tránh lệch tiền.

Nếu shop bạn lượng đơn lớn hoặc cần luồng đặt hàng gọn hơn, có thể kết hợp tối ưu trang thanh toán bằng cách rút gọn về checkout một trang cho WooCommerce để giảm bước rơi rớt trước khi sang cổng.

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

Plugin Bảo Kim trên kho WordPress còn dùng được không?

Bản trên kho khá cũ và ít được cập nhật, nên cần kiểm tra tương thích với WooCommerce/PHP hiện tại trước khi dùng cho shop thật. An toàn nhất là hỏi Bảo Kim bộ tài liệu/plugin tích hợp mới nhất, đặc biệt khi bạn dùng BaoKim Plus.

Khách không có ví Bảo Kim có trả được không?

Được. Khách không cần tài khoản Bảo Kim vẫn trả bằng QR ngân hàng, thẻ ATM nội địa hoặc thẻ Visa/Mastercard/JCB. Ví Bảo Kim chỉ là một trong nhiều kênh.

Có cần đổi shop sang VND trước khi cắm Bảo Kim không?

Có. Bảo Kim xử lý bằng đồng Việt Nam, nên WooCommerce phải để tiền tệ VND đúng định dạng, nếu không số tiền chuyển qua cổng có thể bị sai.

Nếu bạn muốn việc đăng ký merchant, lấy khoá và cấu hình cổng được làm gọn ngay từ đầu, dịch vụ dựng và tối ưu shop WooCommerce của Web22 có thể hỗ trợ phần kỹ thuật này.