Trả lời nhanh: SePay (sepay.vn) là dịch vụ của Công ty CP SePay giúp tự động xác nhận thanh toán chuyển khoản. Khách quét mã VietQR và chuyển tiền thẳng vào tài khoản ngân hàng của bạn. SePay ghi nhận biến động số dư rồi gửi webhook về website, đơn hàng được cập nhật mà không cần ai dò sao kê.
Điểm chính
- SePay không giữ tiền: tiền khách chuyển về thẳng tài khoản của bạn, SePay chỉ đọc giao dịch và báo cho hệ thống của bạn.
- Đơn hàng được khớp nhờ mã thanh toán trong nội dung chuyển khoản, ví dụ DH1234.
- Có gói miễn phí 50 giao dịch/tháng; gói trả phí tính theo số giao dịch hoặc theo cửa hàng.
- Có plugin cho WooCommerce và tích hợp Haravan, Sapo, Shopify, Google Sheets.
- Khi tự tích hợp, cần xác thực webhook bằng HMAC-SHA256, kiểm tra số tiền và chống xử lý trùng giao dịch.
Mục lục
- SePay là gì?
- SePay hoạt động như thế nào?
- SePay dùng để làm gì trong thực tế?
- Cách tích hợp SePay với WooCommerce và Haravan
- SePay hỗ trợ những ngân hàng nào?
- Bảng giá SePay 2026
- SePay khác gì cổng thanh toán VNPay, MoMo?
- Dùng SePay có an toàn không? Những điểm bảo mật cần kiểm tra
- Câu hỏi thường gặp
SePay là gì?
SePay là nền tảng tự động hoá việc nhận tiền bằng chuyển khoản ngân hàng. Trên trang chính thức, SePay tự giới thiệu là công ty công nghệ chuyên phát triển phần mềm tự động xác nhận thanh toán chuyển khoản, đối soát và quản lý dòng tiền cho doanh nghiệp. Tên pháp lý ghi ở chân trang là Công ty CP SePay. Khi người dùng tìm “sepay vn”, họ thường muốn nói tới website sepay.vn và trang quản trị my.sepay.vn của dịch vụ này.
Ở Việt Nam, rất nhiều người mua thích chuyển khoản qua app ngân hàng. Người bán phải dò từng giao dịch, đối chiếu nội dung với đơn rồi xác nhận bằng tay. Cách này chậm, dễ nhầm và dễ bị lừa bằng ảnh chụp chuyển khoản giả. SePay thay bước dò tay đó bằng dữ liệu giao dịch lấy từ ngân hàng.
Về bản chất, SePay làm ba việc chính:
- Theo dõi biến động số dư: liên kết với tài khoản ngân hàng của bạn và ghi nhận mỗi giao dịch tiền vào, tiền ra.
- Xác nhận chuyển khoản tự động: đọc nội dung chuyển khoản, tách mã thanh toán và báo cho website biết đơn nào đã được trả.
- Chia sẻ thông báo: đẩy thông báo giao dịch tới Telegram, Lark, ứng dụng di động hoặc loa thanh toán cho nhân viên bán hàng.
SePay hoạt động như thế nào?
- Website tạo đơn và mã VietQR. Mã QR chứa số tài khoản, số tiền và nội dung chuyển khoản có mã đơn. Ví dụ minh hoạ: với tiền tố DH và đơn số 1234, nội dung là DH1234.
- Khách quét mã bằng app ngân hàng. Thông tin được điền sẵn, khách chỉ cần xác nhận chuyển.
- Tiền về thẳng tài khoản của bạn. SePay không đứng giữa dòng tiền.
- SePay ghi nhận giao dịch và gửi webhook. Webhook là một yêu cầu HTTP POST mà SePay chủ động gửi tới địa chỉ (URL) bạn cấu hình, kèm dữ liệu giao dịch.
- Website kiểm tra và cập nhật đơn. Hệ thống của bạn xác thực yêu cầu, đối chiếu mã đơn, số tiền rồi chuyển đơn sang trạng thái đã thanh toán.

