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

Tích hợp NAPAS vào website: hồ sơ và các bước cho shop nhỏ

Tích hợp NAPAS vào website là bật cho khách trả tiền bằng thẻ nội địa, tài khoản ngân hàng hoặc mã VietQR ngay trên trang thanh toán của shop. Shop nhỏ không nối thẳng với NAPAS. Bạn ký với một ngân hàng thanh toán hoặc một tổ chức trung gian, rồi khai báo mã kết nối của bên đó vào web.

Bài này dành cho chủ shop, hộ kinh doanh muốn nhận thẻ ATM của khách trên web. Phần chung về cài cổng nằm ở bài cách tích hợp thanh toán trực tuyến vào website. Bài này chỉ đi sâu phần NAPAS.

Tích hợp NAPAS vào website đi qua ai?

Luôn đi qua một bên đứng giữa. Trang dịch vụ của NAPAS ghi rõ cổng thanh toán NAPAS là dịch vụ cung cấp cho các ngân hàng và tổ chức trung gian thanh toán (NAPAS, đọc ngày 03/11/2026).

Sơ đồ tích hợp NAPAS vào website qua ngân hàng thanh toán hoặc tổ chức trung gian

Ngân hàng thanh toán là ngân hàng ký hợp đồng chấp nhận thanh toán với shop và nhận tiền về tài khoản của shop. Tổ chức trung gian thanh toán là đơn vị được Ngân hàng Nhà nước cấp phép, kết nối website với nhiều phương thức trả tiền. VNPAY, OnePay, Ngân Lượng là ví dụ quen thuộc.

Thẻ 9704 là cách gọi thẻ nội địa mang thương hiệu NAPAS, vì số thẻ bắt đầu bằng 9704. Khi bạn tích hợp NAPAS vào website qua một bên trung gian, giao dịch thẻ 9704 vẫn chạy trên hạ tầng NAPAS. Vai trò của NAPAS có trong bài cổng thanh toán NAPAS.

Chọn đường kết nối phù hợp

Có ba đường. Chọn theo nền tảng web và cách khách của bạn đang trả tiền.

So sánh 3 đường kết nối khi tích hợp NAPAS vào website
Đường kết nốiAi ký với shopViệc kỹ thuậtHợp với
Cổng trung gian có sẵn pluginTổ chức trung gian thanh toánBật cổng có sẵn hoặc cài plugin, dán mãShop muốn nhận thẻ 9704 và cả thẻ quốc tế
Ngân hàng thanh toánNgân hàng nơi shop mở tài khoảnThường phải lập trình theo tài liệu của ngân hàngDoanh nghiệp đã có quan hệ lâu với một ngân hàng
Chỉ VietQRKhông cần hợp đồng cổngHiện mã QR có số tiền, thêm dịch vụ báo cóShop mới, khách chủ yếu chuyển khoản

Với shop nhỏ, đường thứ nhất ít công nhất. Cổng không có sẵn trên nền tảng thì tích hợp NAPAS vào website sẽ cần lập trình.

Hồ sơ trước khi tích hợp NAPAS vào website

Hồ sơ do bên ký hợp đồng quy định, không phải NAPAS.

Checklist hồ sơ trước khi tích hợp NAPAS vào website

Nên tra tên bên trung gian trong danh sách tổ chức được cấp phép trên cổng thông tin Ngân hàng Nhà nước. Web bán hàng cũng nên làm xong nghĩa vụ theo Nghị định 248/2026/NĐ-CP trước khi nộp hồ sơ.

6 bước tích hợp NAPAS vào website

Các bước dưới đây chỉ là thứ tự công việc. Mẫu hồ sơ cụ thể theo bên bạn ký.

