Công ty CP Công nghệ ZoneTech
Chấm điểm miễn phí

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.

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).

Phân biệt mã thử và mã thật khi đăng ký VNPAY

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.

Checklist hồ sơ trước khi đăng ký cổng thanh toán VNPAY
Giấy tờ, điều kiệnDùng đểLưu ý
Giấy chứng nhận đăng ký kinh doanhXác minh người bánHộ kinh doanh hỏi trước có được nhận không
Tài khoản ngân hàng cùng tênNhận tiền đối soátTên tài khoản khớp tên trên giấy đăng ký
Website có tên miền riêng, HTTPSKhai 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ậtBê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.

Sơ đồ 7 bước đăng ký và kết nối cổng thanh toán VNPAY
  1. 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.
  2. Đă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ử.
  3. 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í.
  4. 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ố.
  5. 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.
  6. 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.
  7. 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.

Năm lỗi khiến hồ sơ hoặc kết nối VNPAY bị trả lại

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.

Thành viên TRAVINA GROUP
Zalo