Dữ liệu webhook ngân hàng gửi về gồm những gì?
Theo tài liệu dành cho nhà phát triển của SePay, mỗi webhook là một gói JSON. Các trường bạn sẽ dùng nhiều nhất là:
id: mã giao dịch trên SePay, không đổi khi SePay gửi lại. Đây là khoá để chống trùng.gatewayvàaccountNumber: tên ngân hàng và số tài khoản nhận tiền.transferType:inlà tiền vào,outlà tiền ra.transferAmount: số tiền giao dịch.content: nội dung chuyển khoản gốc khách gõ hoặc QR điền sẵn.code: mã thanh toán SePay tách ra từ nội dung theo tiền tố bạn cấu hình. Nếu không khớp cấu hình, trường này là null.
Server của bạn phải trả về mã HTTP 200 hoặc 201 với nội dung {“success”: true} trong vòng 30 giây. Nếu không, SePay coi là thất bại và gửi lại tối đa 7 lần trong khoảng 33 phút. Vì vậy, nên trả phản hồi ngay rồi xử lý đơn ở hàng đợi nền. Nếu bạn chưa quen hai khái niệm này, bài API và webhook khác nhau thế nào và bài message queue là gì sẽ giúp bạn nắm nhanh.
SePay dùng để làm gì trong thực tế?
SePay phù hợp nhất khi phần lớn khách trả tiền bằng chuyển khoản và bạn cần biết ngay đơn nào đã được thanh toán. Một số tình huống điển hình:
Website bán hàng
Trang thanh toán hiện mã VietQR. Khi tiền về, đơn tự chuyển trạng thái và khách thấy thông báo thành công. SePay quảng bá thời gian xác nhận khoảng vài giây, nhưng tốc độ thực tế còn phụ thuộc ngân hàng và server của bạn.
Bán khoá học, phần mềm, dịch vụ số
Webhook giúp mở khoá học, gửi mã kích hoạt hoặc gia hạn tài khoản ngay khi tiền vào. Trên kho plugin WordPress có add-on LearnPress – Sepay Payment do ThimPress phát triển. Đây là plugin bên thứ ba, không phải của SePay, nên hãy kiểm tra phiên bản trước khi dùng.
WooCommerce, Haravan, Sapo, Shopify
SePay liệt kê tích hợp sẵn với WooCommerce, Haravan, Sapo, Shopify, HostBill và Google Sheets. Với các nền tảng này, bạn thường không phải viết code: chỉ cần cài plugin hoặc bật tích hợp rồi chọn tài khoản ngân hàng nhận tiền.
Hệ thống tự viết hoặc phần mềm nội bộ
Doanh nghiệp có hệ thống riêng có thể nhận webhook trực tiếp. Nếu chỉ cần đẩy giao dịch sang bảng tính hay CRM, có thể dùng công cụ tự động hoá như n8n làm lớp nhận webhook. Shop không có website vẫn nhận được thông báo tiền vào qua Telegram, Lark hoặc loa thanh toán.
Cách tích hợp SePay với WooCommerce và Haravan
WooCommerce
Theo hướng dẫn trên docs.sepay.vn, quy trình gồm các bước sau. Giao diện có thể khác theo phiên bản plugin.
- Trong trang quản trị WordPress, vào Plugin, chọn Cài Plugin, tìm “sepay”, cài và kích hoạt plugin SePay Gateway.
- Bấm Kết nối tài khoản, đăng nhập my.sepay.vn và cho phép WooCommerce truy cập.
- Chọn tài khoản ngân hàng hiển thị cho khách rồi bấm Hoàn tất thiết lập. SePay tự tạo webhook tương ứng.
- Cấu hình tiêu đề, mô tả, tiền tố mã thanh toán, thông báo thành công và trạng thái đơn sau khi thanh toán (Processing hoặc Completed).
- Đặt thử một đơn giá trị nhỏ, quét QR và kiểm tra đơn có tự chuyển từ On-Hold sang Processing không.
Tiền tố mã thanh toán là chuỗi 2–5 ký tự, quản lý trong phần Cấu hình chung của công ty trên SePay. Với một số ngân hàng chỉ xác thực qua số tài khoản ảo như BIDV, OCB, MSB, KienlongBank, bạn phải chọn thêm tài khoản VA tương ứng.
Haravan
Theo trang giới thiệu của SePay, bạn liên kết tài khoản ngân hàng qua OTP rồi bật tích hợp trên cả SePay và Haravan. Website Haravan tạo VietQR cho từng đơn và tự chuyển đơn sang đã thanh toán khi nhận webhook. Cách xử lý chuyển thiếu, chuyển thừa hay huỷ đơn không được mô tả rõ, nên hãy hỏi bộ phận hỗ trợ trước khi chạy thật.
SePay hỗ trợ những ngân hàng nào?
Trang danh sách ngân hàng của SePay (tháng 11/2026) hiển thị logo 28 ngân hàng, từ Vietcombank, BIDV, VietinBank, Techcombank, Agribank đến các ngân hàng nhỏ hơn như Nam A Bank, PGBank.
Tuy nhiên, mức độ kết nối không giống nhau. SePay xếp riêng nhóm “ngân hàng mở API và đối tác chính thức” gồm Vietcombank, BIDV, VietinBank, VPBank, MB, ACB, MSB, TPBank, OCB, KienlongBank, Shinhan Bank và NAPAS. Một trang giới thiệu khác cho biết ngân hàng chưa hợp tác có thể kết nối qua tin nhắn SMS báo biến động số dư. Cách qua SMS phụ thuộc vào việc tin nhắn đến đầy đủ và đúng lúc, nên kém ổn định hơn kết nối API.
Chính các trang của SePay đang ghi số ngân hàng không thống nhất (12, 13+, 28, 31 ngân hàng ở các mục khác nhau). Trước khi mở tài khoản mới chỉ để dùng SePay, hãy xác nhận với SePay ngân hàng đó hỗ trợ loại tài khoản của bạn (cá nhân hay doanh nghiệp), có cần VA không và thuộc gói nào.
Bảng giá SePay 2026
Bảng dưới tóm tắt trang bảng giá trên sepay.vn tháng 11/2026. Giá có thể thay đổi, hãy xem lại trước khi đăng ký.
| Gói | Giá | Giới hạn | Ghi chú |
|---|---|---|---|
| FREE | 0đ/tháng | 50 giao dịch/tháng | Vượt mức thì tính phí phần vượt |
| STARTUP | Từ 120.000đ/tháng | Nhiều mức số giao dịch/tháng | Trả theo năm được giảm đến 20% |
| SHOP (theo điểm bán) | 70.000đ/cửa hàng/tháng | Không giới hạn giao dịch | Không hỗ trợ tích hợp cổng thanh toán hoặc API; dùng thử 14 ngày |
| SePay eShop | Từ 50.000đ/tháng | Phần mềm bán hàng | Gói cao hơn đang ghi “dự kiến ra mắt” |
Lưu ý: gói SHOP rẻ và không giới hạn giao dịch nhưng không có webhook hay API, nên không dùng được cho website. Một số trang giới thiệu cũ của SePay ghi hạn mức miễn phí khác, hãy lấy bảng giá làm chuẩn.
SePay khác gì cổng thanh toán VNPay, MoMo?
Điểm khác lớn nhất nằm ở dòng tiền. Với cổng thanh toán (payment gateway) như VNPay hay ví điện tử MoMo, tiền của khách thường đi qua đơn vị trung gian rồi mới được đối soát, chuyển về người bán theo kỳ đã ký. Với SePay, tiền đi thẳng vào tài khoản của bạn.
| Tiêu chí | Chuyển khoản VietQR + SePay | Cổng thanh toán, ví điện tử (VNPay, MoMo…) |
|---|---|---|
| Dòng tiền | Về thẳng tài khoản của bạn | Thường qua trung gian, chuyển về theo kỳ đối soát |
| Cách tính phí | Phí gói theo tháng, theo số giao dịch | Thường tính theo phần trăm giá trị giao dịch, tuỳ hợp đồng |
| Phương thức khách dùng | App ngân hàng quét VietQR | Thẻ nội địa, thẻ quốc tế, QR, số dư ví tuỳ cổng |
| Thủ tục | Đăng ký online, liên kết tài khoản ngân hàng | Thường cần ký hợp đồng và hồ sơ pháp lý doanh nghiệp |
| Hoàn tiền | Người bán tự chuyển khoản trả lại | Có quy trình hoàn tiền qua cổng |
| Khách nước ngoài | Khó, vì cần tài khoản ngân hàng Việt Nam | Nhận được thẻ quốc tế nếu cổng hỗ trợ |
Ranh giới giữa hai nhóm đang mờ dần. SePay cũng có cổng thanh toán riêng, gồm QR chuẩn NAPAS và thẻ Visa, Mastercard, JCB qua hợp tác với VPBank, nhưng cần xét duyệt từ vài ngày đến khoảng 2 tuần. Nếu đa số khách là người Việt dùng app ngân hàng, chuyển khoản kèm SePay thường rẻ và gọn hơn. Nếu cần nhận thẻ quốc tế, trả góp hoặc ví điện tử, bạn vẫn cần một cổng thanh toán. Nhiều shop dùng cả hai.
Dùng SePay có an toàn không? Những điểm bảo mật cần kiểm tra
SePay công bố chứng nhận ISO 27001 về quản lý an toàn thông tin. Dù vậy, phần lớn lỗi thực tế nằm ở website nhận webhook. Hãy làm đủ các điểm dưới đây trước khi chạy thật.
1. Xác thực webhook bằng chữ ký hoặc API key
Địa chỉ nhận webhook là một URL công khai. Nếu không xác thực, bất kỳ ai biết URL cũng có thể gửi một yêu cầu giả để “báo đã thanh toán”. SePay hỗ trợ bốn chế độ: HMAC-SHA256, API Key, OAuth 2.0 và không xác thực.
- HMAC-SHA256 (khuyến nghị cho môi trường thật): SePay gửi chữ ký trong header
X-SePay-Signaturevà thời điểm gửi trongX-SePay-Timestamp. Chuỗi được ký là timestamp, dấu chấm, rồi đến nội dung gốc (raw body). Server tự tính lại chữ ký bằng secret key, so sánh theo kiểu thời gian hằng (constant-time) và từ chối yêu cầu có timestamp lệch quá 5 phút. Đây là cách duy nhất phát hiện được dữ liệu bị sửa trên đường truyền. - API Key: SePay gửi header
Authorizationdạng “Apikey” kèm khoá. Cách này chỉ xác nhận yêu cầu đến từ SePay, không phát hiện nội dung bị sửa. - OAuth 2.0 chỉ nên dùng khi bạn đã có máy chủ cấp token; chế độ không xác thực chỉ để thử nghiệm.
Lỗi hay gặp khi làm HMAC là parse JSON rồi mới tính chữ ký, khiến chữ ký lệch. Hãy tính trên raw body. SePay cũng bắt buộc HTTPS cho URL webhook và công bố danh sách địa chỉ IP gửi đi để bạn đặt tường lửa. Nên kết hợp lọc IP với chữ ký thay vì chỉ dựa vào một lớp. Các nguyên tắc chung về khoá, token, HTTPS được trình bày kỹ hơn trong bài bảo mật API là gì.
2. Kiểm tra số tiền và mã đơn
Webhook hợp lệ chỉ cho biết có tiền vào. Nó chưa chắc là đúng tiền cho đúng đơn. Trước khi cập nhật đơn, hãy kiểm tra:
transferTypelàin, tránh coi giao dịch tiền ra là thanh toán.codekhớp với một đơn đang chờ thanh toán. Nếucodelà null, đưa giao dịch vào danh sách chờ đối soát tay, không tự đoán.transferAmountlớn hơn hoặc bằng tổng tiền đơn. Khách chuyển thiếu thì giữ đơn ở trạng thái chờ và báo khách.accountNumberđúng tài khoản bạn dùng cho kênh bán đó, nhất là khi một tài khoản SePay liên kết nhiều tài khoản ngân hàng.
Mã đơn nên khó đoán, ví dụ ghép tiền tố với chuỗi ngẫu nhiên thay vì chỉ dùng số thứ tự tăng dần. Như vậy người lạ khó chuyển một khoản nhỏ với mã đơn của người khác để gây nhầm lẫn.
3. Chống xử lý trùng giao dịch
Cùng một giao dịch có thể đến nhiều lần: SePay gửi lại khi server chậm, quản trị viên bấm gửi lại thủ công, hoặc nhiều webhook cùng trỏ về một URL. SePay khuyên dùng trường id làm khoá duy nhất trong cơ sở dữ liệu. Lần đầu thì ghi và xử lý, các lần sau thấy id đã tồn tại thì chỉ trả về thành công. Tính chất này gọi là idempotent: xử lý một lần hay nhiều lần cho cùng kết quả. Nếu bỏ qua, bạn có thể cộng tiền hai lần hoặc gửi hai mã kích hoạt.
Trước khi lên môi trường thật, hãy thử trong sandbox đủ sáu ca: đúng tiền, thiếu tiền, thừa tiền, sai mã đơn, một giao dịch gửi hai lần và một yêu cầu giả không có chữ ký.
4. Quyền truy cập dữ liệu tài khoản
Khi liên kết, bạn cho SePay đọc lịch sử giao dịch của tài khoản đó, gồm số tiền, nội dung, số dư sau giao dịch. Nếu dùng tài khoản cá nhân, dữ liệu chi tiêu riêng của bạn cũng nằm trong luồng này. Vài cách giảm rủi ro:
- Mở một tài khoản riêng chỉ để nhận tiền bán hàng.
- Chỉ theo dõi tiền vào nếu bạn không cần dữ liệu tiền ra.
- Phân quyền nhân viên trên my.sepay.vn theo đúng việc, bật xác thực hai lớp nếu có, và gỡ liên kết khi ngừng dùng.
- Đọc chính sách riêng tư và thoả thuận sử dụng dịch vụ trên sepay.vn để biết dữ liệu được lưu và chia sẻ thế nào.
5. Cảnh giác lừa đảo và app giả mạo
Chỉ đăng nhập qua địa chỉ my.sepay.vn và tải ứng dụng từ App Store, Google Play. Không đọc mã OTP ngân hàng cho bất kỳ ai gọi điện tự xưng nhân viên hỗ trợ. Với nhân viên bán hàng, quy tắc đơn giản nhất là chỉ giao hàng khi hệ thống báo đã thanh toán, không tin ảnh chụp màn hình chuyển khoản khách gửi.