Sáu bước tích hợp NAPAS vào website từ hỏi nền tảng đến đối soát
  1. Hỏi nền tảng. Ghi lại các cổng đã có bộ kết nối sẵn trên Haravan, Sapo hoặc plugin chính hãng cho WordPress.
  2. Chọn bên ký và hỏi phương thức. Hỏi bên đó có bật thẻ 9704, tài khoản và VietQR không, phí từng loại.
  3. Nộp hồ sơ, ký hợp đồng. Kiểm hợp đồng ghi kỳ chuyển tiền và đầu mối xử lý sự cố.
  4. Nhận mã thử và khai báo. Dán mã website, chuỗi bí mật vào cài đặt thanh toán. Khai báo địa chỉ nhận kết quả theo tài liệu của bên ký.
  5. Chạy thử từng phương thức. Thử riêng thẻ 9704, tài khoản và VietQR theo bảng ở mục sau.
  6. Lên môi trường thật. Thay mã thử bằng mã thật, làm 2-3 đơn nhỏ, đối soát khớp rồi mới mở cho khách.

Bước 3 thường lâu nhất vì phải chờ duyệt hồ sơ.

Chạy thử riêng từng phương thức NAPAS

Mỗi phương thức hỏng ở một chỗ khác nhau. Bảng dưới là cách thử nên có, không phải quy định của cổng nào.

Bảng chạy thử thẻ 9704, tài khoản và VietQR trước khi mở cho khách
Phương thứcThử gìĐạt khi
Thẻ 9704Trả bằng thẻ thử, nhập OTP, thử cả OTP saiĐơn chỉ chuyển “đã thanh toán” khi OTP đúng
Tài khoản ngân hàngChọn ngân hàng, xác thực trên app, đóng app giữa chừngĐơn không kẹt khi khách không quay lại web
VietQRQuét mã, để quá hạn, chuyển sai số tiềnMã có đúng số tiền và mã đơn, chuyển sai thì không tự xác nhận

Kết quả giao dịch phải về web qua địa chỉ máy chủ gọi máy chủ, không dựa vào trang khách quay về. Khi gặp mã lỗi lạ, đối chiếu bài lỗi thường gặp khi cổng thanh toán.

Ví dụ: một shop trà tích hợp NAPAS vào website

Ví dụ giả định. Một shop trà dùng WordPress, khách hay hỏi trả bằng thẻ ATM. Shop chọn cổng trung gian có plugin chính hãng, chỉ bật thẻ 9704 và VietQR. Thử đủ bảng trên xong, shop làm hai đơn thật rồi đối soát sáng hôm sau. Bài học: tích hợp NAPAS vào website nên bật ít phương thức trước, chạy ổn rồi mới thêm.

Cùng nhóm: cách đăng ký cổng thanh toán VNPAY và cổng thanh toán cho cá nhân.

Câu hỏi thường gặp

Tích hợp NAPAS vào website có ký trực tiếp với NAPAS được không?

Với shop nhỏ, thường là không. NAPAS cung cấp cổng cho ngân hàng và tổ chức trung gian. Shop ký với một trong hai bên này.

Hộ kinh doanh có tích hợp NAPAS vào website được không?

Có thể, nếu bên ký nhận giấy chứng nhận đăng ký hộ kinh doanh. Điều kiện do từng ngân hàng, từng cổng quy định. Nên hỏi trước khi chuẩn bị hồ sơ.

Mất bao lâu để tích hợp NAPAS vào website?

Phần kỹ thuật trên Haravan, Sapo có thể xong trong vài giờ. Thời gian duyệt hồ sơ tùy bên ký.

ZoneWeb: website bán hàng trên tên miền của bạn

ZoneTech làm website bán hàng trên Haravan, Sapo hoặc WordPress qua dịch vụ thiết kế website ZoneWeb. Khi làm web, ZoneTech có thể cùng khai báo mã cổng và chạy thử thẻ 9704, VietQR. Tài khoản cổng đứng tên shop. Xem thêm về đội ngũ ở trang giới thiệu ZoneTech, hoặc gửi yêu cầu ở trang liên hệ. Giá từng gói có ở bảng giá.

Cập nhật lần cuối: 03/11/2026 · Biên soạn: Đỗ Hữu Thuận

Thành viên TRAVINA GROUP
Zalo