Tích hợp SePay Gateway vào WooCommerce: thanh toán QR tự động

SePay Gateway là gì?

SePay Gateway là plugin thanh toán cho WooCommerce, cho phép khách hàng thanh toán bằng cách quét mã QR chuyển khoản ngân hàng. Khi khách hoàn tất thanh toán, hệ thống tự động xác nhận và cập nhật trạng thái đơn hàng.

Phía khách hàng mua hàng

Khi đặt hàng, khách sẽ thấy tùy chọn Chuyển khoản ngân hàng trong phương thức thanh toán.

Sau khi chọn phương thức này, mã QR code cùng thông tin thanh toán sẽ hiển thị.

Khi khách hoàn tất chuyển tiền, website hiển thị Bạn đã thanh toán thành công chỉ sau vài giây.

Phía quản trị WooCommerce

Đơn hàng sẽ tự động ghi nhận thanh toán và chuyển từ trạng thái Tạm giữ (On-Hold) sang Đang xử lý (Processing).

Hướng dẫn tích hợp

1. 1

   Bước 1: Cài đặt plugin SePay Gateway

   Truy cập Trang quản trị WordPress → Plugin → Cài Plugin, tìm từ khóa "sepay" trên thanh tìm kiếm.

   Nhấn Cài đặt ngay và sau đó Kích hoạt plugin.

   

   Sau khi cài xong, bạn sẽ được chuyển đến trang thiết lập SePay Gateway.
2. 2

   Bước 2: Kết nối với tài khoản SePay

   Tại giao diện thiết lập, nhấn nút Kết nối tài khoản để bắt đầu.

   

   Bạn sẽ được chuyển sang trang ủy quyền để WooCommerce truy cập vào tài khoản SePay. Nếu chưa đăng nhập, hãy đăng nhập vào my.sepay.vn trước.

   

   Nhấn Cho phép để tiếp tục sang bước cấu hình ngân hàng.
3. 3

   Bước 3: Cấu hình tài khoản ngân hàng

   Chọn tài khoản ngân hàng để hiển thị trên trang thanh toán và nhận tiền.

   

   Chưa có tài khoản ngân hàng?

   Nếu chưa kết nối ngân hàng nào tại SePay, truy cập my.sepay.vn/bankaccount/connect để thêm ngân hàng mới.

   Chọn tài khoản cần tích hợp và nhấn Hoàn tất thiết lập.

   

   Hệ thống sẽ tự động tạo một tích hợp Webhooks tương ứng với tài khoản ngân hàng bạn chọn để gửi thông báo qua website khi có giao dịch chuyển tiền.

   

Cấu hình chi tiết SePay Gateway

Sau khi tích hợp, bạn có thể tùy chỉnh các thiết lập trong WooCommerce → Settings → Payments → SePay Gateway.

Các tùy chọn cấu hình

1. 1

   1. Bật/Tắt

   Bật hoặc tắt phương thức thanh toán SePay trên trang checkout.

   
2. 2

   2. Tiêu đề

   Tên hiển thị của phương thức thanh toán mà khách hàng nhìn thấy.

   
3. 3

   3. Mô tả

   Thông tin mô tả chi tiết về phương thức thanh toán.

   
4. 4

   4. Tài khoản ngân hàng

   Chọn tài khoản ngân hàng để hiển thị trên trang thanh toán.

   
5. 5

   5. Tài khoản VA (Virtual Account)

   Đối với các ngân hàng chỉ hỗ trợ xác thực qua số VA như BIDV, OCB, MSB, KienLongBank, bạn cần chọn tài khoản VA tương ứng.

   
6. 6

   6. Tiền tố mã thanh toán

   Chuỗi 2-5 ký tự đặt trước mã thanh toán để SePay phân biệt và xác thực đơn hàng.

   

   Ví dụ tiền tố mã thanh toán

   Nếu tiền tố là DH, khi thanh toán khách quét QR với nội dung DH1234 - trong đó DH là tiền tố, 1234 là mã đơn hàng WooCommerce.

   Quản lý cấu trúc mã tại Cấu hình Công ty → Cấu hình chung trên SePay.
7. 7

   7. Thông báo thành công

   Nội dung hiển thị trên website sau khi khách thanh toán thành công.

   

   Hỗ trợ HTML và JavaScript - bạn có thể chèn code tracking như Google Analytics tại đây.
8. 8

   8. Trạng thái đơn hàng khi hoàn tất

   Trạng thái đơn hàng sau khi khách thanh toán đủ. Có thể chọn:

   • Để WooCommerce quyết định (mặc định)
   • Đang xử lý (Processing)
   • Đã hoàn tất (Completed)

   
9. 9

   9. Chế độ tải xuống (sản phẩm số)

   Dành cho đơn hàng sản phẩm số - chọn Thủ công hoặc Tự động cho phép khách tải xuống.

   
10. 10

    10. Hiển thị tên ngân hàng

    Chọn cách hiển thị tên ngân hàng trên màn hình thanh toán:

    • Tên đầy đủ
    • Tên viết tắt
    • Tên đầy đủ kèm tên viết tắt

    
11. 11

    11. Logo

    URL logo để hiển thị trên phương thức thanh toán.

    

Kiểm tra cấu hình

1. 1

   Test đặt hàng

   Thử đặt hàng trên website với giá trị nhỏ (ví dụ 2.000đ).
2. 2

   Chọn phương thức thanh toán

   Đến bước thanh toán, chọn Chuyển khoản ngân hàng (Quét mã QR).
3. 3

   Kiểm tra QR code

   Nếu mã QR hiển thị sau khi đặt hàng → cấu hình thành công.
4. 4

   Test thanh toán

   Thực hiện thanh toán. Nếu hiển thị Bạn đã thanh toán thành công và đơn hàng chuyển sang Đang xử lý (Processing) → tích hợp hoàn chỉnh.