Quy trình và hồ sơ tích hợp cổng thanh toán trực tuyến nội địa cho website bán hàng
Để tích hợp cổng thanh toán trực tuyến nội địa vào website bán hàng, doanh nghiệp hoặc hộ kinh doanh cần hoàn tất hai luồng công việc song song: chuẩn bị hồ sơ thẩm định pháp lý đơn vị chấp nhận thanh toán (KYB) và lập trình kết nối kỹ thuật qua môi trường thử nghiệm (Sandbox). Website bắt buộc phải hiển thị đầy đủ thông tin pháp nhân, chính sách vận chuyển, đổi trả, bảo mật theo Nghị định 248/2026/NĐ-CP và hoạt động ổn định với chứng chỉ SSL trước khi đơn vị trung gian thanh toán cấp khóa kết nối chính thức.
Nhiều chủ doanh nghiệp lầm tưởng việc gắn cổng thanh toán trực tuyến chỉ là thao tác cài đặt một đoạn mã lệnh của lập trình viên. Trên thực tế, rào cản khiến dự án kéo dài hàng tuần thường nằm ở khâu thẩm định điều kiện website và rà soát danh mục ngành hàng kinh doanh từ phía tổ chức cung ứng dịch vụ trung gian thanh toán.
1. Hồ sơ pháp lý đăng ký làm Đơn vị chấp nhận thanh toán (Merchant KYB)
Các tổ chức cung ứng dịch vụ trung gian thanh toán được Ngân hàng Nhà nước cấp phép hoạt động đều phải tuân thủ quy trình nhận biết và thẩm định khách hàng tổ chức (Know Your Business - KYB) chặt chẽ nhằm phòng chống rửa tiền và gian lận thương mại. Do đó, cá nhân không có đăng ký kinh doanh sẽ không thể ký hợp đồng mở cổng thanh toán trực tuyến chính ngạch cho website bán lẻ.
Bộ hồ sơ pháp lý tiêu chuẩn bao gồm Giấy chứng nhận đăng ký doanh nghiệp hoặc Giấy chứng nhận đăng ký hộ kinh doanh do cơ quan chức năng tại phường, xã hoặc tỉnh, thành phố cấp; căn cước công dân hoặc hộ chiếu còn hiệu lực của người đại diện theo pháp luật; cùng thông tin tài khoản thanh toán mở tại ngân hàng thương mại đứng tên đúng pháp nhân đăng ký trên hợp đồng.
Đối với các ngành hàng kinh doanh có điều kiện như thực phẩm chức năng, dược phẩm, mỹ phẩm, thiết bị y tế, dịch vụ du lịch lữ hành hoặc đào tạo trực tuyến, bộ phận thẩm định của cổng thanh toán sẽ yêu cầu bổ sung giấy phép con, giấy xác nhận công bố sản phẩm hoặc hợp đồng phân phối chính hãng để xác minh nguồn gốc hàng hóa hợp pháp.
Ngoài ra, nếu người ký hợp đồng dịch vụ thanh toán không phải là người đại diện theo pháp luật ghi trên giấy phép kinh doanh, doanh nghiệp cần chuẩn bị văn bản ủy quyền hợp lệ kèm giấy tờ tùy thân của người được ủy quyền để tránh việc hồ sơ bị trả về nhiều lần.
- Bản sao công chứng hoặc bản điện tử ký số Giấy chứng nhận đăng ký doanh nghiệp / Hộ kinh doanh có ngành nghề phù hợp với sản phẩm bày bán trên web.
- Tài khoản ngân hàng thụ hưởng tiền đối soát phải trùng khớp hoàn toàn với tên pháp nhân trên giấy phép kinh doanh, không giải ngân vào tài khoản cá nhân.
- Biểu mẫu đăng ký dịch vụ đơn vị chấp nhận thanh toán kê khai rõ quy mô doanh thu dự kiến, giá trị giao dịch trung bình (AOV) và địa chỉ IP máy chủ đặt website.
- Hồ sơ chứng minh quyền sở hữu tên miền hoặc hợp đồng thuê tên miền gắn với website thương mại điện tử đang đề nghị kết nối.
2. Tiêu chuẩn thẩm định giao diện và nội dung website trước khi cấp tài khoản
Sau khi tiếp nhận hồ sơ giấy tờ, chuyên viên kiểm soát rủi ro của cổng thanh toán sẽ trực tiếp truy cập vào tên miền website của doanh nghiệp để kiểm tra thực tế. Rất nhiều website đang ở trạng thái xây dựng dở dang, dùng dữ liệu mẫu (Lorem Ipsum) hoặc thiếu trang chính sách đã bị từ chối phê duyệt ngay ở vòng này.
Để vượt qua vòng thẩm định nhanh chóng, website phải đang hoạt động thật trên tên miền chính thức, trang bị chứng chỉ bảo mật HTTPS (SSL/TLS) hợp lệ và có danh mục sản phẩm thực tế kèm hình ảnh, thông số kỹ thuật, giá bán niêm yết rõ ràng bằng Đồng Việt Nam (VNĐ). Không được để sản phẩm có giá 0 đồng hoặc dòng chữ liên hệ để biết giá đối với các mặt hàng cho phép bỏ vào giỏ hàng thanh toán trực tuyến.
Phần chân trang (Footer) của website bắt buộc phải hiển thị đầy đủ thông tin chủ sở hữu bao gồm tên doanh nghiệp, mã số thuế, địa chỉ trụ sở tại phường, xã, tỉnh, thành phố, số điện thoại cố định hoặc hotline chăm sóc khách hàng và địa chỉ email liên hệ. Đồng thời, hệ thống liên kết tới 5 trang chính sách cốt lõi theo quy định của Nghị định 248/2026/NĐ-CP và Luật Thương mại điện tử 122/2025/QH15 phải truy cập được bình thường.
Đặc biệt, luồng đặt hàng từ trang chi tiết sản phẩm đến giỏ hàng và trang điền thông tin thanh toán (Checkout) phải vận hành trơn tru, không phát sinh lỗi 404 hay lỗi máy chủ 500. Trên trang thanh toán, website cần thể hiện rõ các phương thức thanh toán dự kiến cung cấp để chuyên viên thẩm định hình dung chính xác hành trình của người mua.
| Hạng mục kiểm tra | Yêu cầu bắt buộc trên website | Lỗi thường gặp khiến hồ sơ bị từ chối |
|---|---|---|
| Thông tin pháp nhân ở Footer | Tên công ty, Mã số thuế, địa chỉ trụ sở, Hotline, Email trùng khớp 100% với GPKD | Chỉ ghi tên thương hiệu viết tắt, thiếu mã số thuế hoặc địa chỉ trên web khác với giấy phép |
| Hệ thống trang chính sách | Đủ chính sách thanh toán, vận chuyển, đổi trả - hoàn tiền, bảo hành và bảo mật dữ liệu | Link chính sách bấm vào không có nội dung, sao chép nguyên văn tên website khác chưa sửa |
| Danh mục hàng hóa và giá bán | Tối thiểu 10 - 20 sản phẩm thật có mô tả chi tiết, giá bán niêm yết VNĐ rõ ràng | Sản phẩm dùng ảnh mẫu nước ngoài, giá để 1.000đ thử nghiệm hoặc bán hàng cấm theo quy định |
| Luồng giỏ hàng & Checkout | Thêm vào giỏ, tính tổng tiền (gồm phí ship nếu có) và chọn phương thức thanh toán mượt mà | Nút đặt hàng bị liệt, bắt buộc đăng nhập tài khoản phức tạp nhưng chức năng gửi OTP bị hỏng |
| Hạ tầng bảo mật & Thông báo BCT | Chứng chỉ SSL hoạt động tốt, đã nộp hoặc hoàn tất thủ tục Thông báo với Bộ Công Thương | Trình duyệt cảnh báo kết nối không an toàn, gắn logo đã thông báo BCT giả mạo chưa có link |
3. Quy trình tích hợp kỹ thuật: Từ môi trường Sandbox đến kịch bản kiểm thử SIT/UAT
Song song với quá trình hoàn thiện hợp đồng thương mại, bộ phận kỹ thuật của cổng thanh toán sẽ cấp cho đội ngũ lập trình website bộ tài liệu đặc tả API kèm thông tin tài khoản thử nghiệm (Sandbox Credentials) gồm mã định danh cửa hàng (Merchant ID / Terminal ID) và chuỗi khóa bí mật (Secret Key / Hash Secret).
Trong giai đoạn phát triển trên môi trường Staging/Sandbox, kỹ sư phần mềm cần xây dựng module tạo yêu cầu thanh toán (Create Payment Request) chuẩn hóa các tham số đầu vào như mã tham chiếu giao dịch duy nhất, số tiền thanh toán, nội dung đơn hàng, địa chỉ URL chuyển hướng sau khi khách thanh toán xong (Return URL) và đường dẫn nhận thông báo ngầm máy chủ gọi máy chủ (IPN / Webhook URL).
Mọi gói tin trao đổi giữa website và cổng thanh toán đều phải được ký điện tử bằng thuật toán băm mật mã học (như HMAC-SHA256 hoặcHMAC-SHA512 hoặc chữ ký số RSA) dựa trên khóa bí mật đã cấp. Tuyệt đối không thực hiện việc ghép chuỗi tạo chữ ký ở phía trình duyệt người dùng (Frontend JavaScript) vì kẻ tấn công có thể dịch ngược mã nguồn để lấy cắp khóa và giả mạo giao dịch.
Trước khi xin cấp khóa chính thức (Production Key), đội ngũ kỹ thuật của doanh nghiệp phải chạy toàn bộ danh sách kịch bản kiểm thử nghiệm thu (Test Cases / SIT Checklist) theo yêu cầu của cổng thanh toán và ghi lại bằng chứng nhật ký giao dịch (Transaction Logs). Các kịch bản này bao gồm giao dịch thành công, giao dịch thất bại do thẻ không đủ số dư, khách hàng nhập sai mã OTP, khách hàng chủ động nhấn hủy trên màn hình thanh toán và kiểm tra cơ chế chống xử lý trùng lặp khi IPN gọi lại nhiều lần.
- Tách biệt hoàn toàn cấu hình biến môi trường (Environment Variables) giữa Sandbox và Production, không viết cứng (hardcode) đường dẫn API trong mã nguồn.
- Xử lý đồng bộ giữa Return URL (hiển thị giao diện kết quả cho người mua) và IPN Webhook (cập nhật trạng thái đơn hàng chính thức trong cơ sở dữ liệu).
- Sử dụng danh sách số thẻ ATM nội địa và thẻ quốc tế giả lập do cổng thanh toán cung cấp để kiểm thử đầy đủ các mã lỗi phản hồi (Response Codes).
- Cấu hình tường lửa máy chủ (Firewall / WAF) mở quyền truy cập (Whitelist IP) cho dải địa chỉ IP của máy chủ cổng thanh toán để nhận bản tin Webhook không bị chặn.
4. Nghiệm thu Golive, giao dịch thực nghiệm (Penny Test) và bàn giao vận hành
Khi hợp đồng dịch vụ đã được hai bên ký kết (bằng chữ ký tươi đóng dấu hoặc chữ ký số doanh nghiệp) và biên bản kiểm thử kỹ thuật trên môi trường Sandbox được xác nhận đạt yêu cầu, đơn vị trung gian thanh toán sẽ gửi thông tin kết nối môi trường Production qua kênh bảo mật (thường là file nén có mật khẩu gửi tới email người đại diện hoặc quản trị viên kỹ thuật đã đăng ký).
Ngay sau khi thay thế bộ khóa Production lên hệ thống website chính thức, đội ngũ triển khai cần thực hiện ngay các giao dịch thực nghiệm bằng tiền thật với mệnh giá nhỏ (Penny Test - ví dụ đơn hàng 10.000 VNĐ hoặc 20.000 VNĐ) trên cả phương thức quét mã QR ngân hàng, thẻ ATM nội địa và thẻ thanh toán quốc tế.
Mục tiêu của bước Penny Test không chỉ là kiểm tra xem tiền có trừ thành công hay không, mà quan trọng hơn là xác nhận đơn hàng trên hệ thống quản trị website (OMS) tự động chuyển sang trạng thái Đã thanh toán trong vòng vài giây, biên lai điện tử được gửi tới email khách hàng và dữ liệu giao dịch xuất hiện tức thời trên cổng thông tin đối soát (Merchant Portal) của đơn vị thanh toán.
Bước cuối cùng trong quy trình tích hợp là phân quyền tài khoản trên Merchant Portal cho bộ phận kế toán và chăm sóc khách hàng của doanh nghiệp. Kế toán cần tài khoản có quyền xem báo cáo giao dịch, tải tệp đối soát định kỳ và thực hiện lệnh hoàn tiền (Refund), trong khi nhân viên vận hành đơn hàng chỉ cần quyền tra cứu trạng thái mã giao dịch để hỗ trợ người mua khi cần thiết.
- Thực hiện ít nhất 1 giao dịch thành công và 1 giao dịch hoàn tiền (Refund) trên môi trường Production để kiểm chứng trọn vẹn vòng đời dòng tiền.
- Đổi mật khẩu mặc định và kích hoạt xác thực hai yếu tố (2FA) cho toàn bộ tài khoản quản trị trên cổng Merchant Portal ngay khi nhận bàn giao.
- Thiết lập kênh cảnh báo tự động (qua Email hoặc tin nhắn hệ thống nội bộ) khi tỷ lệ giao dịch lỗi hoặc thời gian phản hồi Webhook vượt ngưỡng bình thường.
- Lưu trữ tài liệu hướng dẫn đối soát và đầu mối liên hệ kỹ thuật trực chiến 24 giờ mỗi ngày của cổng thanh toán để xử lý sự cố phát sinh dịp cao điểm.
Câu hỏi thường gặp
Giải đáp nhanh những điểm thương hiệu bán lẻ D2C, chuỗi cửa hàng đa chi nhánh, doanh nghiệp sản xuất – phân phối B2B và đơn vị xây dựng sàn giao dịch thương mại điện tử hay hỏi về chủ đề này.
Thời gian hoàn tất thủ tục pháp lý và tích hợp kỹ thuật cổng thanh toán nội địa mất bao lâu?
Nếu website đã có sẵn đầy đủ các trang chính sách theo quy định và doanh nghiệp chuẩn bị đủ hồ sơ pháp lý ngay từ đầu, toàn bộ quy trình thẩm định KYB, ký hợp đồng điện tử và kiểm thử kỹ thuật Sandbox thường hoàn tất trong khoảng 5 đến 7 ngày làm việc.
Hộ kinh doanh cá thể có đăng ký được cổng thanh toán trực tuyến cho website không?
Có. Hầu hết các đơn vị trung gian thanh toán nội địa hiện nay đều hỗ trợ ký hợp đồng với Hộ kinh doanh có Giấy chứng nhận đăng ký hộ kinh doanh hợp lệ và tài khoản ngân hàng phục vụ hoạt động kinh doanh theo đúng quy định của Ngân hàng Nhà nước.
Website chưa hoàn tất thủ tục Thông báo Bộ Công Thương có mở được cổng thanh toán không?
Trong giai đoạn ký hợp đồng và chạy thử nghiệm Sandbox, doanh nghiệp có thể tiến hành song song. Tuy nhiên, để được duyệt lên môi trường chính thức (Production) hoặc duy trì cổng thanh toán lâu dài, các tổ chức trung gian thanh toán đều yêu cầu website bán hàng phải hoàn thành nghĩa vụ Thông báo với Bộ Công Thương.
Nhận tư vấn kiến trúc & Báo giá chi tiết hệ thống Website Thương mại điện tử
Hãy cho Uptech biết mô hình bán hàng của bạn (B2C, B2B hay Đa kho/Sàn), số lượng mã sản phẩm (SKU) dự kiến và các phần mềm cổng thanh toán, vận chuyển, ERP/POS cần kết nối. Kỹ sư giải pháp của Uptech sẽ phân tích và gửi bản đề xuất kiến trúc kèm dự toán chi phí minh bạch trong 24 giờ làm việc.
- Phản hồi kèm sơ đồ kiến trúc đề xuất trong vòng 24 giờ làm việc
- Tư vấn miễn phí lộ trình đồng bộ tồn kho ERP/POS và cấu trúc SEO danh mục lớn
- Hợp đồng pháp nhân rõ ràng, bàn giao mã nguồn, xuất hóa đơn GTGT (VAT) đầy đủ