Cách đăng ký cổng thanh toán VNPAY cho website bán hàng
Cách đăng ký cổng thanh toán VNPAY gồm hai việc tách rời. Một là đăng ký tài khoản thử để làm phần kỹ thuật. Hai là nộp hồ sơ, ký hợp đồng chính thức để nhận mã thật và nhận tiền về tài khoản. Hai việc nên chạy song song để không mất thời gian chờ.
Bài này dành cho chủ shop, hộ kinh doanh cần cách đăng ký cổng thanh toán VNPAY cho web Haravan, Sapo hoặc WordPress.
Mục lục
Cách đăng ký cổng thanh toán VNPAY gồm những gì?
Gồm một tài khoản thử và một hợp đồng thật. Tài liệu kỹ thuật của VNPAY ghi rõ: sau khi đăng ký môi trường thử, hệ thống gửi thông tin kết nối về email đã đăng ký (VNPAY Sandbox, đọc ngày 03/11/2026).

Sandbox là môi trường thử, nơi giao dịch không trừ tiền thật. TmnCode là mã website VNPAY cấp để nhận diện web hoặc ứng dụng của shop. HashSecret là chuỗi bí mật dùng để tạo và kiểm mã chống sửa dữ liệu. Mã thử và mã thật là hai bộ khác nhau.
Trong cách đăng ký cổng thanh toán VNPAY, tài liệu sandbox chỉ nói phần thử. Phần hồ sơ, hợp đồng và phí bạn làm việc trực tiếp với VNPAY hoặc ngân hàng đối tác. Theo trang liên hệ của VNPAY, tổng đài là 1900 55 55 77, email [email protected] (đọc ngày 03/11/2026).
Hồ sơ chuẩn bị trước khi đăng ký
Hồ sơ là phần chậm nhất của cách đăng ký cổng thanh toán VNPAY. Danh sách dưới đây khớp với phần chuẩn bị trong bài cách tích hợp thanh toán trực tuyến vào website. Mẫu cụ thể do VNPAY hoặc ngân hàng quy định.

| Giấy tờ, điều kiện | Dùng để | Lưu ý |
|---|---|---|
| Giấy chứng nhận đăng ký kinh doanh | Xác minh người bán | Hộ kinh doanh hỏi trước có được nhận không |
| Tài khoản ngân hàng cùng tên | Nhận tiền đối soát | Tên tài khoản khớp tên trên giấy đăng ký |
| Website có tên miền riêng, HTTPS | Khai báo địa chỉ nhận kết quả | VNPAY yêu cầu IPN URL có SSL |
| Trang chính sách thanh toán, đổi trả, bảo mật | Bên duyệt xem web | Đăng ở chân trang, mở được không cần đăng nhập |
Có thể tra tên đơn vị trong danh sách tổ chức trung gian thanh toán trên cổng thông tin Ngân hàng Nhà nước. Web có chức năng đặt hàng còn có nghĩa vụ riêng theo Nghị định 248/2026/NĐ-CP. Nên làm xong phần này trước khi nộp hồ sơ.
7 bước trong cách đăng ký cổng thanh toán VNPAY
Các bước dưới đây chỉ nêu thứ tự công việc. Mẫu đơn và thời gian duyệt hỏi bên cung cấp.

- Kiểm nền tảng. Xem VNPAY có trong danh sách cổng có sẵn của Haravan, Sapo, hoặc có plugin chính hãng cho WordPress không.
- Đăng ký tài khoản thử. Điền form sandbox, chờ email gửi TmnCode và HashSecret của môi trường thử.
- Liên hệ để ký chính thức. Gọi tổng đài hoặc hỏi ngân hàng nơi mở tài khoản. Nhận danh sách hồ sơ và biểu phí.
- Nộp hồ sơ, ký hợp đồng. Đọc kỹ phí từng loại thẻ, kỳ chuyển tiền và đầu mối xử lý sự cố.
- Cấu hình và chạy thử. Dán mã thử, khai báo Return URL và IPN URL, thử các tình huống thành công, hủy, hết hạn.
- Thay mã thật. Khi hợp đồng có hiệu lực, thay bộ mã thử bằng bộ mã thật, giữ nguyên cấu hình IPN.
- Làm đơn thật nhỏ và đối soát. Đặt 2-3 đơn, kiểm đơn đổi trạng thái và tiền về khớp sau khi trừ phí.
Bước 2 và bước 3 làm cùng lúc. Phần kỹ thuật xong trong lúc chờ duyệt hồ sơ.
Lỗi khiến hồ sơ hoặc kết nối bị trả lại
Năm lỗi dưới đây hay gặp khi làm theo cách đăng ký cổng thanh toán VNPAY.

- Tên tài khoản ngân hàng khác tên trên giấy đăng ký kinh doanh.
- Web chưa có trang chính sách, hoặc trang chính sách để chế độ riêng tư.
- IPN URL chạy HTTP. Tài liệu VNPAY ghi IPN URL cần có SSL.
- Quên nhân số tiền với 100 trước khi gửi. Đơn 10.000 đồng phải gửi là 1000000.
- Dán HashSecret của môi trường thử vào môi trường thật, mọi giao dịch báo sai chữ ký.
Nếu IPN không trả lời đúng, VNPAY gọi lại tối đa 10 lần, cách nhau 5 phút. Phần xử lý phải bỏ qua đơn đã xác nhận. Mã lỗi khác có trong bài lỗi thường gặp khi cổng thanh toán.
Ví dụ: hộ kinh doanh đi theo 7 bước
Ví dụ giả định. Một hộ kinh doanh bán gốm dùng WordPress, muốn khách trả bằng thẻ ATM. Chủ hộ gọi hỏi trước và được xác nhận có nhận giấy đăng ký hộ kinh doanh.
Cùng ngày, người làm web đăng ký sandbox và thử đủ các tình huống. Khi có mã thật, chỉ còn thay mã và làm hai đơn nhỏ. Chạy song song giúp cách đăng ký cổng thanh toán VNPAY không bị kéo dài.
Cùng nhóm: cổng thanh toán cho cá nhân, cổng thanh toán VietQR và tích hợp Napas vào website.
Câu hỏi thường gặp
Cách đăng ký cổng thanh toán VNPAY có tốn phí mở không?
Phí do hợp đồng quy định, gồm phí giao dịch theo từng loại thẻ. Hỏi rõ có phí cài đặt, phí duy trì hay không trước khi ký. Cách so phí giữa các cổng có trong bài cổng thanh toán cho website bán hàng.
Chưa có website có làm theo cách đăng ký cổng thanh toán VNPAY được không?
Tài khoản thử thì cần địa chỉ web để khai báo. Hợp đồng thật thường cần web đã chạy, có trang chính sách. Nên làm web xong trước.
Cá nhân chưa đăng ký kinh doanh có làm được không?
Hồ sơ chính thức yêu cầu giấy đăng ký kinh doanh như bảng trên. Người chưa đăng ký nên hỏi trực tiếp VNPAY, hoặc cân nhắc nhận chuyển khoản QR trước.
Đổi từ mã thử sang mã thật có phải làm lại web không?
Không. Bạn chỉ thay TmnCode, HashSecret và địa chỉ cổng thật.
Cần người làm cùng? Xem ZoneWeb – website bán hàng.