Cắm cổng OnePay vào WooCommerce cho website bán hàng có khách quốc tế

Tích hợp OnePay WooCommerce là việc kết nối cổng thanh toán OnePay với website bán hàng WooCommerce, để khách quẹt thẻ Visa, Mastercard, JCB hoặc thẻ ATM nội địa rồi tự về đơn. Bạn ký hợp đồng merchant (tài khoản người bán) với OnePay, nhận bộ khoá, cắm vào plugin và chạy thử trên sandbox (môi trường thử nghiệm) trước khi mở bán.

Vì sao chọn OnePay thay vì một cổng gộp chung

Điểm đáng chú ý của OnePay là cổng được tách làm hai mảng riêng: cổng quốc tế nhận thẻ Visa, Mastercard, JCB, American Express, UnionPay; và cổng nội địa nhận thẻ ATM ngân hàng Việt Nam đã đăng ký Internet Banking. Hai mảng này dùng hai bộ khoá tách biệt, nghĩa là bạn có thể bật riêng từng cổng tuỳ nhu cầu.

Cách chia này hợp với shop có lượng khách nước ngoài hoặc bán xuyên biên giới: khách cầm thẻ Visa phát hành ở nước ngoài vẫn trả được, điều mà nhiều cổng chỉ tập trung thị trường nội địa làm chưa mượt. Nếu cửa hàng của bạn thuần khách Việt và chủ yếu chuyển khoản, một cổng nhẹ hơn có khi đã đủ. Bạn có thể đối chiếu các lựa chọn ở bài so sánh các cổng thanh toán cho WooCommerce trước khi quyết.

Hồ sơ đăng ký và duyệt tài khoản merchant

Khác với vài ví điện tử cho đăng ký nhanh qua app, OnePay đi theo hướng ký hợp đồng doanh nghiệp. Bạn cần chuẩn bị:

• Hợp đồng chấp nhận thanh toán trực tuyến (theo mẫu OnePay cấp).
• Bản sao công chứng giấy phép đăng ký kinh doanh.
• Bản sao giấy tờ tuỳ thân của người ký hợp đồng.
• Thông tin tài khoản ngân hàng doanh nghiệp để nhận tiền về.
• Địa chỉ website sẽ gắn cổng thanh toán.

Vì có khâu thẩm định pháp lý và kiểm tra website, quy trình duyệt mất thời gian hơn đăng ký ví. Bạn nên hoàn thiện website, có đủ trang chính sách (đổi trả, vận chuyển, bảo mật, điều khoản) trước khi nộp hồ sơ, vì cổng thường rà các trang này. Mốc thời gian duyệt cụ thể phụ thuộc ngành hàng và độ đầy đủ hồ sơ, nên hỏi thẳng OnePay để có con số chính xác cho trường hợp của bạn.

Biểu phí giao dịch

OnePay tính phí theo mô hình merchant doanh nghiệp, gồm nhiều khoản chứ không chỉ một con số:

Phần phí phần trăm thường nằm trong khoảng 1,5%–3,5% giá trị giao dịch, dao động theo ngành hàng, quy mô và lượng giao dịch hàng tháng. Đây là khoảng tham khảo, không phải mức cố định: thẻ quốc tế thường có phí cao hơn thẻ nội địa. [CẦN ĐIỀN: mức phí chính xác theo báo giá OnePay cho ngành hàng của bạn] vì chỉ OnePay mới ra được con số ràng buộc cho hợp đồng. Đừng cam kết một con số cụ thể với khách hay đối tác khi chưa có báo giá trên giấy.

Lấy khoá API và cắm vào WooCommerce

Sau khi hợp đồng được duyệt, OnePay cấp cho bạn bộ ba thông tin cho từng cổng: Merchant ID (mã người bán), Access Code (mã truy cập) và Secure Secret (chuỗi bí mật dùng ký mã hoá giao dịch, một số tài liệu gọi là Hashcode). Nếu bật cả hai mảng, bạn sẽ có hai bộ khoá tách biệt cho cổng quốc tế và cổng nội địa, kèm Payment URL (địa chỉ chuyển hướng thanh toán) tương ứng.

1. Cài plugin OnePay cho WooCommerce. OnePay không có plugin chính chủ trên kho WordPress.org, nên bạn dùng plugin do bên triển khai cung cấp hoặc nhờ lập trình viên cắm theo tài liệu kỹ thuật OnePay. Hãy ưu tiên bản cập nhật để khớp WooCommerce mới.
2. Vào WooCommerce → Cài đặt → Thanh toán, mở mục OnePay.
3. Dán Merchant ID, Access Code, Secure Secret và Payment URL vào đúng ô. Nếu plugin tách quốc tế và nội địa, nhập đúng bộ khoá cho từng cổng, đừng lẫn lộn.
4. Đặt Tiêu đề và Mô tả hiển thị ở trang thanh toán (ví dụ “Thẻ quốc tế Visa/Master” và “Thẻ ATM nội địa”) để khách biết chọn gì.
5. Bật chế độ Sandbox để chạy thử, chỉ tắt khi đã kiểm tra xong.

Một lưu ý dễ vấp: OnePay xử lý số tiền theo đơn vị tiền tệ và định dạng riêng, nên website phải đặt đúng tiền tệ. Nếu bạn bán bằng VND, kiểm tra cấu hình ở bài thiết lập tiền tệ VND trong WooCommerce để tránh lệch số khi gửi sang cổng.

Chạy thử trước khi mở bán

Đừng bật cổng live ngay. Ở chế độ sandbox, OnePay cung cấp thẻ thử để bạn tạo đơn giả và đi hết luồng. Hãy thử:

• Một đơn trả bằng thẻ quốc tế và một đơn bằng thẻ ATM nội địa, để chắc cả hai cổng đều thông.
• Nhiều mức giá trị đơn khác nhau, gồm đơn nhỏ và đơn lớn.
• Trường hợp khách huỷ giữa chừng hoặc thanh toán thất bại, xem đơn về đúng trạng thái chưa.

Khi đơn thử về đúng và trạng thái cập nhật chuẩn, bạn mới tắt sandbox và chuyển sang bộ khoá thật. Với shop bán hàng muốn tối ưu cả khâu hiển thị sản phẩm lẫn thứ hạng tìm kiếm, bạn có thể tham khảo thêm dịch vụ SEO cho website bán hàng.

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

OnePay có nhận thẻ phát hành ở nước ngoài không?

Có. Cổng quốc tế của OnePay xử lý thẻ Visa, Mastercard, JCB, American Express, UnionPay, nên khách nước ngoài cầm thẻ phát hành ở nước họ vẫn trả được. Đây là lý do shop bán xuyên biên giới hay chọn OnePay.

Cá nhân không có giấy phép kinh doanh đăng ký được không?

OnePay đi theo hợp đồng merchant doanh nghiệp và cần giấy phép đăng ký kinh doanh trong hồ sơ, nên người bán cá nhân chưa có pháp nhân sẽ khó đáp ứng. Hãy hỏi trực tiếp OnePay về phương án phù hợp.

Có cần lập trình viên để cắm OnePay không?

Nếu có plugin sẵn khớp WooCommerce, bạn chỉ cần dán khoá là chạy. Nhưng do OnePay không có plugin chính chủ trên kho WordPress và dùng cơ chế ký mã hoá riêng, nhiều shop nhờ kỹ thuật cắm theo tài liệu để chắc phần bảo mật. Bạn có thể xem phần dịch vụ WooCommerce của Web22 nếu cần người làm khâu này.