Câu hỏi thường gặp
SePay có giữ tiền của khách không?
Không, theo mô tả trên trang chính thức. Với luồng chuyển khoản VietQR, tiền khách chuyển về thẳng tài khoản ngân hàng của bạn. SePay chỉ đọc dữ liệu giao dịch và gửi thông báo, webhook về hệ thống của bạn.
SePay có miễn phí không?
Có gói FREE 0đ với 50 giao dịch mỗi tháng theo bảng giá tháng 11/2026, vượt mức thì tính phí phần vượt. Shop có nhiều đơn cần gói trả phí, từ 120.000đ/tháng với gói STARTUP. Giá có thể thay đổi, nên kiểm tra lại trên sepay.vn.
Khách chuyển khoản sai nội dung thì sao?
Khi nội dung không chứa đúng mã thanh toán, trường code trong webhook sẽ là null và đơn không tự khớp. Bạn cần một danh sách giao dịch chờ đối soát để nhân viên kiểm tra theo số tiền, thời gian rồi xác nhận tay. Dùng mã QR điền sẵn nội dung giúp giảm lỗi này đáng kể.
Không biết lập trình có dùng được SePay không?
Được, nếu bạn dùng nền tảng có tích hợp sẵn như WooCommerce, Haravan, Sapo, Shopify, hoặc chỉ cần thông báo biến động số dư qua Telegram, Lark. Khi muốn nối với hệ thống riêng, bạn sẽ cần người hiểu về API và webhook để viết phần nhận dữ liệu.
SePay khác VietQR thế nào?
VietQR là chuẩn mã QR chuyển khoản liên ngân hàng tại Việt Nam, giúp khách quét để điền sẵn số tài khoản, số tiền, nội dung. VietQR không tự báo cho website biết khách đã trả tiền. SePay là dịch vụ đứng sau, theo dõi tài khoản nhận tiền và gửi webhook xác nhận chuyển khoản tự động.