Cổng thanh toán SePay là gì?
Cổng thanh toán SePay là nền tảng xử lý thanh toán trực tuyến hàng đầu Việt Nam, cho phép doanh nghiệp và lập trình viên tích hợp đa dạng phương thức thanh toán vào website hoặc ứng dụng chỉ trong một lần duy nhất — không cần kết nối riêng lẻ với từng ngân hàng hay tổ chức thẻ.
SePay đóng vai trò trung gian giữa website/ứng dụng của bạn với hệ thống ngân hàng, mạng thẻ quốc tế và cổng NAPAS, xử lý toàn bộ luồng thanh toán từ khởi tạo đơn hàng đến xác nhận giao dịch.
- QR chuyển khoản ngân hàng (VietQR): kích hoạt online trong ~30 phút, nhận thanh toán ngay sau khi hoàn tất cài đặt.
- Cổng NAPAS (VietQRPay) & thẻ tín dụng/ghi nợ quốc tế: thời gian approve 3–5 ngày đến 2 tuần tùy hồ sơ merchant — liên hệ đội ngũ sale để biết chi tiết.
Trong thời gian chờ production được approve, bạn có thể đăng ký và thử ngay trên môi trường Sandbox để hoàn thiện tích hợp. Đăng ký tại my.sepay.vn.
Phương thức thanh toán được hỗ trợ
Cổng thanh toán SePay hỗ trợ ba nhóm phương thức thanh toán chính:
Khách hàng quét mã QR VietQR bằng ứng dụng ngân hàng để chuyển tiền trực tiếp vào tài khoản của bạn. Tiền về tài khoản ngân hàng mà không qua bất kỳ ví trung gian nào. Hỗ trợ tài khoản cá nhân và doanh nghiệp, xác nhận giao dịch tự động theo thời gian thực, phí cố định theo giao dịch.
Cổng thanh toán QR theo chuẩn NAPAS, SePay là đối tác ủy quyền chính thức của NAPAS. Sử dụng công nghệ VietQRPay và VietQRGlobal. Tiền về ngân hàng theo thời gian thực, dòng tiền nguyên vẹn, dễ đối soát.
Chấp nhận thanh toán bằng thẻ Visa, Mastercard và JCB. Sản phẩm hợp tác giữa SePay, VPBank và MPGS của Mastercard. Hỗ trợ thẻ tín dụng và thẻ ghi nợ quốc tế, bảo mật theo chuẩn 3D Secure.
Tính năng chính
Cổng thanh toán SePay được xây dựng để giải quyết các bài toán thanh toán phổ biến của doanh nghiệp Việt Nam:
Tích hợp một lần duy nhất qua API hoặc SDK để tiếp nhận thanh toán từ nhiều phương thức khác nhau. Không cần ký hợp đồng riêng với từng ngân hàng.
Khi có giao dịch thành công, SePay tự động gửi thông báo đến endpoint IPN của bạn theo thời gian thực, giúp hệ thống tự động xác nhận đơn hàng mà không cần người dùng thao tác thêm.
Tùy chỉnh URL để điều hướng khách hàng sau khi thanh toán thành công, thất bại hoặc hủy bỏ — phù hợp với luồng UX của từng hệ thống.
SePay cung cấp webhook thông báo biến động số dư, cho phép các developer tự xây dựng cổng thanh toán tùy chỉnh cho website của mình mà không phụ thuộc vào form checkout mặc định.
Toàn bộ tính năng đều có thể kiểm thử trên môi trường Sandbox trước khi đưa vào production, đảm bảo tích hợp chính xác mà không ảnh hưởng đến giao dịch thật.
Đăng ký và kích hoạt cổng thanh toán hoàn toàn online, không cần giấy tờ phức tạp. Với VietQR, bạn có thể bắt đầu nhận tiền chỉ sau khoảng 30 phút.
Thanh toán thẻ tuân thủ chuẩn 3D Secure (3DS) và PCI DSS thông qua đối tác MPGS của Mastercard. Mọi giao dịch đều được mã hoá và xác thực trước khi xử lý.
SePay là đối tác ủy quyền của NAPAS, đảm bảo tuân thủ chuẩn kỹ thuật và pháp lý của hệ thống thanh toán quốc gia.
Đối tượng sử dụng
Cổng thanh toán SePay phục vụ nhiều nhu cầu tích hợp khác nhau — từ developer tự build bằng API đến người dùng không code:
Developer tự tích hợp trực tiếp qua RESTful API của SePay. Full control về UX checkout, phù hợp với hệ thống custom, mobile app hoặc kiến trúc SaaS multi-tenant.
SePay cung cấp SDK chính thức cho PHP và Node.js, giúp rút ngắn thời gian tích hợp. Phù hợp với backend team muốn một lib sẵn sàng thay vì tự implement signature, retry, error handling.
Cửa hàng TMĐT chạy trên WordPress/WooCommerce, Haravan có thể cài plugin chính thức và cấu hình merchant_id/secret_key — không cần viết code.
Cá nhân, shop nhỏ hoặc freelancer không muốn code có thể tạo QR payment link trực tiếp tại my.sepay.vn và gửi link cho khách hàng để nhận thanh toán.
Nếu bạn là cá nhân hoặc doanh nghiệp nhỏ, hãy bắt đầu với QR chuyển khoản ngân hàng (VietQR) — kích hoạt nhanh nhất, phí thấp nhất. Thanh toán thẻ quốc tế và cổng NAPAS phù hợp hơn cho doanh nghiệp có nhu cầu lớn hoặc phục vụ khách hàng quốc tế.
Luồng thanh toán
Ở cấp độ business, một giao dịch qua SePay trải qua 5 bước chính — từ khi khách hàng bấm "Thanh toán" cho đến khi merchant ghi nhận đơn hàng thành công:
-
Khách hàng chọn thanh toán — Trên website/app của merchant, khách hàng chọn sản phẩm và bấm nút thanh toán.
-
Merchant tạo đơn hàng — Hệ thống của merchant khởi tạo đơn hàng trên SePay với số tiền, mô tả và URL callback; nhận lại link thanh toán hoặc mã QR.
-
Khách hàng thực hiện thanh toán — Khách hàng chọn phương thức (QR VietQR, QR NAPAS, hoặc thẻ quốc tế) và hoàn tất giao dịch.
-
Ngân hàng / NAPAS xác nhận — Giao dịch được xử lý và xác nhận bởi ngân hàng phát hành hoặc cổng NAPAS.
-
Merchant cập nhật đơn hàng qua IPN — SePay gửi IPN webhook đến endpoint của merchant để cập nhật trạng thái đơn hàng tự động. Khách hàng được redirect về
return_urlđể xem kết quả.
Tài liệu này mô tả luồng ở cấp độ business. Để xem sequence diagram các API call cụ thể (endpoint, payload, chữ ký, flow checkout/init), vui lòng xem Tạo đơn hàng — Tạo form thanh toán.
Không nên chỉ dựa vào return_url để xác nhận đơn hàng vì khách hàng có thể đóng trình duyệt trước khi được chuyển hướng. Luôn dùng IPN Webhook để cập nhật trạng thái đơn hàng phía server.
Môi trường
| Môi trường | Base URL |
|---|---|
| Production | https://pgapi.sepay.vn |
| Sandbox | https://pgapi-sandbox.sepay.vn |
Xác thực bằng Basic Auth: Authorization: Basic base64(merchant_id:secret_key)
Nếu bạn mới bắt đầu, hãy sử dụng môi trường Sandbox để thử nghiệm trước khi chuyển sang Production. Đăng ký tài khoản tại my.sepay.vn để nhận thông tin Sandbox ngay.
Bước tiếp theo
Sau khi đã hiểu về Cổng thanh toán SePay:
- Bắt đầu tích hợp — Hướng dẫn từng bước để tích hợp cổng thanh toán vào website hoặc ứng dụng của bạn
- Xác thực API — Tìm hiểu cách xác thực với API SePay và các base URL cho Sandbox và Production
Hãy bắt đầu bằng môi trường Sandbox để kiểm thử tích hợp mà không ảnh hưởng đến giao dịch thật. Đăng ký tài khoản tại my.sepay.vn để nhận thông tin Sandbox ngay.